@surf-ai/sdk 0.1.0

package/dist/react/index.d.ts

@@ -0,0 +1,3382 @@
+import { ClassValue } from 'clsx';
+import * as React from 'react';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import * as _tanstack_query_core from '@tanstack/query-core';
+
+declare function cn(...inputs: ClassValue[]): string;
+
+type ToasterToast = {
+    id: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    action?: React.ReactNode;
+    variant?: "default" | "destructive";
+};
+declare function toast(props: Omit<ToasterToast, "id">): {
+    id: string;
+    dismiss: () => void;
+    update: (p: Partial<ToasterToast>) => void;
+};
+declare function useToast(): {
+    toast: typeof toast;
+    dismiss: (toastId?: string) => void;
+    toasts: ToasterToast[];
+};
+
+interface ResponseMeta {
+    cached?: boolean;
+    credits_used?: number;
+    total?: number;
+    limit?: number;
+    offset?: number;
+}
+interface CursorMeta {
+    cached?: boolean;
+    credits_used?: number;
+    has_more?: boolean;
+    next_cursor?: string;
+    limit?: number;
+}
+interface ApiResponse<T> {
+    data: T[];
+    meta?: ResponseMeta;
+}
+interface ApiObjectResponse<T> {
+    data: T;
+    meta?: ResponseMeta;
+}
+interface ApiCursorResponse<T> {
+    data: T[];
+    meta?: CursorMeta;
+}
+interface ExchangeDepthItem {
+    /** Total ask-side depth in base currency units */
+    ask_depth: unknown;
+    asks: ExchangeDepthItemAsksItem[];
+    /** Total bid-side depth in base currency units */
+    bid_depth: unknown;
+    bids: ExchangeDepthItemBidsItem[];
+    /** Exchange identifier */
+    exchange: string;
+    /** (best_bid + best_ask) / 2 */
+    mid_price: unknown;
+    /** Trading pair like BTC/USDT */
+    pair: string;
+    /** Best ask - best bid */
+    spread: unknown;
+    /** Spread as percent of mid price */
+    spread_pct: unknown;
+}
+interface ExchangeDepthItemAsksItem {
+    /** Amount at this level */
+    amount: number;
+    /** Price level */
+    price: number;
+}
+interface ExchangeDepthItemBidsItem {
+    /** Amount at this level */
+    amount: number;
+    /** Price level */
+    price: number;
+}
+interface ExchangeDepthParams {
+    /** Trading pair (e.g. BTC/USDT) */
+    pair?: string;
+    /** Market type: spot for spot trading, swap for perpetual contracts — @default 'spot' */
+    type?: 'spot' | 'swap';
+    /** Number of price levels (1-100) — @default '20' */
+    limit?: number;
+    /** Exchange identifier — @default 'binance' */
+    exchange?: 'binance' | 'okx' | 'bybit' | 'bitget' | 'coinbase' | 'kraken' | 'gate' | 'mexc' | 'upbit' | 'bitstamp' | 'deribit' | 'bitmex' | 'bithumb';
+}
+interface ExchangeFundingHistoryItem {
+    /** Exchange identifier */
+    exchange: string;
+    /** Funding rate at this settlement */
+    funding_rate: unknown;
+    /** Perpetual contract pair like BTC/USDT */
+    pair: string;
+    /** Unix timestamp in seconds */
+    timestamp: unknown;
+}
+interface ExchangeFundingHistoryParams {
+    /** Trading pair (e.g. BTC/USDT) */
+    pair?: string;
+    /** Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD, ISO8601). Not all exchanges support historical queries; some only return recent data regardless of this value. */
+    from?: string;
+    /** Max number of records. For longer history, paginate using the last returned timestamp as the next from value. — @default '100' */
+    limit?: number;
+    /** Exchange identifier — @default 'binance' */
+    exchange?: 'binance' | 'okx' | 'bybit' | 'bitget' | 'gate' | 'htx' | 'mexc' | 'bitfinex' | 'bitmex';
+}
+interface ExchangeKlinesItem {
+    candles: ExchangeKlinesItemCandlesItem[];
+    /** Number of candles */
+    count: number;
+    /** Exchange identifier */
+    exchange: string;
+    /** Candle interval */
+    interval: string;
+    /** Trading pair */
+    pair: string;
+    /** Last candle datetime */
+    period_end: unknown;
+    /** Highest price in period */
+    period_high: unknown;
+    /** Lowest price in period */
+    period_low: unknown;
+    /** First candle datetime */
+    period_start: unknown;
+    /** Total volume in period */
+    period_volume: unknown;
+}
+interface ExchangeKlinesItemCandlesItem {
+    /** Closing price */
+    close: number;
+    /** Highest price during the interval */
+    high: number;
+    /** Lowest price during the interval */
+    low: number;
+    /** Opening price */
+    open: number;
+    /** Candle open time in Unix seconds */
+    timestamp: unknown;
+    /** Trading volume in base currency units */
+    volume: number;
+}
+interface ExchangeKlinesParams {
+    /** Trading pair (e.g. BTC/USDT) */
+    pair?: string;
+    /** Market type: spot for spot trading, swap for perpetual contracts — @default 'spot' */
+    type?: 'spot' | 'swap';
+    /** Candle interval — @default '1h' */
+    interval?: '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '6h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M';
+    /** Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD, ISO8601) */
+    from?: string;
+    /** Max number of candles to return. Exchange may cap lower (e.g. 200-1000). For longer ranges, paginate using the last returned timestamp as the next from value. — @default '100' */
+    limit?: number;
+    /** Exchange identifier — @default 'binance' */
+    exchange?: 'binance' | 'okx' | 'bybit' | 'bitget' | 'coinbase' | 'kraken' | 'gate' | 'htx' | 'kucoin' | 'mexc' | 'upbit' | 'bitfinex' | 'bitstamp' | 'deribit' | 'bitmex' | 'bithumb';
+}
+interface ExchangeLongShortRatioItem {
+    /** Exchange identifier */
+    exchange: string;
+    /** Ratio of longs to shorts (e.g. 1.5 means 60% long / 40% short). To get percentages: long% = ratio/(ratio+1)*100, short% = 100/(ratio+1) */
+    long_short_ratio: unknown;
+    /** Perpetual contract pair like BTC/USDT */
+    pair: string;
+    /** Unix timestamp in seconds */
+    timestamp: unknown;
+}
+interface ExchangeLongShortRatioParams {
+    /** Trading pair (e.g. BTC/USDT) */
+    pair?: string;
+    /** Data interval — @default '1h' */
+    interval?: '1h' | '4h' | '1d';
+    /** Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD, ISO8601). Not all exchanges support historical queries; some only return recent data regardless of this value. */
+    from?: string;
+    /** Max number of records. For longer history, paginate using the last returned timestamp as the next from value. — @default '50' */
+    limit?: number;
+    /** Exchange identifier — @default 'binance' */
+    exchange?: 'binance' | 'okx' | 'bybit' | 'bitget';
+}
+interface ExchangeMarketsItem {
+    /** Whether the market is active */
+    active: unknown;
+    /** Base currency */
+    base: unknown;
+    /** Exchange identifier */
+    exchange: string;
+    /** Default maker fee rate */
+    maker_fee: unknown;
+    /** Trading pair like BTC/USDT */
+    pair: string;
+    /** Quote currency */
+    quote: unknown;
+    /** Default taker fee rate */
+    taker_fee: unknown;
+    /** Market type: spot, swap, future, option */
+    type: unknown;
+}
+interface ExchangeMarketsParams {
+    /** Exchange identifier. When omitted, searches across all supported exchanges. */
+    exchange?: 'binance' | 'okx' | 'bybit' | 'bitget' | 'coinbase' | 'kraken' | 'gate' | 'htx' | 'kucoin' | 'mexc' | 'upbit' | 'bitfinex' | 'bitstamp' | 'deribit' | 'bitmex' | 'bithumb';
+    /** Filter: spot, swap, future, option */
+    type?: 'spot' | 'swap' | 'future' | 'option';
+    /** Filter by base currency */
+    base?: string;
+    /** Filter by quote currency */
+    quote?: string;
+    /** Fuzzy search in pair/base/quote */
+    search?: string;
+    /** Max results — @default '100' */
+    limit?: number;
+}
+interface ExchangePerpData {
+    /** Exchange identifier */
+    exchange: string;
+    funding: ExchangePerpDataFunding;
+    open_interest: ExchangePerpDataOpenInterest;
+    /** Perpetual contract pair like BTC/USDT */
+    pair: string;
+}
+interface ExchangePerpDataFunding {
+    /** Exchange identifier */
+    exchange: string;
+    /** Current funding rate (0.0001 = 0.01%) */
+    funding_rate: unknown;
+    /** Index price derived from the weighted average of spot prices across multiple exchanges */
+    index_price: unknown;
+    /** Funding interval like 8h */
+    interval: unknown;
+    /** Mark price calculated by the exchange from the index price and funding rate, used as the reference for liquidations */
+    mark_price: unknown;
+    /** Next settlement time ISO8601 */
+    next_funding: unknown;
+    /** Perpetual contract pair like BTC/USDT */
+    pair: string;
+}
+interface ExchangePerpDataOpenInterest {
+    /** Exchange identifier */
+    exchange: string;
+    /** Open interest in contracts */
+    open_interest_amount: unknown;
+    /** Open interest in USD */
+    open_interest_usd: unknown;
+    /** Trading pair like BTC/USDT */
+    pair: string;
+    /** Unix timestamp in seconds */
+    timestamp: unknown;
+}
+interface ExchangePerpParams {
+    /** Trading pair (e.g. BTC/USDT). The swap suffix ':USDT' is added automatically. */
+    pair?: string;
+    /** Comma-separated fields to include: 'funding' (current funding rate), 'oi' (open interest). Defaults to all fields. — @default 'funding' */
+    fields?: string;
+    /** Exchange identifier — @default 'binance' */
+    exchange?: 'binance' | 'okx' | 'bybit' | 'bitget' | 'htx' | 'bitfinex' | 'bitmex';
+}
+interface ExchangePriceItem {
+    /** Best ask price */
+    ask: unknown;
+    /** Best bid price */
+    bid: unknown;
+    /** Price change percentage in 24h */
+    change_24h_pct: unknown;
+    /** Exchange identifier like binance, okx */
+    exchange: string;
+    /** 24h high price */
+    high_24h: unknown;
+    /** Last traded price */
+    last: unknown;
+    /** 24h low price */
+    low_24h: unknown;
+    /** Trading pair like BTC/USDT */
+    pair: string;
+    /** Unix timestamp in seconds */
+    timestamp: unknown;
+    /** 24h trading volume in base currency units */
+    volume_24h_base: unknown;
+}
+interface ExchangePriceParams {
+    /** Trading pair (e.g. BTC/USDT) */
+    pair?: string;
+    /** Market type: spot for spot trading, swap for perpetual contracts — @default 'spot' */
+    type?: 'spot' | 'swap';
+    /** Exchange identifier — @default 'binance' */
+    exchange?: 'binance' | 'okx' | 'bybit' | 'bitget' | 'coinbase' | 'kraken' | 'gate' | 'htx' | 'kucoin' | 'mexc' | 'upbit' | 'bitfinex' | 'bitstamp' | 'deribit' | 'bitmex' | 'bithumb';
+}
+interface FundDetailData {
+    /** Fund description */
+    description?: string;
+    /** Surf fund UUID — pass as 'id' parameter to /fund/detail or /fund/portfolio for exact lookup */
+    id: string;
+    /** Fund logo URL */
+    image?: string;
+    /** Total number of unique invested projects (a project with multiple funding rounds counts once) */
+    invested_projects_count: number;
+    /** Fund jurisdiction */
+    jurisdiction?: string;
+    links: FundDetailDataLinksItem[];
+    members: FundDetailDataMembersItem[];
+    /** Fund name */
+    name: string;
+    recent_researches: FundDetailDataRecentResearchesItem[];
+    /** Fund tier ranking (lower is better) */
+    tier: number;
+    /** Fund type like `VC` or `Accelerator` */
+    type?: string;
+    x_accounts: FundDetailDataXAccountsItem[];
+}
+interface FundDetailDataLinksItem {
+    /** Link type like `web`, `twitter`, or `linkedin` */
+    type: string;
+    /** Link URL */
+    value: string;
+}
+interface FundDetailDataMembersItem {
+    /** Avatar URL */
+    avatar?: string;
+    /** Member name */
+    name: string;
+    roles: unknown;
+}
+interface FundDetailDataRecentResearchesItem {
+    /** Research ID */
+    id: string;
+    /** Publication date (Unix seconds) */
+    published_at: number;
+    /** Research title */
+    title: string;
+    /** Research URL */
+    url: string;
+}
+interface FundDetailDataXAccountsItem {
+    /** Display name */
+    display_name?: string;
+    /** Follower count */
+    followers_count: number;
+    /** X (Twitter) handle without the @ prefix */
+    handle: string;
+    /** Numeric X (Twitter) user ID */
+    id: string;
+    /** Profile image URL */
+    profile_image?: string;
+}
+interface FundDetailParams {
+    /** Surf fund UUID. PREFERRED — always use this when available from a previous response (e.g. id from /search/fund). Takes priority over q. */
+    id?: string;
+    /** Fuzzy fund name search. Only use when 'id' is not available. May return unexpected results for ambiguous names. */
+    q?: string;
+}
+interface FundPortfolioItem {
+    /** Investment date (Unix seconds) */
+    invested_at?: number;
+    /** Whether this fund was the lead investor */
+    is_lead: boolean;
+    /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics for exact lookup. Prefer over 'q' (fuzzy name search). */
+    project_id: string;
+    /** Project logo URL */
+    project_logo?: string;
+    /** Project name */
+    project_name: string;
+    /** Project slug */
+    project_slug?: string;
+    /** Most recent funding round amount in USD */
+    recent_raise?: number;
+    /** Total amount raised by the project in USD */
+    total_raise?: number;
+}
+interface FundPortfolioParams {
+    /** Surf fund UUID. PREFERRED — always use this when available from a previous response (e.g. id from /search/fund). Takes priority over q. */
+    id?: string;
+    /** Fuzzy fund name search. Only use when 'id' is not available. May return unexpected results for ambiguous names. */
+    q?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+    /** Filter by lead investor status. Omit or leave empty for all investments. */
+    is_lead?: 'true' | 'false' | '';
+    /** Only include investments at or after this Unix timestamp (seconds) */
+    invested_after?: number;
+    /** Only include investments before this Unix timestamp (seconds) */
+    invested_before?: number;
+    /** Field to sort results by — @default 'invested_at' */
+    sort_by?: 'invested_at' | 'recent_raise' | 'total_raise';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+}
+interface FundRankingItem {
+    /** Surf fund UUID — pass as 'id' parameter to /fund/detail or /fund/portfolio for exact lookup */
+    id: string;
+    /** Fund logo URL */
+    image?: string;
+    /** Total number of unique invested projects (a project with multiple funding rounds counts once) */
+    invested_projects_count: number;
+    /** Fund name */
+    name: string;
+    /** Fund tier ranking (lower is better) */
+    tier: number;
+    top_projects: FundRankingItemTopProjectsItem[];
+    /** Fund type */
+    type?: string;
+}
+interface FundRankingItemTopProjectsItem {
+    /** Investment date (Unix seconds) */
+    invested_at?: number;
+    /** Whether this fund was the lead investor */
+    is_lead: boolean;
+    /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics for exact lookup. Prefer over 'q' (fuzzy name search). */
+    project_id: string;
+    /** Project logo URL */
+    project_logo?: string;
+    /** Project name */
+    project_name: string;
+    /** Project slug */
+    project_slug?: string;
+    /** Most recent funding round amount in USD */
+    recent_raise?: number;
+    /** Total amount raised by the project in USD */
+    total_raise?: number;
+}
+interface FundRankingParams {
+    /** Ranking metric. Can be `tier` (lower is better) or `portfolio_count` (number of invested projects). */
+    metric?: 'tier' | 'portfolio_count';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface MarketEtfItem {
+    etfs?: MarketEtfItemEtfsItem[];
+    /** Daily net flow in USD (positive=inflow, negative=outflow) */
+    flow_usd: number;
+    /** Token price in USD at close of day */
+    price_usd: number;
+    /** Unix timestamp in seconds (midnight UTC for the trading day) */
+    timestamp: number;
+}
+interface MarketEtfItemEtfsItem {
+    /** Daily net flow in USD for this ticker */
+    flow_usd: number;
+    /** ETF ticker symbol like `IBIT`, `GBTC`, or `ETHA` */
+    ticker: string;
+}
+interface MarketEtfParams {
+    /** Token symbol. Can be `BTC` or `ETH`. */
+    symbol?: 'BTC' | 'ETH';
+    /** Field to sort results by — @default 'timestamp' */
+    sort_by?: 'flow_usd' | 'timestamp';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+    /** Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD) */
+    from?: string;
+    /** End of time range. Accepts Unix seconds or date string (YYYY-MM-DD) */
+    to?: string;
+}
+interface MarketFearGreedItem {
+    /** Human-readable classification (Extreme Fear, Fear, Neutral, Greed, Extreme Greed) */
+    classification: string;
+    /** BTC price in USD at this point in time */
+    price: number;
+    /** Unix timestamp in seconds for this data point */
+    timestamp: number;
+    /** Fear and Greed Index score from 0 (extreme fear) to 100 (extreme greed) */
+    value: number;
+}
+interface MarketFearGreedParams {
+    /** Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD) */
+    from?: string;
+    /** End of time range. Accepts Unix seconds or date string (YYYY-MM-DD) */
+    to?: string;
+}
+interface MarketFuturesItem {
+    /** Current funding rate as a decimal (`0.0001` = 0.01%) */
+    funding_rate: number;
+    /** Ratio of long to short positions */
+    long_short_ratio: number;
+    /** Total open interest in USD */
+    open_interest: number;
+    /** Trading symbol like `BTC` or `ETH` */
+    symbol: string;
+    /** Unix timestamp (seconds) of last update */
+    updated_at: number;
+    /** 24-hour trading volume in USD */
+    volume_24h: number;
+    /** 24-hour volume change in USD (positive=increase, negative=decrease) */
+    volume_change_24h: number;
+}
+interface MarketFuturesParams {
+    /** Field to sort results by — @default 'volume_24h' */
+    sort_by?: 'open_interest' | 'funding_rate' | 'volume_24h' | 'long_short_ratio';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+}
+interface MarketLiquidationChartItem {
+    /** Long-side aggregated liquidation volume (USD) */
+    long_liquidation_usd: number;
+    /** Short-side aggregated liquidation volume (USD) */
+    short_liquidation_usd: number;
+    /** Unix timestamp in seconds */
+    timestamp: number;
+}
+interface MarketLiquidationChartParams {
+    /** Token ticker symbol like `BTC` or `ETH` */
+    symbol?: string;
+    /** Candlestick interval. Can be `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `4h`, `6h`, `8h`, `12h`, `1d`, or `1w`. — @default '1h' */
+    interval?: '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '4h' | '6h' | '8h' | '12h' | '1d' | '1w';
+    /** Exchange name. Can be `Binance`, `OKX`, `Bybit`, `Bitget`, `Hyperliquid`, `Gate`, `HTX`, `Bitmex`, `Bitfinex`, `CoinEx`, `Aster`, or `Lighter`. — @default 'Binance' */
+    exchange?: 'Binance' | 'OKX' | 'Bybit' | 'Bitget' | 'Hyperliquid' | 'Gate' | 'HTX' | 'Bitmex' | 'Bitfinex' | 'CoinEx' | 'Aster' | 'Lighter';
+    /** Results per page — @default '500' */
+    limit?: number;
+    /** Start of time range. Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`) */
+    from?: string;
+    /** End of time range. Accepts Unix seconds (`1706745600`) or date string (`2024-02-01`) */
+    to?: string;
+}
+interface MarketLiquidationExchangeListItem {
+    /** Exchange name like `Binance` or `OKX`. `All` = aggregate across all exchanges */
+    exchange: string;
+    /** Total liquidation volume (USD) */
+    liquidation_usd: number;
+    /** Long-side liquidation volume (USD) */
+    long_liquidation_usd: number;
+    /** Short-side liquidation volume (USD) */
+    short_liquidation_usd: number;
+}
+interface MarketLiquidationExchangeListParams {
+    /** Token ticker symbol like `BTC` or `ETH` — @default 'BTC' */
+    symbol?: string;
+    /** Aggregation time range. Can be `1h`, `4h`, `12h`, or `24h`. — @default '24h' */
+    time_range?: '1h' | '4h' | '12h' | '24h';
+    /** Field to sort results by — @default 'liquidation_usd' */
+    sort_by?: 'liquidation_usd' | 'long_liquidation_usd' | 'short_liquidation_usd';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+}
+interface MarketLiquidationOrderItem {
+    /** Base token symbol like `BTC` */
+    base_asset: string;
+    /** Exchange name like `Binance` or `OKX` */
+    exchange: string;
+    /** Liquidation execution price (USD) */
+    price: number;
+    /** Liquidation side: `long` or `short` */
+    side: string;
+    /** Full trading pair like `BTCUSDT` */
+    symbol: string;
+    /** Unix timestamp in seconds */
+    timestamp: number;
+    /** Liquidated position size (USD) */
+    usd_value: number;
+}
+interface MarketLiquidationOrderParams {
+    /** Exchange name. Can be `Binance`, `OKX`, `Bybit`, `Bitget`, `Hyperliquid`, `Gate`, `HTX`, `Bitmex`, `Bitfinex`, `CoinEx`, `Aster`, or `Lighter`. — @default 'Binance' */
+    exchange?: 'Binance' | 'OKX' | 'Bybit' | 'Bitget' | 'Hyperliquid' | 'Gate' | 'HTX' | 'Bitmex' | 'Bitfinex' | 'CoinEx' | 'Aster' | 'Lighter';
+    /** Token ticker symbol like `BTC` or `ETH` — @default 'BTC' */
+    symbol?: string;
+    /** Minimum liquidation amount in USD — @default '10000' */
+    min_amount?: string;
+    /** Filter by liquidation side. Omit to return both. */
+    side?: 'long' | 'short';
+    /** Field to sort results by — @default 'timestamp' */
+    sort_by?: 'usd_value' | 'timestamp' | 'price';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+    /** Start of time range. Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`) */
+    from?: string;
+    /** End of time range. Accepts Unix seconds (`1706745600`) or date string (`2024-02-01`) */
+    to?: string;
+}
+interface MarketOnchainIndicatorItem {
+    /** Metric name like `nupl`, `sopr`, or `price` */
+    metric?: string;
+    /** Token symbol this data point belongs to */
+    symbol?: string;
+    /** Unix timestamp in seconds for this data point */
+    timestamp: number;
+    /** Metric value at this timestamp */
+    value: number;
+}
+interface MarketOnchainIndicatorParams {
+    /** Token ticker symbol. Can be `BTC` or `ETH`. */
+    symbol?: 'BTC' | 'ETH';
+    /** On-chain metric name. Can be `nupl`, `sopr`, `mvrv`, `puell-multiple`, `nvm`, `nvt`, `nvt-golden-cross`, or `exchange-flows/{inflow,outflow,netflow,reserve}`. */
+    metric?: 'nupl' | 'sopr' | 'mvrv' | 'puell-multiple' | 'nvm' | 'nvt' | 'nvt-golden-cross' | 'exchange-flows/inflow' | 'exchange-flows/outflow' | 'exchange-flows/netflow' | 'exchange-flows/reserve';
+    /** Aggregation granularity. — @default 'day' */
+    granularity?: 'day';
+    /** Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD). Defaults to 90 days ago when omitted. Maximum range is 365 days. */
+    from?: string;
+    /** End of time range. Accepts Unix seconds or date string (YYYY-MM-DD). Defaults to today when omitted. Maximum range is 365 days. */
+    to?: string;
+    /** Exchange filter (only applies to exchange-flow metrics). Can be `all_exchange`, `spot_exchange`, `derivative_exchange`, `binance`, `bybit`, `kraken`, or `okx`. — @default 'all_exchange' */
+    exchange?: 'all_exchange' | 'spot_exchange' | 'derivative_exchange' | 'binance' | 'bybit' | 'kraken' | 'okx';
+}
+interface MarketOptionsItem {
+    /** Options exchange name */
+    exchange: string;
+    /** Max pain price for the nearest expiry in USD. Only available for individual exchanges (Deribit, OKX, Binance, Bybit), not present on the `All` aggregate row. */
+    max_pain_price?: number;
+    /** Total options open interest in USD */
+    open_interest: number;
+    /** Put/call open interest ratio (put OI / call OI). Values above 1 indicate bearish sentiment. Only available for individual exchanges (Deribit, OKX, Binance, Bybit), not present on the `All` aggregate row. */
+    put_call_ratio?: number;
+    /** Underlying token symbol like `BTC` or `ETH` */
+    symbol: string;
+    /** Unix timestamp (seconds) of last update */
+    updated_at: number;
+    /** 24-hour options trading volume in USD */
+    volume_24h: number;
+}
+interface MarketOptionsParams {
+    /** Token symbol. Can be `BTC`, `ETH`, `SOL`, `XRP`, `BNB`, `DOGE`, `ADA`, or `AVAX`. */
+    symbol?: 'BTC' | 'ETH' | 'SOL' | 'XRP' | 'BNB' | 'DOGE' | 'ADA' | 'AVAX';
+    /** Field to sort results by — @default 'volume_24h' */
+    sort_by?: 'open_interest' | 'volume_24h';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+}
+interface MarketPriceItem {
+    /** Metric name like `nupl`, `sopr`, or `price` */
+    metric?: string;
+    /** Token symbol this data point belongs to */
+    symbol?: string;
+    /** Unix timestamp in seconds for this data point */
+    timestamp: number;
+    /** Metric value at this timestamp */
+    value: number;
+}
+interface MarketPriceParams {
+    /** Single token ticker symbol like `BTC`, `ETH`, or `SOL` (multi-symbol not supported) */
+    symbol?: string;
+    /** Predefined time range for historical data. Ignored when `from`/`to` are set. Can be `1d`, `7d`, `14d`, `30d`, `90d`, `180d`, `365d`, or `max`. — @default '30d' */
+    time_range?: '1d' | '7d' | '14d' | '30d' | '90d' | '180d' | '365d' | 'max';
+    /** Start of custom date range (Unix timestamp or YYYY-MM-DD). Must be used together with `to`. Overrides `time_range` when set. */
+    from?: string;
+    /** End of custom date range (Unix timestamp or YYYY-MM-DD). Must be used together with `from`. Overrides `time_range` when set. */
+    to?: string;
+    /** Quote currency like `usd`, `eur`, or `btc` — @default 'usd' */
+    currency?: string;
+}
+interface MarketPriceIndicatorItem {
+    /** Time interval used to compute the indicator like `1h`, `4h`, or `1d` */
+    interval: string;
+    /** Indicator name like `rsi`, `macd`, or `bbands` */
+    name: string;
+    /** Token symbol this indicator is computed for */
+    symbol: string;
+    /** Candle open timestamp in Unix seconds (present in time-series responses) */
+    timestamp?: number;
+    /** Unix timestamp in seconds when the indicator was last computed */
+    updated_at?: number;
+    /** Primary indicator value */
+    value: number;
+    values?: MarketPriceIndicatorItemValues;
+}
+interface MarketPriceIndicatorItemValues {
+    /** Bollinger lower band */
+    bbands_lower?: number;
+    /** Bollinger middle band (SMA) */
+    bbands_middle?: number;
+    /** Bollinger upper band */
+    bbands_upper?: number;
+    /** Average Directional Index value */
+    dmi_adx?: number;
+    /** Negative Directional Indicator (-DI) */
+    dmi_mdi?: number;
+    /** Positive Directional Indicator (+DI) */
+    dmi_pdi?: number;
+    /** Ichimoku baseline (Kijun-sen) */
+    ichimoku_base?: number;
+    /** Ichimoku conversion line (Tenkan-sen) */
+    ichimoku_conversion?: number;
+    /** Ichimoku current span A */
+    ichimoku_current_span_a?: number;
+    /** Ichimoku current span B */
+    ichimoku_current_span_b?: number;
+    /** Ichimoku lagging span A */
+    ichimoku_lagging_span_a?: number;
+    /** Ichimoku lagging span B */
+    ichimoku_lagging_span_b?: number;
+    /** Ichimoku leading span A (Senkou A) */
+    ichimoku_span_a?: number;
+    /** Ichimoku leading span B (Senkou B) */
+    ichimoku_span_b?: number;
+    /** MACD histogram (MACD minus signal) */
+    macd_hist?: number;
+    /** MACD signal line */
+    macd_signal?: number;
+    /** MACD line value */
+    macd_value?: number;
+    /** Stochastic %D (slow line) */
+    stoch_d?: number;
+    /** Stochastic %K (fast line) */
+    stoch_k?: number;
+    /** Supertrend direction: `buy` (price above supertrend, bullish) or `sell` (price below supertrend, bearish) */
+    supertrend_advice?: string;
+    /** Supertrend line value */
+    supertrend_value?: number;
+}
+interface MarketPriceIndicatorParams {
+    /** Technical indicator name. Can be `rsi`, `macd`, `ema`, `sma`, `bbands`, `stoch`, `adx`, `atr`, `cci`, `obv`, `vwap`, `dmi`, `ichimoku`, or `supertrend`. */
+    indicator?: 'rsi' | 'macd' | 'ema' | 'sma' | 'bbands' | 'stoch' | 'adx' | 'atr' | 'cci' | 'obv' | 'vwap' | 'dmi' | 'ichimoku' | 'supertrend';
+    /** Trading pair as `BTC/USDT` or bare symbol like `BTC` */
+    symbol?: string;
+    /** Candlestick interval. Can be `1m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `12h`, `1d`, or `1w`. — @default '1d' */
+    interval?: '1m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '12h' | '1d' | '1w';
+    /** Exchange for price data. Can be `binance`, `bybit`, `coinbase`, or `kraken`. — @default 'binance' */
+    exchange?: 'binance' | 'bybit' | 'coinbase' | 'kraken';
+    /** Start of time range. When set, returns time-series instead of latest value. Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`) */
+    from?: string;
+    /** End of time range. Defaults to now when from is set. Accepts Unix seconds (`1706745600`) or date string (`2024-02-01`) */
+    to?: string;
+    /** Indicator-specific options as comma-separated key:value pairs. Available options by indicator: `period` — lookback period for rsi (default 14), sma (default 20), ema (default 20), bbands (default 20), adx (default 14), atr (default 14), cci (default 20), dmi (default 14), stoch (default 14), supertrend (default 10). `stddev` — standard deviation for bbands (default 2). `multiplier` — multiplier for supertrend (default 3). `fast_period` — MACD fast EMA (default 12). `slow_period` — MACD slow EMA (default 26). `signal_period` — MACD signal smoothing (default 9). Examples: `period:7`, `period:200`, `fast_period:8,slow_period:21,signal_period:5`, `period:10,stddev:1.5`. */
+    options?: string;
+}
+interface MarketRankingItem {
+    /** All-time high price in USD */
+    ath?: number;
+    /** All-time low price in USD */
+    atl?: number;
+    /** Price change percentage over the last 24 hours */
+    change_24h_pct: number;
+    /** Circulating token supply */
+    circulating_supply?: number;
+    /** Fully diluted valuation in USD */
+    fdv?: number;
+    /** Highest price in the last 24 hours in USD */
+    high_24h: number;
+    /** Token logo image URL */
+    image?: string;
+    /** Lowest price in the last 24 hours in USD */
+    low_24h: number;
+    /** Total market capitalization in USD */
+    market_cap_usd: number;
+    /** Maximum token supply (e.g. 21M for BTC). Not available for all tokens. */
+    max_supply?: number;
+    /** Full token name */
+    name: string;
+    /** Current price in USD */
+    price_usd: number;
+    /** Rank position in the list (1 = highest) */
+    rank: number;
+    /** Token ticker symbol like `BTC` or `ETH` */
+    symbol: string;
+    /** Total token supply */
+    total_supply?: number;
+    /** 24-hour trading volume in USD */
+    volume_24h_usd: number;
+}
+interface MarketRankingParams {
+    /** Field to sort by. `market_cap` sorts by total market capitalisation, `change_24h` sorts by 24-hour price change percentage (fetches top 250 by market cap then sorts client-side), `volume_24h` sorts by 24-hour trading volume. — @default 'market_cap' */
+    sort_by?: 'market_cap' | 'change_24h' | 'volume_24h';
+    /** Sort order: `desc` (default, highest first) or `asc` (lowest first). — @default 'desc' */
+    order?: 'asc' | 'desc';
+    /** Optional token category filter. When provided, results are limited to coins in that category. Supported values: MEME, AI, AI_AGENTS, L1, L2, DEFI, GAMING, STABLECOIN, RWA, DEPIN, SOL_ECO, BASE_ECO, LST. */
+    category?: 'MEME' | 'AI' | 'AI_AGENTS' | 'L1' | 'L2' | 'DEFI' | 'GAMING' | 'STABLECOIN' | 'RWA' | 'DEPIN' | 'SOL_ECO' | 'BASE_ECO' | 'LST';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface NewsDetailData {
+    /** Full article body text */
+    content: string;
+    /** Article ID */
+    id: string;
+    /** Surf project UUID */
+    project_id?: string;
+    /** Primary crypto project referenced in the article */
+    project_name?: string;
+    /** Unix timestamp in seconds when the article was published */
+    published_at: number;
+    /** Publisher name */
+    source?: string;
+    /** Short summary of the article */
+    summary?: string;
+    /** Article headline */
+    title: string;
+    /** Direct URL to the original article */
+    url?: string;
+}
+interface NewsDetailParams {
+    /** Article ID (returned as id in feed/search results) */
+    id?: string;
+}
+interface NewsFeedItem {
+    highlights?: NewsFeedItemHighlights;
+    /** Article ID. Use with the detail endpoint to fetch full content. */
+    id: string;
+    /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics for exact lookup */
+    project_id?: string;
+    /** Primary crypto project referenced in the article */
+    project_name?: string;
+    /** Unix timestamp in seconds when the article was published */
+    published_at: number;
+    /** Publisher name (e.g. COINDESK, COINTELEGRAPH) */
+    source?: string;
+    /** Short summary of the article */
+    summary?: string;
+    /** Article headline */
+    title: string;
+    /** Direct URL to the original article */
+    url?: string;
+}
+interface NewsFeedItemHighlights {
+    [key: string]: unknown;
+}
+interface NewsFeedParams {
+    /** Filter by news source */
+    source?: 'coindesk' | 'cointelegraph' | 'theblock' | 'decrypt' | 'dlnews' | 'blockbeats' | 'bitcoincom' | 'coinpedia' | 'ambcrypto' | 'cryptodaily' | 'cryptopotato' | 'phemex' | 'panews' | 'odaily' | 'tradingview' | 'chaincatcher' | 'techflow';
+    /** Comma-separated project names to filter by */
+    project?: string;
+    /** Filter articles published on or after this time. Accepts Unix seconds or date string (2024-01-01) */
+    from?: string;
+    /** Filter articles published on or before this time. Accepts Unix seconds or date string (2024-02-01) */
+    to?: string;
+    /** Sort order: recency (newest first) or trending (hot right now) — @default 'recency' */
+    sort_by?: 'recency' | 'trending';
+    /** Results per page (max 50) — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface OnchainBridgeRankingItem {
+    /** Bridge protocol name */
+    project: string;
+    /** Total number of bridge transfers */
+    tx_count: number;
+    /** Total USD volume in the time range */
+    volume_usd: number;
+}
+interface OnchainBridgeRankingParams {
+    /** Aggregation window — @default '30d' */
+    time_range?: '7d' | '30d' | '90d' | '180d' | '1y' | 'all';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface OnchainGasPriceData {
+    /** Canonical chain name */
+    chain: string;
+    /** Gas price in wei */
+    gas_price: string;
+    /** Gas price in Gwei */
+    gas_price_gwei: number;
+}
+interface OnchainGasPriceParams {
+    /** Chain. Can be `ethereum`, `polygon`, `bsc`, `arbitrum`, `optimism`, `base`, `avalanche`, `fantom`, `linea`, or `cyber`. */
+    chain?: 'ethereum' | 'polygon' | 'bsc' | 'arbitrum' | 'optimism' | 'base' | 'avalanche' | 'fantom' | 'linea' | 'cyber';
+}
+interface OnchainStructuredQueryItem {
+    [key: string]: unknown;
+}
+interface OnchainStructuredQueryParams {
+    fields?: unknown;
+    filters?: OnchainStructuredQueryParamsFiltersItem[];
+    /** Max rows to return. Default 20, max 10000 */
+    limit?: number;
+    /** Rows to skip for pagination. Default 0 */
+    offset?: number;
+    sort?: OnchainStructuredQueryParamsSortItem[];
+    /** Fully-qualified table name like `agent.my_table` */
+    source: string;
+}
+interface OnchainStructuredQueryParamsFiltersItem {
+    /** Column name to filter on like `block_number` or `from_address` */
+    field: string;
+    /** Comparison operator: eq, neq, gt, gte, lt, lte, like, in, not_in. For `in`/`not_in`, value must be a JSON array */
+    op: string;
+    /** <any> */
+    value: unknown;
+}
+interface OnchainStructuredQueryParamsSortItem {
+    /** Column name to sort by like `gas`, `block_number`, or `amount_usd` */
+    field: string;
+    /** Sort direction: asc (default) or desc */
+    order?: string;
+}
+interface OnchainSchemaItem {
+    columns: OnchainSchemaItemColumnsItem[];
+    /** Database name (always `agent`) */
+    database: string;
+    /** Table name */
+    table: string;
+}
+interface OnchainSchemaItemColumnsItem {
+    /** Column comment or description */
+    comment?: string;
+    /** Column name */
+    name: string;
+    /** Column data type like `UInt64`, `String`, or `DateTime` */
+    type: string;
+}
+interface OnchainSqlItem {
+    [key: string]: unknown;
+}
+interface OnchainSqlParams {
+    /** Maximum number of rows to return — @default '1000' */
+    max_rows?: number;
+    /** SQL query to execute against the blockchain data warehouse */
+    sql: string;
+}
+interface OnchainTxItem {
+    accessList: OnchainTxItemAccesslistItem[];
+    blobVersionedHashes?: unknown;
+    /** Block hash, null if pending */
+    blockHash: unknown;
+    /** Block number (hex), null if pending */
+    blockNumber: unknown;
+    /** Chain ID (hex) */
+    chainId?: string;
+    /** Sender address (0x-prefixed) */
+    from: string;
+    /** Gas limit (hex) */
+    gas: string;
+    /** Gas price in wei (hex). Present in all types; for EIP-1559 this is the effective gas price */
+    gasPrice?: string;
+    /** Transaction hash (0x-prefixed) */
+    hash: string;
+    /** Call data (hex) */
+    input: string;
+    /** Max fee per blob gas in wei (hex). EIP-4844 only */
+    maxFeePerBlobGas?: string;
+    /** Max fee per gas in wei (hex). EIP-1559/EIP-4844 only */
+    maxFeePerGas?: string;
+    /** Max priority fee per gas in wei (hex). EIP-1559/EIP-4844 only */
+    maxPriorityFeePerGas?: string;
+    /** Sender nonce (hex) */
+    nonce: string;
+    /** Signature R (hex) */
+    r: string;
+    /** Signature S (hex) */
+    s: string;
+    /** Recipient address, null for contract creation */
+    to: unknown;
+    /** Index in block (hex), null if pending */
+    transactionIndex: unknown;
+    /** Transaction type: 0x0=legacy, 0x1=EIP-2930, 0x2=EIP-1559, 0x3=EIP-4844 */
+    type: string;
+    /** Signature V (hex). Legacy: recovery ID (0x1b/0x1c); EIP-2930+: parity (0x0/0x1) */
+    v: string;
+    /** ETH value in wei (hex) */
+    value: string;
+    /** Signature Y parity (hex). Present in EIP-2930+ transactions */
+    yParity?: string;
+}
+interface OnchainTxItemAccesslistItem {
+    /** Account address (0x-prefixed) */
+    address: string;
+    storageKeys: unknown;
+}
+interface OnchainTxParams {
+    /** Transaction hash (0x-prefixed hex) */
+    hash?: string;
+    /** Chain. Can be `ethereum`, `polygon`, `bsc`, `arbitrum`, `optimism`, `base`, `avalanche`, `fantom`, `linea`, or `cyber`. */
+    chain?: 'ethereum' | 'polygon' | 'bsc' | 'arbitrum' | 'optimism' | 'base' | 'avalanche' | 'fantom' | 'linea' | 'cyber';
+}
+interface OnchainYieldRankingItem {
+    /** Total APY (base + reward) */
+    apy: number;
+    /** Base APY from pool fees or interest */
+    apy_base: number;
+    /** Reward token APY */
+    apy_reward: number;
+    /** Pool or vault contract address */
+    pool_address: string;
+    /** Protocol name */
+    project: string;
+    /** Token symbol */
+    symbol: string;
+    /** Underlying token address */
+    token_address: string;
+    /** Pool TVL in USD */
+    tvl_usd: number;
+    /** Protocol version */
+    version: string;
+}
+interface OnchainYieldRankingParams {
+    /** Filter by protocol name like `lido`, `aave`, or `uniswap` */
+    project?: string;
+    /** Ranking metric: `apy` or `tvl_usd`. When sorted by `apy`, only pools with TVL >= $100k are included — @default 'apy' */
+    sort_by?: 'apy' | 'tvl_usd';
+    /** Sort direction — @default 'desc' */
+    order?: 'asc' | 'desc';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface PredictionMarketCategoryMetricsItem {
+    /** Top-level category */
+    category: string;
+    /** Notional trading volume in USD */
+    notional_volume_usd: number;
+    /** Open interest in USD */
+    open_interest_usd: number;
+    /** Prediction market platform: Kalshi or Polymarket */
+    source: string;
+    /** Subcategory within the category */
+    subcategory: string;
+    /** Unix timestamp in seconds (midnight UTC for the trading day) */
+    timestamp: number;
+}
+interface PredictionMarketCategoryMetricsParams {
+    /** Filter by prediction market platform: `Kalshi` or `Polymarket` */
+    source?: 'Kalshi' | 'Polymarket';
+    /** Filter by top-level category */
+    category?: 'crypto' | 'culture' | 'economics' | 'financials' | 'politics' | 'stem' | 'sports';
+    /** Predefined time range: `7d`, `30d`, `90d`, `180d`, `1y`, or `all` — @default '30d' */
+    time_range?: '7d' | '30d' | '90d' | '180d' | '1y' | 'all';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface KalshiEventsItem {
+    /** Event subtitle */
+    event_subtitle?: string;
+    /** Unique event ticker identifier */
+    event_ticker: string;
+    /** Event title */
+    event_title: string;
+    /** Number of markets in this event */
+    market_count: number;
+    markets: KalshiEventsItemMarketsItem[];
+}
+interface KalshiEventsItemMarketsItem {
+    /** Surf curated market category */
+    category?: string;
+    /** Market close time (Unix seconds) */
+    close_time?: number;
+    /** Market end time (Unix seconds) */
+    end_time?: number;
+    /** Parent event ticker */
+    event_ticker: string;
+    /** Event title */
+    event_title?: string;
+    /** Previous day open interest from daily report */
+    last_day_open_interest: number;
+    /** Unique market ticker identifier */
+    market_ticker: string;
+    /** Last day notional trading volume in USD (each contract = $1) */
+    notional_volume_usd: number;
+    /** Open interest (contracts) */
+    open_interest: number;
+    /** Payout type */
+    payout_type: string;
+    /** Market result if resolved */
+    result?: string;
+    /** Market start time (Unix seconds) */
+    start_time?: number;
+    /** Market status */
+    status: string;
+    /** Surf curated market subcategory */
+    subcategory?: string;
+    /** Market title */
+    title: string;
+    /** Total trading volume (contracts) */
+    total_volume: number;
+}
+interface KalshiEventsParams {
+    /** Event ticker identifier */
+    event_ticker?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface KalshiMarketsItem {
+    /** Surf curated market category */
+    category?: string;
+    /** Market close time (Unix seconds) */
+    close_time?: number;
+    /** Market end time (Unix seconds) */
+    end_time?: number;
+    /** Parent event ticker */
+    event_ticker: string;
+    /** Event title */
+    event_title?: string;
+    /** Previous day open interest from daily report */
+    last_day_open_interest: number;
+    /** Unique market ticker identifier */
+    market_ticker: string;
+    /** Last day notional trading volume in USD (each contract = $1) */
+    notional_volume_usd: number;
+    /** Open interest (contracts) */
+    open_interest: number;
+    /** Payout type */
+    payout_type: string;
+    /** Market result if resolved */
+    result?: string;
+    /** Market start time (Unix seconds) */
+    start_time?: number;
+    /** Market status */
+    status: string;
+    /** Surf curated market subcategory */
+    subcategory?: string;
+    /** Market title */
+    title: string;
+    /** Total trading volume (contracts) */
+    total_volume: number;
+}
+interface KalshiMarketsParams {
+    /** Market ticker identifier */
+    market_ticker?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface KalshiOpenInterestItem {
+    /** Open interest on this date (contracts) */
+    open_interest: number;
+    /** Unix timestamp in seconds (midnight UTC for the trading day) */
+    timestamp: number;
+}
+interface KalshiOpenInterestParams {
+    /** Market ticker identifier */
+    ticker?: string;
+    /** Predefined time range: `7d`, `30d`, `90d`, `180d`, or `1y` — @default '30d' */
+    time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
+}
+interface KalshiPricesItem {
+    /** Highest price as probability (0-1) */
+    high: number;
+    /** Lowest price as probability (0-1) */
+    low: number;
+    /** Opening price as probability (0-1). Present for daily interval only. */
+    open?: number;
+    side_a: KalshiPricesItemSideA;
+    side_b: KalshiPricesItemSideB;
+    /** Unix timestamp in seconds (midnight UTC for daily, hour start for hourly, trade time for latest) */
+    timestamp: number;
+}
+interface KalshiPricesItemSideA {
+    /** Outcome label: `Yes` or `No` */
+    label: string;
+    /** Price as probability (0-1) */
+    price: number;
+}
+interface KalshiPricesItemSideB {
+    /** Outcome label: `Yes` or `No` */
+    label: string;
+    /** Price as probability (0-1) */
+    price: number;
+}
+interface KalshiPricesParams {
+    /** Market ticker identifier */
+    ticker?: string;
+    /** Predefined time range: `7d`, `30d`, `90d`, `180d`, or `1y`. Ignored when `interval=latest`. — @default '30d' */
+    time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
+    /** Data interval: `1h` for hourly, `1d` for daily OHLC, `latest` for real-time price from trades — @default '1d' */
+    interval?: '1h' | '1d' | 'latest';
+}
+interface KalshiRankingItem {
+    /** Surf curated market category */
+    category?: string;
+    /** Market close time (Unix seconds) */
+    close_time?: number;
+    /** Market end time (Unix seconds) */
+    end_time?: number;
+    /** Parent event ticker */
+    event_ticker: string;
+    /** Event title */
+    event_title?: string;
+    /** Previous day open interest from daily report */
+    last_day_open_interest: number;
+    /** Unique market ticker identifier */
+    market_ticker: string;
+    /** Last day notional trading volume in USD (each contract = $1) */
+    notional_volume_usd: number;
+    /** Open interest (contracts) */
+    open_interest: number;
+    /** Payout type */
+    payout_type: string;
+    /** Market result if resolved */
+    result?: string;
+    /** Market start time (Unix seconds) */
+    start_time?: number;
+    /** Market status */
+    status: string;
+    /** Surf curated market subcategory */
+    subcategory?: string;
+    /** Market title */
+    title: string;
+    /** Total trading volume (contracts) */
+    total_volume: number;
+}
+interface KalshiRankingParams {
+    /** Field to sort results by — @default 'notional_volume_usd' */
+    sort_by?: 'notional_volume_usd' | 'open_interest';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+    /** Market status filter: `active`, `closed`, `determined`, `disputed`, `finalized`, `inactive`, or `initialized` — @default 'active' */
+    status?: 'active' | 'closed' | 'determined' | 'disputed' | 'finalized' | 'inactive' | 'initialized';
+    /** Filter by category */
+    category?: 'crypto' | 'culture' | 'economics' | 'financials' | 'politics' | 'stem' | 'sports' | 'unknown';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface KalshiTradesItem {
+    /** Unique market ticker identifier */
+    market_ticker: string;
+    /** No outcome price as probability (0-1) */
+    no_price: number;
+    /** Notional volume in USD (each contract = $1) */
+    notional_volume_usd: number;
+    /** Taker side: `yes` or `no` */
+    taker_side: string;
+    /** Unix timestamp in seconds */
+    timestamp: number;
+    /** Unique trade identifier */
+    trade_id: string;
+    /** Yes outcome price as probability (0-1) */
+    yes_price: number;
+}
+interface KalshiTradesParams {
+    /** Market ticker identifier */
+    ticker?: string;
+    /** Filter by taker side: `yes` or `no` */
+    taker_side?: 'yes' | 'no';
+    /** Minimum notional volume in USD (each contract = $1) */
+    min_amount?: number;
+    /** Start of time range. Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`) */
+    from?: string;
+    /** End of time range. Accepts Unix seconds (`1706745600`) or date string (`2024-02-01`) */
+    to?: string;
+    /** Field to sort results by — @default 'timestamp' */
+    sort_by?: 'timestamp' | 'notional_volume_usd';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+    /** Results per page — @default '50' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface KalshiVolumesItem {
+    /** Notional volume in USD (each contract counted as $1) */
+    notional_volume_usd: number;
+    /** Unix timestamp in seconds (midnight UTC for the trading day) */
+    timestamp: number;
+}
+interface KalshiVolumesParams {
+    /** Market ticker identifier */
+    ticker?: string;
+    /** Predefined time range: `7d`, `30d`, `90d`, `180d`, or `1y` — @default '30d' */
+    time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
+}
+interface PolymarketActivityItem {
+    /** Market condition identifier */
+    condition_id: string;
+    /** Outcome label */
+    outcome: string;
+    /** Trade price (0-1) */
+    price: number;
+    /** Trade side */
+    side: string;
+    /** Trade size in shares */
+    size: number;
+    /** Activity Unix timestamp in seconds */
+    timestamp: number;
+    /** Market title */
+    title: string;
+    /** Transaction hash */
+    transaction_hash: string;
+    /** Activity type such as `buy`, `sell`, or `redeem` */
+    type: string;
+    /** Trade size in USDC */
+    usdc_size: number;
+}
+interface PolymarketActivityParams {
+    /** Polymarket proxy wallet address */
+    address?: string;
+    /** Results per page — @default '50' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface PolymarketEventsItem {
+    /** Surf curated event category */
+    category?: string;
+    /** Event description */
+    description?: string;
+    /** Event end time (Unix seconds) */
+    end_time?: number;
+    /** Event identifier slug */
+    event_slug: string;
+    /** Event image URL */
+    image?: string;
+    /** Number of markets in this event */
+    market_count: number;
+    markets: PolymarketEventsItemMarketsItem[];
+    /** Resolution source URL */
+    settlement_sources?: string;
+    /** Event start time (Unix seconds) */
+    start_time?: number;
+    /** Event status: `open` if any market is open, `closed` if all markets are closed */
+    status: string;
+    /** Surf curated event subcategory */
+    subcategory?: string;
+    tags?: unknown;
+    /** Event title */
+    title: string;
+    /** Total event volume across all markets (USD) */
+    volume_total: number;
+}
+interface PolymarketEventsItemMarketsItem {
+    /** Surf curated market category */
+    category?: string;
+    /** Market close time (Unix seconds) */
+    close_time?: number;
+    /** Resolution time (Unix seconds) */
+    completed_time?: number;
+    /** Unique condition identifier */
+    condition_id: string;
+    /** Market description */
+    description?: string;
+    /** Market end time (Unix seconds) */
+    end_time?: number;
+    /** Event identifier slug */
+    event_slug?: string;
+    /** Game start time for sports markets (Unix seconds) */
+    game_start_time?: number;
+    /** Market image URL */
+    image?: string;
+    /** Market identifier slug */
+    market_slug: string;
+    /** Negative risk market identifier */
+    negative_risk_id?: string;
+    /** Link to Polymarket page */
+    polymarket_link?: string;
+    /** URL to resolution data source */
+    resolution_source?: string;
+    side_a?: PolymarketEventsItemMarketsItemSideA;
+    side_b?: PolymarketEventsItemMarketsItemSideB;
+    /** Market start time (Unix seconds) */
+    start_time?: number;
+    /** Market status: `open` or `closed` */
+    status: string;
+    /** Surf curated market subcategory */
+    subcategory?: string;
+    tags?: unknown;
+    /** Market title */
+    title: string;
+    /** Trading volume in the past month (USD) */
+    volume_1_month: number;
+    /** Trading volume in the past week (USD) */
+    volume_1_week: number;
+    /** Trading volume in the past year (USD) */
+    volume_1_year: number;
+    /** Total trading volume (USD) */
+    volume_total: number;
+    /** Winning outcome label, if resolved */
+    winning_side?: string;
+}
+interface PolymarketEventsItemMarketsItemSideA {
+    /** Token identifier for this outcome */
+    id: string;
+    /** Outcome label */
+    label: string;
+}
+interface PolymarketEventsItemMarketsItemSideB {
+    /** Token identifier for this outcome */
+    id: string;
+    /** Outcome label */
+    label: string;
+}
+interface PolymarketEventsParams {
+    /** Event slug identifier */
+    event_slug?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface PolymarketMarketsItem {
+    /** Surf curated market category */
+    category?: string;
+    /** Market close time (Unix seconds) */
+    close_time?: number;
+    /** Resolution time (Unix seconds) */
+    completed_time?: number;
+    /** Unique condition identifier */
+    condition_id: string;
+    /** Market description */
+    description?: string;
+    /** Market end time (Unix seconds) */
+    end_time?: number;
+    /** Event identifier slug */
+    event_slug?: string;
+    /** Game start time for sports markets (Unix seconds) */
+    game_start_time?: number;
+    /** Market image URL */
+    image?: string;
+    /** Market identifier slug */
+    market_slug: string;
+    /** Negative risk market identifier */
+    negative_risk_id?: string;
+    /** Link to Polymarket page */
+    polymarket_link?: string;
+    /** URL to resolution data source */
+    resolution_source?: string;
+    side_a?: PolymarketMarketsItemSideA;
+    side_b?: PolymarketMarketsItemSideB;
+    /** Market start time (Unix seconds) */
+    start_time?: number;
+    /** Market status: `open` or `closed` */
+    status: string;
+    /** Surf curated market subcategory */
+    subcategory?: string;
+    tags?: unknown;
+    /** Market title */
+    title: string;
+    /** Trading volume in the past month (USD) */
+    volume_1_month: number;
+    /** Trading volume in the past week (USD) */
+    volume_1_week: number;
+    /** Trading volume in the past year (USD) */
+    volume_1_year: number;
+    /** Total trading volume (USD) */
+    volume_total: number;
+    /** Winning outcome label, if resolved */
+    winning_side?: string;
+}
+interface PolymarketMarketsItemSideA {
+    /** Token identifier for this outcome */
+    id: string;
+    /** Outcome label */
+    label: string;
+}
+interface PolymarketMarketsItemSideB {
+    /** Token identifier for this outcome */
+    id: string;
+    /** Outcome label */
+    label: string;
+}
+interface PolymarketMarketsParams {
+    /** Market slug identifier */
+    market_slug?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface PolymarketOpenInterestItem {
+    /** Daily net change in USD */
+    daily_net_change_usd: number;
+    /** Open interest in USD */
+    open_interest_usd: number;
+    /** Unix timestamp in seconds (midnight UTC) */
+    timestamp: number;
+}
+interface PolymarketOpenInterestParams {
+    /** Market condition identifier */
+    condition_id?: string;
+    /** Predefined time range — @default '30d' */
+    time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
+}
+interface PolymarketPositionsItem {
+    /** Average entry price (0-1) */
+    avg_price: number;
+    /** Unrealized profit and loss in USD */
+    cash_pnl: number;
+    /** Market condition identifier */
+    condition_id: string;
+    /** Current market price (0-1) */
+    cur_price: number;
+    /** Current position value in USD */
+    current_value: number;
+    /** Outcome label */
+    outcome_label: string;
+    /** Market question */
+    question: string;
+    /** Realized profit and loss in USD */
+    realized_pnl: number;
+    /** Whether the position is redeemable */
+    redeemable: boolean;
+    /** Position size in shares */
+    size: number;
+}
+interface PolymarketPositionsParams {
+    /** Polymarket proxy wallet address */
+    address?: string;
+    /** Results per page — @default '50' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface PolymarketPricesItem {
+    side_a?: PolymarketPricesItemSideA;
+    side_b?: PolymarketPricesItemSideB;
+    /** Interval start Unix timestamp in seconds */
+    timestamp: number;
+}
+interface PolymarketPricesItemSideA {
+    /** Outcome label such as `Yes` or `No` */
+    label: string;
+    /** Average price over the interval (0-1) */
+    price: number;
+    /** Outcome token identifier */
+    token_id: string;
+}
+interface PolymarketPricesItemSideB {
+    /** Outcome label such as `Yes` or `No` */
+    label: string;
+    /** Average price over the interval (0-1) */
+    price: number;
+    /** Outcome token identifier */
+    token_id: string;
+}
+interface PolymarketPricesParams {
+    /** Market condition identifier */
+    condition_id?: string;
+    /** Predefined time range. Ignored when `interval` is `latest`. — @default '30d' */
+    time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
+    /** Aggregation interval: `1h` (hourly), `1d` (daily), or `latest` (most recent snapshot) — @default '1d' */
+    interval?: '1h' | '1d' | 'latest';
+}
+interface PolymarketRankingItem {
+    /** Surf curated market category */
+    category?: string;
+    /** Unique condition identifier */
+    condition_id: string;
+    /** Market end time (Unix seconds) */
+    end_time?: number;
+    /** Notional trading volume (USD) */
+    notional_volume_usd: number;
+    /** Current open interest (USD) */
+    open_interest_usd: number;
+    /** Link to Polymarket page */
+    polymarket_link?: string;
+    /** Market question text */
+    question: string;
+    /** Market status */
+    status: string;
+    /** Surf curated market subcategory */
+    subcategory?: string;
+    tags?: unknown;
+}
+interface PolymarketRankingParams {
+    /** Sort by last day's `notional_volume_usd` or `open_interest` — @default 'notional_volume_usd' */
+    sort_by?: 'notional_volume_usd' | 'open_interest';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+    /** Market status filter: `active`, `finalized`, `ended`, `initialized`, or `closed` — @default 'active' */
+    status?: 'active' | 'finalized' | 'ended' | 'initialized' | 'closed';
+    /** Filter by Surf-curated category */
+    category?: 'crypto' | 'culture' | 'early_polymarket_trades' | 'economics' | 'financials' | 'politics' | 'stem' | 'sports' | 'unknown';
+    /** Filter markets ending within this window from now: `24h`, `3d`, `7d`, `14d`, or `30d` */
+    end_before?: '24h' | '3d' | '7d' | '14d' | '30d';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface PolymarketTradesItem {
+    /** Trade amount in USD */
+    amount_usd: number;
+    /** Block number */
+    block_number: number;
+    /** Trade Unix timestamp in seconds */
+    block_time: number;
+    /** Market condition identifier */
+    condition_id: string;
+    /** Event log index */
+    evt_index: number;
+    /** Exchange contract address */
+    exchange_address: string;
+    /** Fee amount in USD */
+    fee_usd: number;
+    /** Maker wallet address */
+    maker_address: string;
+    /** Whether this is a negative risk trade */
+    neg_risk: boolean;
+    /** Outcome label such as `Yes` or `No` */
+    outcome_label: string;
+    /** Outcome token identifier */
+    outcome_token_id: string;
+    /** Trade price (0-1) */
+    price: number;
+    /** Market question text */
+    question: string;
+    /** Number of shares traded */
+    shares: number;
+    /** Taker wallet address */
+    taker_address: string;
+    /** Transaction hash */
+    tx_hash: string;
+}
+interface PolymarketTradesParams {
+    /** Market condition identifier */
+    condition_id?: string;
+    /** Wallet address — returns trades where the address is maker or taker */
+    address?: string;
+    /** Filter by outcome label: `Yes` or `No` */
+    outcome_label?: 'Yes' | 'No';
+    /** Minimum trade amount in USD */
+    min_amount?: number;
+    /** Start of time range. Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`) */
+    from?: string;
+    /** End of time range. Accepts Unix seconds (`1706745600`) or date string (`2024-02-01`) */
+    to?: string;
+    /** Field to sort results by — @default 'timestamp' */
+    sort_by?: 'timestamp' | 'notional_volume_usd';
+    /** Results per page — @default '50' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface PolymarketVolumesItem {
+    /** Notional trading volume in USD */
+    notional_volume_usd: number;
+    /** Interval start Unix timestamp in seconds */
+    timestamp: number;
+    /** Number of trades */
+    trade_count: number;
+}
+interface PolymarketVolumesParams {
+    /** Market condition identifier */
+    condition_id?: string;
+    /** Predefined time range — @default '30d' */
+    time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
+    /** Aggregation interval: `1h` (hourly) or `1d` (daily) — @default '1d' */
+    interval?: '1h' | '1d';
+}
+interface ProjectDefiMetricsItem {
+    /** Unix timestamp in seconds for this data point */
+    timestamp: number;
+    /** Metric value at this timestamp */
+    value: number;
+}
+interface ProjectDefiMetricsParams {
+    /** Surf project UUID. PREFERRED — always use this when available from a previous response (e.g. project_id from /fund/portfolio or id from /search/project). Takes priority over q. */
+    id?: string;
+    /** Fuzzy entity name search. Only use when 'id' is not available. May return unexpected results for ambiguous names. */
+    q?: string;
+    /** Metric to query. Can be `volume`, `fees` (or `fee` alias), `revenue`, `tvl`, or `users`. */
+    metric?: 'volume' | 'fee' | 'fees' | 'revenue' | 'tvl' | 'users';
+    /** Start of time range. Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`) */
+    from?: string;
+    /** End of time range. Accepts Unix seconds (`1706745600`) or date string (`2024-02-01`) */
+    to?: string;
+    /** Filter by chain. Can be `ethereum`, `polygon`, `bsc`, `arbitrum`, `optimism`, `base`, `avalanche`, `fantom`, or `solana`. */
+    chain?: 'ethereum' | 'polygon' | 'bsc' | 'arbitrum' | 'optimism' | 'base' | 'avalanche' | 'fantom' | 'solana';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface ProjectDefiRankingItem {
+    fees?: number;
+    /** Project logo image URL */
+    logo_url?: string;
+    name: string;
+    revenue?: number;
+    symbol?: string;
+    tvl?: number;
+    users?: number;
+    volume?: number;
+}
+interface ProjectDefiRankingParams {
+    /** Ranking metric. Can be `tvl`, `revenue`, `fees`, `volume`, or `users`. */
+    metric?: 'tvl' | 'revenue' | 'fees' | 'volume' | 'users';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface ProjectDetailData {
+    contracts?: ProjectDetailDataContracts;
+    funding?: ProjectDetailDataFunding;
+    overview?: ProjectDetailDataOverview;
+    social?: ProjectDetailDataSocial;
+    team?: ProjectDetailDataTeam;
+    tge_status?: ProjectDetailDataTgeStatus;
+    token_info?: ProjectDetailDataTokenInfo;
+    tokenomics?: ProjectDetailDataTokenomics;
+}
+interface ProjectDetailDataContracts {
+    contracts?: ProjectDetailDataContractsContractsItem[];
+}
+interface ProjectDetailDataFunding {
+    rounds?: ProjectDetailDataFundingRoundsItem[];
+    /** Total capital raised across all rounds in USD */
+    total_raise?: number;
+}
+interface ProjectDetailDataOverview {
+    chains?: unknown;
+    /** Short description of the project */
+    description?: string;
+    exchanges?: unknown;
+    /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics for exact lookup. Prefer over 'q' (fuzzy name search). */
+    id: string;
+    /** Project logo image URL */
+    logo_url?: string;
+    /** Project name */
+    name: string;
+    /** URL-friendly project slug */
+    slug?: string;
+    tags?: unknown;
+    /** TGE status: pre, upcoming, or post */
+    tge_status?: string;
+    /** Primary token ticker symbol */
+    token_symbol?: string;
+    /** Project official website URL */
+    website?: string;
+    /** Number of X (Twitter) followers */
+    x_followers: number;
+    /** X (Twitter) handle without the @ prefix */
+    x_handle?: string;
+}
+interface ProjectDetailDataSocial {
+    discord?: ProjectDetailDataSocialDiscord;
+    github?: ProjectDetailDataSocialGithub;
+    telegram?: ProjectDetailDataSocialTelegram;
+    twitter?: ProjectDetailDataSocialTwitter;
+}
+interface ProjectDetailDataTeam {
+    members?: ProjectDetailDataTeamMembersItem[];
+}
+interface ProjectDetailDataTgeStatus {
+    /** TGE status: `pre`, `upcoming`, or `post`. Omitted when unknown. */
+    current_status?: string;
+    exchanges?: unknown;
+    /** Unix timestamp of the last TGE event */
+    last_event_time?: number;
+}
+interface ProjectDetailDataTokenInfo {
+    /** All-time high price in USD */
+    all_time_high?: number;
+    /** All-time low price in USD */
+    all_time_low?: number;
+    /** Circulating token supply */
+    circulating_supply?: number;
+    /** Fully diluted valuation in USD */
+    fdv?: number;
+    /** 24-hour high price in USD */
+    high_24h?: number;
+    /** Token logo image URL */
+    image?: string;
+    /** 24-hour low price in USD */
+    low_24h?: number;
+    /** Market capitalization in USD */
+    market_cap_usd?: number;
+    /** Full token name */
+    name: string;
+    /** 24-hour price change percentage */
+    price_change_24h?: number;
+    /** 30-day price change percentage */
+    price_change_30d?: number;
+    /** 7-day price change percentage */
+    price_change_7d?: number;
+    /** Current price in USD */
+    price_usd?: number;
+    /** Token ticker symbol */
+    symbol: string;
+    /** Total token supply */
+    total_supply?: number;
+    /** 24-hour trading volume in USD */
+    volume_24h?: number;
+}
+interface ProjectDetailDataTokenomics {
+    /** Number of tokens currently in public circulation */
+    circulating_supply?: number;
+    /** Fully diluted valuation in USD */
+    fdv?: number;
+    /** Total market capitalization in USD */
+    market_cap_usd?: number;
+    /** Total token supply */
+    total_supply?: number;
+}
+interface ProjectDetailDataContractsContractsItem {
+    /** Contract address on the specified chain */
+    address: string;
+    /** Chain name like `ethereum`, `bsc`, or `solana` */
+    chain: string;
+    /** Human-readable label for this contract like `Token` or `Staking` */
+    label?: string;
+}
+interface ProjectDetailDataFundingRoundsItem {
+    /** Amount raised in USD */
+    amount?: number;
+    /** Date when the round closed in ISO 8601 format */
+    date?: string;
+    investors?: ProjectDetailDataFundingRoundsItemInvestorsItem[];
+    /** Funding round name like `Seed`, `Series A`, or `Private` */
+    round_name: string;
+    /** Project valuation at round close in USD */
+    valuation?: number;
+}
+interface ProjectDetailDataSocialDiscord {
+    /** Number of followers on this platform */
+    followers_count?: number;
+    /** Username or handle on the social platform */
+    handle?: string;
+    /** Profile URL on the social platform */
+    url?: string;
+}
+interface ProjectDetailDataSocialGithub {
+    /** Number of followers on this platform */
+    followers_count?: number;
+    /** Username or handle on the social platform */
+    handle?: string;
+    /** Profile URL on the social platform */
+    url?: string;
+}
+interface ProjectDetailDataSocialTelegram {
+    /** Number of followers on this platform */
+    followers_count?: number;
+    /** Username or handle on the social platform */
+    handle?: string;
+    /** Profile URL on the social platform */
+    url?: string;
+}
+interface ProjectDetailDataSocialTwitter {
+    /** Number of followers on this platform */
+    followers_count?: number;
+    /** Username or handle on the social platform */
+    handle?: string;
+    /** Profile URL on the social platform */
+    url?: string;
+}
+interface ProjectDetailDataTeamMembersItem {
+    /** Team member profile image URL */
+    image?: string;
+    /** Team member's full name */
+    name: string;
+    /** Team member's role or title */
+    role?: string;
+    social_links?: ProjectDetailDataTeamMembersItemSocialLinks;
+}
+interface ProjectDetailDataFundingRoundsItemInvestorsItem {
+    /** Whether this investor led the round */
+    is_lead: boolean;
+    /** Investor logo URL */
+    logo?: string;
+    /** Investor name */
+    name: string;
+    /** Investor type (FUND or PERSON) */
+    type?: string;
+}
+interface ProjectDetailDataTeamMembersItemSocialLinks {
+    [key: string]: unknown;
+}
+interface ProjectDetailParams {
+    /** Surf project UUID. PREFERRED — always use this when available from a previous response (e.g. project_id from /fund/portfolio or id from /search/project). Takes priority over q. */
+    id?: string;
+    /** Fuzzy entity name search. Only use when 'id' is not available. May return unexpected results for ambiguous names. */
+    q?: string;
+    /** Comma-separated sub-resources to include. Can be `overview`, `token_info`, `tokenomics`, `funding`, `team`, `contracts`, `social`, or `tge_status`. — @default 'overview' */
+    fields?: string;
+}
+interface SearchAirdropItem {
+    /** Token ticker symbol */
+    coin_symbol?: string;
+    /** X/Twitter follower count (0 if unknown) */
+    followers_count: number;
+    /** Last status change as Unix seconds */
+    last_status_update: number;
+    /** Project logo image URL */
+    logo_url?: string;
+    /** Surf project UUID if linked */
+    project_id?: string;
+    /** Project/coin name */
+    project_name: string;
+    /** Expected reward date as Unix seconds (0 if unknown) */
+    reward_date: number;
+    /** Reward type: airdrop, points, whitelist, nft, role, ambassador */
+    reward_type?: string;
+    /** Airdrop lifecycle stage: `POTENTIAL` (speculated, tasks open), `CONFIRMED` (announced, tasks open), `SNAPSHOT` (eligibility snapshot taken), `VERIFICATION` (claim window open), `REWARD_AVAILABLE` (ready to claim), `DISTRIBUTED` (sent, historical) */
+    status: string;
+    task_summary?: SearchAirdropItemTaskSummary;
+    tasks?: SearchAirdropItemTasksItem[];
+    /** Total project fundraise in USD (0 if unknown) */
+    total_raise: number;
+    /** CryptoRank social score (0 if unknown) */
+    xscore: number;
+}
+interface SearchAirdropItemTaskSummary {
+    /** Number of currently open tasks */
+    open: number;
+    /** Total number of tasks */
+    total: number;
+    types: unknown;
+}
+interface SearchAirdropItemTasksItem {
+    blockchains?: unknown;
+    /** Task close date as Unix seconds (0 if unknown) */
+    close_date: number;
+    /** Participation cost in USD (0 = free) */
+    cost: number;
+    /** Public participation URL */
+    external_link?: string;
+    /** Whether task is exclusive */
+    is_exclusive: boolean;
+    /** Task open date as Unix seconds (0 if unknown) */
+    open_date: number;
+    /** Task status: OPEN, CLOSED, UPCOMING */
+    status: string;
+    /** Estimated time in minutes */
+    time_minutes: number;
+    /** Task title */
+    title: string;
+    /** Task type: social, testnet, mainnet, staking, trading, etc. */
+    type: string;
+}
+interface SearchAirdropParams {
+    /** Search keyword for coin name */
+    q?: string;
+    /** Comma-separated lifecycle phases. `active` = tasks open, can participate (POTENTIAL + CONFIRMED). `claimable` = eligible, can claim (SNAPSHOT + VERIFICATION + REWARD_AVAILABLE). `completed` = done (DISTRIBUTED). Defaults to `active,claimable` to show actionable airdrops. — @default 'active' */
+    phase?: string;
+    /** Filter by reward type */
+    reward_type?: 'airdrop' | 'points' | 'whitelist' | 'nft' | 'role' | 'ambassador';
+    /** Filter activities containing tasks of this type */
+    task_type?: 'social' | 'bounty-platforms' | 'testnet' | 'mainnet' | 'role' | 'form' | 'liquidity' | 'mint-nft' | 'game' | 'trading' | 'staking' | 'depin' | 'node' | 'ambassador' | 'hold' | 'check-wallet' | 'mint-domain' | 'predictions' | 'deploy';
+    /** Only return activities with currently OPEN tasks — @default 'false' */
+    has_open?: boolean;
+    /** Field to sort results by — @default 'last_status_update' */
+    sort_by?: 'total_raise' | 'xscore' | 'last_status_update';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+    /** Include full task list per activity — @default 'false' */
+    include_tasks?: boolean;
+}
+interface SearchEventsItem {
+    /** Event date in ISO 8601 format */
+    date?: string;
+    /** Detailed event description */
+    description?: string;
+    /** Project logo image URL */
+    logo_url?: string;
+    /** Short event title */
+    title: string;
+    /** Event type — one of: launch, upgrade, partnership, news, airdrop, listing, twitter */
+    type: string;
+}
+interface SearchEventsParams {
+    /** Surf project UUID. PREFERRED — always use this when available from a previous response (e.g. project_id from /fund/portfolio or id from /search/project). Takes priority over q. */
+    id?: string;
+    /** Fuzzy entity name search. Only use when 'id' is not available. May return unexpected results for ambiguous names. */
+    q?: string;
+    /** Filter by event type. Can be `launch`, `upgrade`, `partnership`, `news`, `airdrop`, `listing`, or `twitter`. */
+    type?: 'launch' | 'upgrade' | 'partnership' | 'news' | 'airdrop' | 'listing' | 'twitter';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface SearchFundItem {
+    /** Surf fund UUID — pass as 'id' parameter to /fund/detail or /fund/portfolio for exact lookup */
+    id: string;
+    /** Fund logo URL */
+    image?: string;
+    /** Total number of unique invested projects (a project with multiple funding rounds counts once) */
+    invested_projects_count: number;
+    /** Fund name */
+    name: string;
+    /** Fund tier ranking (lower is better) */
+    tier: number;
+    top_projects: SearchFundItemTopProjectsItem[];
+    /** Fund type */
+    type?: string;
+}
+interface SearchFundItemTopProjectsItem {
+    /** Investment date (Unix seconds) */
+    invested_at?: number;
+    /** Whether this fund was the lead investor */
+    is_lead: boolean;
+    /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics for exact lookup. Prefer over 'q' (fuzzy name search). */
+    project_id: string;
+    /** Project logo URL */
+    project_logo?: string;
+    /** Project name */
+    project_name: string;
+    /** Project slug */
+    project_slug?: string;
+    /** Most recent funding round amount in USD */
+    recent_raise?: number;
+    /** Total amount raised by the project in USD */
+    total_raise?: number;
+}
+interface SearchFundParams {
+    /** Search keyword — fund name like `a16z`, `paradigm`, or `coinbase ventures` */
+    q?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface SearchKalshiItem {
+    /** Event subtitle */
+    event_subtitle?: string;
+    /** Unique event ticker identifier */
+    event_ticker: string;
+    /** Event title */
+    event_title: string;
+    /** Number of markets in this event */
+    market_count: number;
+    markets: SearchKalshiItemMarketsItem[];
+}
+interface SearchKalshiItemMarketsItem {
+    /** Surf curated market category */
+    category?: string;
+    /** Market close time (Unix seconds) */
+    close_time?: number;
+    /** Market end time (Unix seconds) */
+    end_time?: number;
+    /** Parent event ticker */
+    event_ticker: string;
+    /** Event title */
+    event_title?: string;
+    /** Previous day open interest from daily report */
+    last_day_open_interest: number;
+    /** Unique market ticker identifier */
+    market_ticker: string;
+    /** Last day notional trading volume in USD (each contract = $1) */
+    notional_volume_usd: number;
+    /** Open interest (contracts) */
+    open_interest: number;
+    /** Payout type */
+    payout_type: string;
+    /** Market result if resolved */
+    result?: string;
+    /** Market start time (Unix seconds) */
+    start_time?: number;
+    /** Market status */
+    status: string;
+    /** Surf curated market subcategory */
+    subcategory?: string;
+    /** Market title */
+    title: string;
+    /** Total trading volume (contracts) */
+    total_volume: number;
+}
+interface SearchKalshiParams {
+    /** Search keyword matching event title, subtitle, or market title */
+    q?: string;
+    /** Filter by category */
+    category?: 'crypto' | 'culture' | 'economics' | 'financials' | 'politics' | 'stem' | 'sports' | 'unknown';
+    /** Market status filter: `active`, `closed`, `determined`, `disputed`, `finalized`, `inactive`, or `initialized` */
+    status?: 'active' | 'closed' | 'determined' | 'disputed' | 'finalized' | 'inactive' | 'initialized';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface SearchNewsItem {
+    highlights?: SearchNewsItemHighlights;
+    /** Article ID. Use with the detail endpoint to fetch full content. */
+    id: string;
+    /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics for exact lookup */
+    project_id?: string;
+    /** Primary crypto project referenced in the article */
+    project_name?: string;
+    /** Unix timestamp in seconds when the article was published */
+    published_at: number;
+    /** Publisher name (e.g. COINDESK, COINTELEGRAPH) */
+    source?: string;
+    /** Short summary of the article */
+    summary?: string;
+    /** Article headline */
+    title: string;
+    /** Direct URL to the original article */
+    url?: string;
+}
+interface SearchNewsItemHighlights {
+    [key: string]: unknown;
+}
+interface SearchNewsParams {
+    /** Search keyword or phrase */
+    q?: string;
+}
+interface SearchPolymarketItem {
+    /** Surf curated event category */
+    category?: string;
+    /** Event description */
+    description?: string;
+    /** Event end time (Unix seconds) */
+    end_time?: number;
+    /** Event identifier slug */
+    event_slug: string;
+    /** Event image URL */
+    image?: string;
+    /** Number of markets in this event */
+    market_count: number;
+    markets: SearchPolymarketItemMarketsItem[];
+    /** Resolution source URL */
+    settlement_sources?: string;
+    /** Event start time (Unix seconds) */
+    start_time?: number;
+    /** Event status: `open` if any market is open, `closed` if all markets are closed */
+    status: string;
+    /** Surf curated event subcategory */
+    subcategory?: string;
+    tags?: unknown;
+    /** Event title */
+    title: string;
+    /** Total event volume across all markets (USD) */
+    volume_total: number;
+}
+interface SearchPolymarketItemMarketsItem {
+    /** Surf curated market category */
+    category?: string;
+    /** Market close time (Unix seconds) */
+    close_time?: number;
+    /** Resolution time (Unix seconds) */
+    completed_time?: number;
+    /** Unique condition identifier */
+    condition_id: string;
+    /** Market description */
+    description?: string;
+    /** Market end time (Unix seconds) */
+    end_time?: number;
+    /** Event identifier slug */
+    event_slug?: string;
+    /** Game start time for sports markets (Unix seconds) */
+    game_start_time?: number;
+    /** Market image URL */
+    image?: string;
+    /** Market identifier slug */
+    market_slug: string;
+    /** Negative risk market identifier */
+    negative_risk_id?: string;
+    /** Link to Polymarket page */
+    polymarket_link?: string;
+    /** URL to resolution data source */
+    resolution_source?: string;
+    side_a?: SearchPolymarketItemMarketsItemSideA;
+    side_b?: SearchPolymarketItemMarketsItemSideB;
+    /** Market start time (Unix seconds) */
+    start_time?: number;
+    /** Market status: `open` or `closed` */
+    status: string;
+    /** Surf curated market subcategory */
+    subcategory?: string;
+    tags?: unknown;
+    /** Market title */
+    title: string;
+    /** Trading volume in the past month (USD) */
+    volume_1_month: number;
+    /** Trading volume in the past week (USD) */
+    volume_1_week: number;
+    /** Trading volume in the past year (USD) */
+    volume_1_year: number;
+    /** Total trading volume (USD) */
+    volume_total: number;
+    /** Winning outcome label, if resolved */
+    winning_side?: string;
+}
+interface SearchPolymarketItemMarketsItemSideA {
+    /** Token identifier for this outcome */
+    id: string;
+    /** Outcome label */
+    label: string;
+}
+interface SearchPolymarketItemMarketsItemSideB {
+    /** Token identifier for this outcome */
+    id: string;
+    /** Outcome label */
+    label: string;
+}
+interface SearchPolymarketParams {
+    /** Search keyword matching market question, event title, or description */
+    q?: string;
+    /** Comma-separated tag labels to filter by (matches any). Commonly used tags: `Crypto`, `Politics`, `Sports`, `Science`, `Pop Culture` */
+    tags?: string;
+    /** Filter by Surf-curated category */
+    category?: 'crypto' | 'culture' | 'early_polymarket_trades' | 'economics' | 'financials' | 'politics' | 'stem' | 'sports' | 'unknown';
+    /** Market status filter: `active`, `finalized`, `ended`, `initialized`, or `closed` — @default 'active' */
+    status?: 'active' | 'finalized' | 'ended' | 'initialized' | 'closed';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface SearchProjectItem {
+    chains?: unknown;
+    /** Short description of the project */
+    description?: string;
+    /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics for exact lookup. Prefer over 'q' (fuzzy name search). */
+    id: string;
+    /** Project logo image URL */
+    logo_url?: string;
+    /** Project name */
+    name: string;
+    /** Project slug for URL construction */
+    slug?: string;
+    /** Primary token symbol like `BTC` or `ETH` */
+    symbol?: string;
+    tags?: unknown;
+    tokens?: SearchProjectItemTokensItem[];
+}
+interface SearchProjectItemTokensItem {
+    /** Token identifier */
+    id: string;
+    /** Token logo image URL */
+    image?: string;
+    /** Token name */
+    name: string;
+    /** Token symbol */
+    symbol: string;
+}
+interface SearchProjectParams {
+    /** Search keyword — project name or ticker like `uniswap`, `bitcoin`, or `ETH` */
+    q?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface SearchSocialPeopleItem {
+    /** Profile picture URL */
+    avatar?: string;
+    /** Profile biography text */
+    bio?: string;
+    /** Number of followers */
+    followers_count: number;
+    /** Number of accounts this user follows */
+    following_count: number;
+    /** X/Twitter handle without the @ prefix */
+    handle: string;
+    /** Display name on X/Twitter */
+    name: string;
+    /** Numeric X/Twitter user ID as a string */
+    user_id: string;
+}
+interface SearchSocialPeopleParams {
+    /** Search keyword or `@handle` for exact handle lookup. Use a keyword like `vitalik` for fuzzy matching across names and bios, or `@VitalikButerin` to find a specific account by handle */
+    q?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Opaque cursor token from a previous response's next_cursor field for fetching the next page */
+    cursor?: string;
+}
+interface SearchSocialPostsItem {
+    author: SearchSocialPostsItemAuthor;
+    /** Unix timestamp (seconds) when the tweet was posted */
+    created_at: number;
+    media?: SearchSocialPostsItemMediaItem[];
+    stats: SearchSocialPostsItemStats;
+    /** Full text content of the tweet */
+    text: string;
+    /** Numeric tweet ID as a string (e.g. '1234567890123456789') */
+    tweet_id: string;
+    /** Permanent link to the tweet on X/Twitter */
+    url: string;
+}
+interface SearchSocialPostsItemAuthor {
+    /** Profile picture URL */
+    avatar?: string;
+    /** X/Twitter handle without the @ prefix (e.g. 'cz_binance') */
+    handle: string;
+    /** Display name on X/Twitter */
+    name: string;
+    /** Numeric X/Twitter user ID as a string */
+    user_id: string;
+}
+interface SearchSocialPostsItemMediaItem {
+    /** Media type: photo, video, or animated_gif */
+    type: string;
+    /** Direct URL to the media asset */
+    url: string;
+}
+interface SearchSocialPostsItemStats {
+    /** Number of likes (hearts) */
+    likes: number;
+    /** Number of replies */
+    replies: number;
+    /** Number of retweets/reposts */
+    reposts: number;
+    /** Total view count */
+    views: number;
+}
+interface SearchSocialPostsParams {
+    /** Search keyword or `from:handle` syntax like `ethereum` or `from:cz_binance` */
+    q?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Opaque cursor token from a previous response's next_cursor field for fetching the next page */
+    cursor?: string;
+}
+interface SearchWalletItem {
+    /** Primary wallet address for this entity */
+    address?: string;
+    addresses?: SearchWalletItemAddressesItem[];
+    /** Chain of the primary address */
+    chain?: string;
+    /** Name of the associated entity like `Binance` or `Aave` */
+    entity_name?: string;
+    /** Type of entity like `exchange`, `fund`, or `whale` */
+    entity_type?: string;
+    /** Human-readable label for the wallet entity */
+    label?: string;
+    /** Total number of wallet addresses associated with this entity */
+    num_addresses?: number;
+    /** Associated X (Twitter) handle */
+    twitter?: string;
+}
+interface SearchWalletItemAddressesItem {
+    /** Wallet address */
+    address: string;
+    /** Chain name like ethereum, arbitrum_one */
+    chain: string;
+}
+interface SearchWalletParams {
+    /** Search keyword like `binance`, `vitalik.eth`, or `0xd8dA...` */
+    q?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface SearchWebItem {
+    /** Relevant content snippet from the page */
+    content: string;
+    /** Short description or meta description of the page */
+    description: string;
+    /** Page title from the search result */
+    title: string;
+    /** Full URL of the search result page */
+    url: string;
+}
+interface SearchWebParams {
+    /** Search query like `bitcoin price prediction 2026` */
+    q?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+    /** Comma-separated domain filter like `coindesk.com` or `cointelegraph.com` */
+    site?: string;
+}
+interface SocialDetailData {
+    follower_geo?: SocialDetailDataFollowerGeo;
+    /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics. Omitted for direct x_id lookups. */
+    project_id?: string;
+    /** Project name (omitted for direct x_id lookups) */
+    project_name?: string;
+    sentiment?: SocialDetailDataSentiment;
+    smart_followers?: SocialDetailDataSmartFollowers;
+    /** Numeric X (Twitter) account ID */
+    twitter_id: string;
+}
+interface SocialDetailDataFollowerGeo {
+    locations: SocialDetailDataFollowerGeoLocationsItem[];
+    /** Total number of followers across all locations */
+    total_follower_count: number;
+}
+interface SocialDetailDataSentiment {
+    /** Sentiment score from -1 (very negative) to 1 (very positive) */
+    score: unknown;
+    /** Time range for the sentiment analysis like 7d or 30d */
+    time_range: string;
+}
+interface SocialDetailDataSmartFollowers {
+    /** Total number of smart followers */
+    count: number;
+    followers: SocialDetailDataSmartFollowersFollowersItem[];
+}
+interface SocialDetailDataFollowerGeoLocationsItem {
+    /** Number of followers in this location */
+    follower_count: number;
+    /** Geographic location name like a country or region */
+    location: string;
+    /** Percentage of total followers in this location (0-100) */
+    percentage: number;
+}
+interface SocialDetailDataSmartFollowersFollowersItem {
+    /** Profile image URL */
+    avatar: string;
+    /** Human-readable description of the follower's role */
+    description?: string;
+    /** Number of followers this account has */
+    followers_count: number;
+    /** X (Twitter) handle without the @ prefix */
+    handle: string;
+    /** Display name of the follower */
+    name: string;
+    /** Rank position among smart followers (1 = highest) */
+    rank: number;
+    /** Smart follower influence score */
+    score: number;
+    /** Smart follower category tag like VC, KOL, or Developer */
+    tag: string;
+    /** Numeric X (Twitter) user ID */
+    twitter_id: string;
+}
+interface SocialDetailParams {
+    /** Numeric X (Twitter) account ID (takes priority over `q`) */
+    x_id?: string;
+    /** Entity name to resolve like `uniswap`, `ethereum`, or `aave` */
+    q?: string;
+    /** Comma-separated sub-resources to include. Can be `sentiment`, `follower_geo`, or `smart_followers`. — @default 'sentiment' */
+    fields?: string;
+    /** Timeframe for sentiment data. Can be `24h`, `48h`, `7d`, `30d`, `3m`, `6m`, or `1y`. — @default '7d' */
+    time_range?: '24h' | '48h' | '7d' | '30d' | '3m' | '6m' | '1y';
+    /** Max geo locations to return — @default '20' */
+    geo_limit?: number;
+}
+interface SocialMindshareItem {
+    /** Unix timestamp in seconds */
+    timestamp: number;
+    /** Mindshare view count at this timestamp */
+    value: number;
+}
+interface SocialMindshareParams {
+    /** Entity name to resolve like `uniswap`, `ethereum`, or `aave` */
+    q?: string;
+    /** Time aggregation interval. Can be `5m`, `1h`, `1d`, or `7d`. */
+    interval?: '5m' | '1h' | '1d' | '7d';
+    /** Start timestamp. Accepts Unix seconds (1704067200) or date string (2024-01-01) */
+    from?: string;
+    /** End timestamp. Accepts Unix seconds (1706745600) or date string (2024-02-01) */
+    to?: string;
+}
+interface SocialRankingItem {
+    project?: SocialRankingItemProject;
+    /** Rank position in the mindshare leaderboard */
+    rank: number;
+    /** Sentiment polarity: positive or negative */
+    sentiment?: string;
+    /** Weighted sentiment score from -1 (very negative) to 1 (very positive) */
+    sentiment_score?: number;
+    tags?: unknown;
+    token?: SocialRankingItemToken;
+    /** Deprecated: no longer populated. */
+    trending_short_reason?: string;
+    /** Deprecated: no longer populated. */
+    trending_summary?: string;
+    twitter?: SocialRankingItemTwitter;
+}
+interface SocialRankingItemProject {
+    /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics for exact lookup */
+    id: string;
+    /** Project name */
+    name: string;
+    /** URL-friendly project slug */
+    slug?: string;
+}
+interface SocialRankingItemToken {
+    /** Surf token UUID */
+    id?: string;
+    /** Token image URL */
+    image?: string;
+    /** Token name */
+    name: string;
+    /** Token ticker symbol */
+    symbol?: string;
+}
+interface SocialRankingItemTwitter {
+    /** Profile image URL */
+    avatar_url?: string;
+    /** X (Twitter) display name */
+    display_name: string;
+    /** Numeric X (Twitter) user ID */
+    twitter_id: string;
+    /** X (Twitter) handle without the @ prefix */
+    x_handle: string;
+}
+interface SocialRankingParams {
+    /** Pagination offset — @default '0' */
+    offset?: number;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Filter by project category. `l1` = Layer 1, `l2` = Layer 2/scaling, `dex` = DEX/AMM, `derivatives` = perps/options, `cex` = centralized exchange, `gamefi` = gaming, `nft` = NFT collections, `oracle` = oracle, `prediction` = prediction market, `rwa` = real-world assets, `yield` = yield/asset management, `data` = data/analytics, `devtool` = developer tooling, `compliance` = compliance/regtech, `meme` = meme/token launchpad. */
+    tag?: 'l1' | 'l2' | 'dex' | 'derivatives' | 'cex' | 'gamefi' | 'nft' | 'oracle' | 'prediction' | 'rwa' | 'yield' | 'data' | 'devtool' | 'compliance' | 'meme' | '';
+    /** Mindshare ranking timeframe window — @default '7d' */
+    time_range?: '24h' | '48h' | '7d' | '30d';
+    /** Filter by sentiment polarity. Only projects with sufficient tweet data are classified. */
+    sentiment?: 'positive' | 'negative' | '';
+}
+interface SocialSmartFollowersHistoryItem {
+    /** Number of smart followers on this date */
+    count: number;
+    /** Date in YYYY-MM-DD format */
+    date: string;
+}
+interface SocialSmartFollowersHistoryParams {
+    /** Numeric X (Twitter) account ID (takes priority over `q`) */
+    x_id?: string;
+    /** Project name to resolve (e.g. `uniswap`, `ethereum`). Must be a project with a linked X account — personal handles like `VitalikButerin` return 404. Use `x_id` for individual accounts. */
+    q?: string;
+    /** Max data points to return (upstream typically provides ~36 daily points) — @default '36' */
+    limit?: number;
+}
+interface SocialTweetRepliesItem {
+    author: SocialTweetRepliesItemAuthor;
+    /** Unix timestamp (seconds) when the tweet was posted */
+    created_at: number;
+    media?: SocialTweetRepliesItemMediaItem[];
+    stats: SocialTweetRepliesItemStats;
+    /** Full text content of the tweet */
+    text: string;
+    /** Numeric tweet ID as a string (e.g. '1234567890123456789') */
+    tweet_id: string;
+    /** Permanent link to the tweet on X/Twitter */
+    url: string;
+}
+interface SocialTweetRepliesItemAuthor {
+    /** Profile picture URL */
+    avatar?: string;
+    /** X/Twitter handle without the @ prefix (e.g. 'cz_binance') */
+    handle: string;
+    /** Display name on X/Twitter */
+    name: string;
+    /** Numeric X/Twitter user ID as a string */
+    user_id: string;
+}
+interface SocialTweetRepliesItemMediaItem {
+    /** Media type: photo, video, or animated_gif */
+    type: string;
+    /** Direct URL to the media asset */
+    url: string;
+}
+interface SocialTweetRepliesItemStats {
+    /** Number of likes (hearts) */
+    likes: number;
+    /** Number of replies */
+    replies: number;
+    /** Number of retweets/reposts */
+    reposts: number;
+    /** Total view count */
+    views: number;
+}
+interface SocialTweetRepliesParams {
+    /** Tweet ID to get replies for */
+    tweet_id?: string;
+    /** Max results to return — @default '20' */
+    limit?: number;
+    /** Opaque cursor token from a previous response's next_cursor field for fetching the next page */
+    cursor?: string;
+}
+interface SocialTweetsItem {
+    author: SocialTweetsItemAuthor;
+    /** Unix timestamp (seconds) when the tweet was posted */
+    created_at: number;
+    media?: SocialTweetsItemMediaItem[];
+    stats: SocialTweetsItemStats;
+    /** Full text content of the tweet */
+    text: string;
+    /** Numeric tweet ID as a string (e.g. '1234567890123456789') */
+    tweet_id: string;
+    /** Permanent link to the tweet on X/Twitter */
+    url: string;
+}
+interface SocialTweetsItemAuthor {
+    /** Profile picture URL */
+    avatar?: string;
+    /** X/Twitter handle without the @ prefix (e.g. 'cz_binance') */
+    handle: string;
+    /** Display name on X/Twitter */
+    name: string;
+    /** Numeric X/Twitter user ID as a string */
+    user_id: string;
+}
+interface SocialTweetsItemMediaItem {
+    /** Media type: photo, video, or animated_gif */
+    type: string;
+    /** Direct URL to the media asset */
+    url: string;
+}
+interface SocialTweetsItemStats {
+    /** Number of likes (hearts) */
+    likes: number;
+    /** Number of replies */
+    replies: number;
+    /** Number of retweets/reposts */
+    reposts: number;
+    /** Total view count */
+    views: number;
+}
+interface SocialTweetsParams {
+    /** Comma-separated numeric post ID strings, max 100 */
+    ids?: string;
+}
+interface SocialUserData {
+    /** Profile picture URL */
+    avatar?: string;
+    /** Profile biography text */
+    bio?: string;
+    /** Number of followers */
+    followers_count: number;
+    /** Number of accounts this user follows */
+    following_count: number;
+    /** X/Twitter handle without the @ prefix */
+    handle: string;
+    /** Display name on X/Twitter */
+    name: string;
+    /** Numeric X/Twitter user ID as a string */
+    user_id: string;
+}
+interface SocialUserParams {
+    /** X (Twitter) username without @ like `cz_binance` or `vitalikbuterin` */
+    handle?: string;
+}
+interface SocialUserFollowersItem {
+    /** Profile picture URL */
+    avatar?: string;
+    /** Profile biography text */
+    bio?: string;
+    /** Number of followers */
+    followers_count: number;
+    /** Number of accounts this user follows */
+    following_count: number;
+    /** X/Twitter handle without the @ prefix */
+    handle: string;
+    /** Display name on X/Twitter */
+    name: string;
+    /** Numeric X/Twitter user ID as a string */
+    user_id: string;
+}
+interface SocialUserFollowersParams {
+    /** X (Twitter) username without @ like `vitalikbuterin` or `cz_binance` */
+    handle?: string;
+    /** Max results to return — @default '20' */
+    limit?: number;
+    /** Opaque cursor token from a previous response's next_cursor field for fetching the next page */
+    cursor?: string;
+}
+interface SocialUserFollowingItem {
+    /** Profile picture URL */
+    avatar?: string;
+    /** Profile biography text */
+    bio?: string;
+    /** Number of followers */
+    followers_count: number;
+    /** Number of accounts this user follows */
+    following_count: number;
+    /** X/Twitter handle without the @ prefix */
+    handle: string;
+    /** Display name on X/Twitter */
+    name: string;
+    /** Numeric X/Twitter user ID as a string */
+    user_id: string;
+}
+interface SocialUserFollowingParams {
+    /** X (Twitter) username without @ like `vitalikbuterin` or `cz_binance` */
+    handle?: string;
+    /** Max results to return — @default '20' */
+    limit?: number;
+    /** Opaque cursor token from a previous response's next_cursor field for fetching the next page */
+    cursor?: string;
+}
+interface SocialUserPostsItem {
+    author: SocialUserPostsItemAuthor;
+    /** Unix timestamp (seconds) when the tweet was posted */
+    created_at: number;
+    media?: SocialUserPostsItemMediaItem[];
+    stats: SocialUserPostsItemStats;
+    /** Full text content of the tweet */
+    text: string;
+    /** Numeric tweet ID as a string (e.g. '1234567890123456789') */
+    tweet_id: string;
+    /** Permanent link to the tweet on X/Twitter */
+    url: string;
+}
+interface SocialUserPostsItemAuthor {
+    /** Profile picture URL */
+    avatar?: string;
+    /** X/Twitter handle without the @ prefix (e.g. 'cz_binance') */
+    handle: string;
+    /** Display name on X/Twitter */
+    name: string;
+    /** Numeric X/Twitter user ID as a string */
+    user_id: string;
+}
+interface SocialUserPostsItemMediaItem {
+    /** Media type: photo, video, or animated_gif */
+    type: string;
+    /** Direct URL to the media asset */
+    url: string;
+}
+interface SocialUserPostsItemStats {
+    /** Number of likes (hearts) */
+    likes: number;
+    /** Number of replies */
+    replies: number;
+    /** Number of retweets/reposts */
+    reposts: number;
+    /** Total view count */
+    views: number;
+}
+interface SocialUserPostsParams {
+    /** X (Twitter) username without @ like `vitalikbuterin` or `cz_binance` */
+    handle?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Opaque cursor token from a previous response's next_cursor field for fetching the next page */
+    cursor?: string;
+    /** Filter tweets: `all` returns everything, `original` excludes retweets — @default 'all' */
+    filter?: 'all' | 'original';
+}
+interface SocialUserRepliesItem {
+    author: SocialUserRepliesItemAuthor;
+    /** Unix timestamp (seconds) when the tweet was posted */
+    created_at: number;
+    media?: SocialUserRepliesItemMediaItem[];
+    stats: SocialUserRepliesItemStats;
+    /** Full text content of the tweet */
+    text: string;
+    /** Numeric tweet ID as a string (e.g. '1234567890123456789') */
+    tweet_id: string;
+    /** Permanent link to the tweet on X/Twitter */
+    url: string;
+}
+interface SocialUserRepliesItemAuthor {
+    /** Profile picture URL */
+    avatar?: string;
+    /** X/Twitter handle without the @ prefix (e.g. 'cz_binance') */
+    handle: string;
+    /** Display name on X/Twitter */
+    name: string;
+    /** Numeric X/Twitter user ID as a string */
+    user_id: string;
+}
+interface SocialUserRepliesItemMediaItem {
+    /** Media type: photo, video, or animated_gif */
+    type: string;
+    /** Direct URL to the media asset */
+    url: string;
+}
+interface SocialUserRepliesItemStats {
+    /** Number of likes (hearts) */
+    likes: number;
+    /** Number of replies */
+    replies: number;
+    /** Number of retweets/reposts */
+    reposts: number;
+    /** Total view count */
+    views: number;
+}
+interface SocialUserRepliesParams {
+    /** X (Twitter) username without @ like `vitalikbuterin` or `cz_binance` */
+    handle?: string;
+    /** Max results to return — @default '20' */
+    limit?: number;
+    /** Opaque cursor token from a previous response's next_cursor field for fetching the next page */
+    cursor?: string;
+}
+interface TokenDexTradesItem {
+    /** Trade value in USD at execution time */
+    amount_usd: number;
+    /** Unix timestamp in seconds when the trade was executed */
+    block_time: number;
+    /** DEX project name like `uniswap`, `sushiswap`, or `curve` */
+    project: string;
+    /** Wallet address that initiated the swap */
+    taker: string;
+    /** Contract address of the token bought */
+    token_bought_address?: string;
+    /** Amount of tokens bought (decimal-adjusted) */
+    token_bought_amount: number;
+    /** Symbol of the token bought in this trade */
+    token_bought_symbol: string;
+    /** Trading pair symbol like `WETH-USDC` */
+    token_pair: string;
+    /** Contract address of the token sold */
+    token_sold_address?: string;
+    /** Amount of tokens sold (decimal-adjusted) */
+    token_sold_amount: number;
+    /** Symbol of the token sold in this trade */
+    token_sold_symbol: string;
+    /** Transaction hash */
+    tx_hash: string;
+    /** DEX version like `v2` or `v3` */
+    version: string;
+}
+interface TokenDexTradesParams {
+    /** Token contract address (0x-prefixed hex) */
+    address?: string;
+    /** Chain. Can be `ethereum` or `base`. — @default 'ethereum' */
+    chain?: 'ethereum' | 'base';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface TokenHoldersItem {
+    /** Wallet address of the token holder */
+    address: string;
+    /** Token balance (decimal-adjusted, human-readable) */
+    balance: string;
+    /** Name of the associated entity like `Binance` or `Aave` */
+    entity_name?: string;
+    /** Type of entity like `exchange`, `fund`, or `whale` */
+    entity_type?: string;
+    /** Share of total supply held as a percentage (5.2 means 5.2%) */
+    percentage?: number;
+}
+interface TokenHoldersParams {
+    /** Token contract address (0x-prefixed hex or Solana base58) */
+    address?: string;
+    /** Chain. Can be `ethereum`, `polygon`, `bsc`, `solana`, `avalanche`, `arbitrum`, `optimism`, or `base`. */
+    chain?: 'ethereum' | 'polygon' | 'bsc' | 'solana' | 'avalanche' | 'arbitrum' | 'optimism' | 'base';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset (accepted for API consistency but currently ignored) — @default '0' */
+    offset?: number;
+}
+interface TokenTokenomicsItem {
+    allocations?: TokenTokenomicsItemAllocationsItem[];
+    /** Unix timestamp in seconds */
+    timestamp: number;
+    /** Cumulative total tokens unlocked up to this timestamp (decimal-adjusted) */
+    unlock_amount: number;
+}
+interface TokenTokenomicsItemAllocationsItem {
+    /** Decimal-adjusted allocation amount */
+    amount: number;
+    /** Allocation name */
+    name: string;
+}
+interface TokenTokenomicsParams {
+    /** Surf project UUID. PREFERRED — always use this when available from a previous response. Takes priority over symbol. */
+    id?: string;
+    /** Token symbol like `ARB`, `OP`, or `APT` */
+    symbol?: string;
+    /** Start of time range. Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`) */
+    from?: string;
+    /** End of time range. Accepts Unix seconds (`1735689600`) or date string (`2025-01-01`) */
+    to?: string;
+}
+interface TokenTransfersItem {
+    /** Transfer amount (decimal-adjusted, human-readable) */
+    amount: string;
+    /** Transfer value in USD at the time of the transaction. Not available for all transfers. */
+    amount_usd?: number;
+    /** Block number in which this transfer was included */
+    block_number: number;
+    /** Sender wallet address */
+    from_address: string;
+    /** Token symbol like ETH, USDC, or WETH */
+    symbol?: string;
+    /** Unix timestamp in seconds when the transfer occurred */
+    timestamp: number;
+    /** Recipient wallet address */
+    to_address: string;
+    /** Transaction hash */
+    tx_hash: string;
+}
+interface TokenTransfersParams {
+    /** Token contract address (0x-prefixed hex or Solana base58) */
+    address?: string;
+    /** Chain. Can be `ethereum`, `base`, `solana`, or `tron`. */
+    chain?: 'ethereum' | 'base' | 'solana' | 'tron';
+    /** Start of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to 30 days ago. */
+    from?: string;
+    /** End of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to today. */
+    to?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface WalletDetailData {
+    active_chains?: WalletDetailDataActiveChainsItem[];
+    approvals?: WalletDetailDataApprovalsItem[];
+    errors?: WalletDetailDataErrorsItem[];
+    evm_balance?: WalletDetailDataEvmBalance;
+    evm_tokens?: WalletDetailDataEvmTokensItem[];
+    labels?: WalletDetailDataLabels;
+    nft?: WalletDetailDataNftItem[];
+    sol_balance?: WalletDetailDataSolBalance;
+    sol_tokens?: WalletDetailDataSolTokensItem[];
+}
+interface WalletDetailDataActiveChainsItem {
+    /** Canonical chain name like `ethereum` or `polygon` */
+    chain: string;
+    /** EVM chain ID like `1` for Ethereum or `137` for Polygon */
+    chain_id?: number;
+    /** Total USD value of assets on this chain */
+    usd_value: number;
+}
+interface WalletDetailDataApprovalsItem {
+    /** Current token balance */
+    balance: number;
+    /** Canonical chain name */
+    chain: string;
+    /** Full token name */
+    name?: string;
+    spenders: WalletDetailDataApprovalsItemSpendersItem[];
+    /** Token ticker symbol */
+    symbol: string;
+    /** Token contract address */
+    token_address: string;
+}
+interface WalletDetailDataErrorsItem {
+    /** Field name that failed to load like `evm_balance`, `sol_balance`, `evm_tokens`, `sol_tokens`, `labels`, `nft`, `active_chains`, or `approvals` */
+    field: string;
+    /** Error message describing why the field could not be loaded */
+    message: string;
+}
+interface WalletDetailDataEvmBalance {
+    /** Wallet address */
+    address: string;
+    chain_balances?: WalletDetailDataEvmBalanceChainBalancesItem[];
+    /** Total portfolio value in USD (EVM only) */
+    total_usd: number;
+}
+interface WalletDetailDataEvmTokensItem {
+    /** Decimal-adjusted token balance as a string */
+    balance: string;
+    /** Chain name like ethereum, polygon (EVM only) */
+    chain?: string;
+    /** Whether the token is verified (EVM only) */
+    is_verified: boolean;
+    /** Token logo image URL */
+    logo_url?: string;
+    /** Full token name */
+    name?: string;
+    /** Current USD price per token (EVM only) */
+    price: number;
+    /** Token ticker symbol */
+    symbol: string;
+    /** Token contract address (EVM only) */
+    token_address: string;
+    /** Total USD value (balance * price) (EVM only) */
+    usd_value: number;
+}
+interface WalletDetailDataLabels {
+    /** Wallet address */
+    address: string;
+    /** Name of the associated entity like `Binance` or `Aave` */
+    entity_name?: string;
+    /** Type of entity like `exchange`, `fund`, or `whale` */
+    entity_type?: string;
+    labels: WalletDetailDataLabelsLabelsItem[];
+}
+interface WalletDetailDataNftItem {
+    /** Canonical chain name like `ethereum` or `polygon` */
+    chain?: string;
+    /** NFT collection name */
+    collection_name?: string;
+    /** NFT contract address */
+    contract_address: string;
+    /** NFT image or thumbnail URL */
+    image_url?: string;
+    /** NFT item name or title */
+    name?: string;
+    /** NFT token ID within the collection */
+    token_id: string;
+    /** Latest trading price in USD */
+    usd_price?: number;
+}
+interface WalletDetailDataSolBalance {
+    /** Wallet address */
+    address: string;
+    /** Decimal-adjusted native SOL balance as a string (Solana only) */
+    sol_balance: string;
+}
+interface WalletDetailDataSolTokensItem {
+    /** Decimal-adjusted token balance as a string */
+    balance: string;
+    /** Token decimal places (Solana only) */
+    decimals: number;
+    /** Full token name */
+    name?: string;
+    /** Token ticker symbol */
+    symbol: string;
+    /** SPL token mint address (Solana only) */
+    token_address: string;
+}
+interface WalletDetailDataApprovalsItemSpendersItem {
+    /** Approved token amount (use -1 for unlimited) */
+    allowance: number;
+    /** Address of the approved spender contract */
+    spender_address: string;
+    /** Human-readable name of the spender, absent for unrecognized contracts */
+    spender_name?: string;
+}
+interface WalletDetailDataEvmBalanceChainBalancesItem {
+    /** Canonical chain name like `ethereum` or `polygon` */
+    chain: string;
+    /** EVM chain ID like `1` for Ethereum or `137` for Polygon */
+    chain_id?: number;
+    /** Total USD value of assets on this chain */
+    usd_value: number;
+}
+interface WalletDetailDataLabelsLabelsItem {
+    /** Confidence score 0.0-1.0 */
+    confidence?: number;
+    /** Human-readable label for this address like `Binance Hot Wallet` */
+    label: string;
+}
+interface WalletDetailParams {
+    /** Wallet address (0x hex for EVM, base58 for Solana) */
+    address?: string;
+    /** Chain filter for `tokens`, `nft`, and `approvals`. When omitted, inferred from address format: 0x addresses query all EVM chains, base58 addresses query Solana. */
+    chain?: 'ethereum' | 'polygon' | 'bsc' | 'avalanche' | 'arbitrum' | 'optimism' | 'fantom' | 'base' | 'solana';
+    /** Comma-separated sub-resources to include. Valid: `balance`, `tokens`, `labels`, `nft`, `approvals`. The `active_chains` field is always returned. `approvals` is opt-in (not in default) as it triggers additional upstream calls. — @default 'balance' */
+    fields?: string;
+}
+interface WalletHistoryItem {
+    /** Sender wallet address */
+    from_address: string;
+    /** Unix timestamp in seconds when the transaction was confirmed */
+    timestamp: number;
+    /** Recipient wallet address */
+    to_address: string;
+    /** Transaction hash */
+    tx_hash: string;
+    /** Transaction type: `send`, `receive`, `swap`, `approve`, etc. */
+    tx_type?: string;
+    /** Decimal-adjusted transaction value in native token as a string */
+    value: string;
+}
+interface WalletHistoryParams {
+    /** Wallet address — must be a raw 0x-prefixed hex address, not an ENS name */
+    address?: string;
+    /** Chain filter. Can be `ethereum`, `polygon`, `bsc`, `avalanche`, `arbitrum`, `optimism`, `fantom`, or `base`. — @default 'ethereum' */
+    chain?: 'ethereum' | 'polygon' | 'bsc' | 'avalanche' | 'arbitrum' | 'optimism' | 'fantom' | 'base';
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+    /** Field to sort results by — @default 'timestamp' */
+    sort_by?: 'timestamp' | 'value';
+    /** Sort order — @default 'desc' */
+    order?: 'asc' | 'desc';
+}
+interface WalletLabelsBatchItem {
+    /** Wallet address */
+    address: string;
+    /** Name of the associated entity like `Binance` or `Aave` */
+    entity_name?: string;
+    /** Type of entity like `exchange`, `fund`, or `whale` */
+    entity_type?: string;
+    labels: WalletLabelsBatchItemLabelsItem[];
+}
+interface WalletLabelsBatchItemLabelsItem {
+    /** Confidence score 0.0-1.0 */
+    confidence?: number;
+    /** Human-readable label for this address like `Binance Hot Wallet` */
+    label: string;
+}
+interface WalletLabelsBatchParams {
+    /** Comma-separated wallet addresses to look up, max 100 */
+    addresses?: string;
+}
+interface WalletNetWorthItem {
+    /** Unix timestamp in seconds */
+    timestamp: number;
+    /** Total portfolio value in USD at this point in time */
+    usd_value: number;
+}
+interface WalletNetWorthParams {
+    /** Wallet address (0x hex, base58, or ENS name like `vitalik.eth`) */
+    address?: string;
+}
+interface WalletProtocolsItem {
+    /** Canonical chain name where the protocol operates */
+    chain: string;
+    /** Protocol logo image URL */
+    logo_url?: string;
+    positions: WalletProtocolsItemPositionsItem[];
+    /** Human-readable protocol name */
+    protocol_name: string;
+    /** Protocol website URL */
+    site_url?: string;
+    /** Total USD value across all positions in this protocol */
+    total_usd: number;
+}
+interface WalletProtocolsItemPositionsItem {
+    /** Total USD value of this position */
+    balance_usd: number;
+    borrow_tokens?: WalletProtocolsItemPositionsItemBorrowTokensItem[];
+    lp_tokens?: WalletProtocolsItemPositionsItemLpTokensItem[];
+    /** Position name or type like `Lending` or `Staking` */
+    name: string;
+    reward_tokens?: WalletProtocolsItemPositionsItemRewardTokensItem[];
+    supply_tokens?: WalletProtocolsItemPositionsItemSupplyTokensItem[];
+}
+interface WalletProtocolsItemPositionsItemBorrowTokensItem {
+    /** Token amount held in this position */
+    amount: number;
+    /** Canonical chain name like `ethereum` or `polygon` */
+    chain: string;
+    /** Full token name */
+    name?: string;
+    /** Current token price in USD */
+    price: number;
+    /** Token ticker symbol */
+    symbol: string;
+    /** Token contract address */
+    token_address?: string;
+}
+interface WalletProtocolsItemPositionsItemLpTokensItem {
+    /** Token amount held in this position */
+    amount: number;
+    /** Canonical chain name like `ethereum` or `polygon` */
+    chain: string;
+    /** Full token name */
+    name?: string;
+    /** Current token price in USD */
+    price: number;
+    /** Token ticker symbol */
+    symbol: string;
+    /** Token contract address */
+    token_address?: string;
+}
+interface WalletProtocolsItemPositionsItemRewardTokensItem {
+    /** Token amount held in this position */
+    amount: number;
+    /** Canonical chain name like `ethereum` or `polygon` */
+    chain: string;
+    /** Full token name */
+    name?: string;
+    /** Current token price in USD */
+    price: number;
+    /** Token ticker symbol */
+    symbol: string;
+    /** Token contract address */
+    token_address?: string;
+}
+interface WalletProtocolsItemPositionsItemSupplyTokensItem {
+    /** Token amount held in this position */
+    amount: number;
+    /** Canonical chain name like `ethereum` or `polygon` */
+    chain: string;
+    /** Full token name */
+    name?: string;
+    /** Current token price in USD */
+    price: number;
+    /** Token ticker symbol */
+    symbol: string;
+    /** Token contract address */
+    token_address?: string;
+}
+interface WalletProtocolsParams {
+    /** Wallet address — must be a raw 0x-prefixed hex address, not an ENS name */
+    address?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface WalletTransfersItem {
+    /** Transfer activity type (Solana only, e.g. ACTIVITY_SPL_TRANSFER) */
+    activity_type?: string;
+    /** Decimal-adjusted transfer amount as a string */
+    amount: string;
+    /** Transfer value in USD at the time of the transaction */
+    amount_usd?: number;
+    /** Transfer direction relative to the queried wallet: `in` or `out` */
+    flow?: string;
+    /** Sender wallet address */
+    from_address: string;
+    /** Unix timestamp in seconds when the transfer occurred */
+    timestamp: number;
+    /** Recipient wallet address */
+    to_address: string;
+    /** Token contract address (EVM) or SPL mint address (Solana) */
+    token_address?: string;
+    /** Token ticker symbol (available for EVM chains from on-chain data) */
+    token_symbol?: string;
+    /** Transaction hash (EVM) or transaction signature (Solana) */
+    tx_hash: string;
+}
+interface WalletTransfersParams {
+    /** Wallet address — must be a raw address (0x-prefixed hex for EVM, base58 for Solana). ENS names like `vitalik.eth` are not supported; resolve to a 0x address first. */
+    address?: string;
+    /** Chain. Can be `ethereum`, `base`, or `solana`. — @default 'ethereum' */
+    chain?: 'ethereum' | 'base' | 'solana';
+    /** Filter by transfer direction relative to the queried wallet. `in` for incoming, `out` for outgoing. Omit for both directions. */
+    flow?: 'in' | 'out';
+    /** Filter by token contract address. Use `0x0000000000000000000000000000000000000000` for native token transfers. Omit for all tokens. */
+    token?: string;
+    /** Results per page — @default '20' */
+    limit?: number;
+    /** Pagination offset — @default '0' */
+    offset?: number;
+}
+interface WebFetchData {
+    /** Full page content converted to clean markdown text */
+    content: string;
+    /** Page title extracted from the HTML */
+    title?: string;
+    /** The URL that was fetched */
+    url: string;
+}
+interface WebFetchParams {
+    /** URL to fetch and parse */
+    url?: string;
+    /** CSS selector to extract specific content */
+    target_selector?: string;
+    /** CSS selector to remove unwanted elements */
+    remove_selector?: string;
+    /** CSS selector to wait for before extracting */
+    wait_for_selector?: string;
+    /** Request timeout in milliseconds — @default '30000' */
+    timeout?: number;
+}
+
+/** Get order book bid/ask levels with computed stats: spread, spread percentage, mid-price, and total bid/ask depth. Use `limit` to control the number of price levels (1–100, default 20). Set `type=swap` to query perpetual contract order books instead of spot. */
+declare function useExchangeDepth(params?: ExchangeDepthParams): _tanstack_react_query.UseQueryResult<ApiResponse<ExchangeDepthItem>, Error>;
+/** Get historical funding rate records for a perpetual contract. Use `from` to set the start time and `limit` to control result count. For longer history, paginate by using the last returned timestamp as the next `from` value. Note: not all exchanges support historical queries via `from`; some only return recent data regardless. For the latest funding rate snapshot, see `/exchange/perp?fields=funding`. */
+declare function useExchangeFundingHistory(params?: ExchangeFundingHistoryParams): _tanstack_react_query.UseQueryResult<ApiResponse<ExchangeFundingHistoryItem>, Error>;
+/** Get OHLCV candlestick data with period summary stats (high, low, total volume). Supports 15 intervals from `1m` to `1M`. Use `from` to set the start time and `limit` to control how many candles to return. For longer ranges, paginate by using the last returned candle's timestamp as the next `from` value. Exchange-side limits vary (200–1000 per request). Set `type=swap` to query perpetual contract candles instead of spot. */
+declare function useExchangeKlines(params?: ExchangeKlinesParams): _tanstack_react_query.UseQueryResult<ApiResponse<ExchangeKlinesItem>, Error>;
+/** Get historical long/short ratio for a perpetual contract — ratio value, long account percentage, and short account percentage. Use `interval` (`1h`, `4h`, `1d`) for granularity, `from` for start time, and `limit` for result count. For longer history, paginate by using the last returned timestamp as the next `from` value. Note: not all exchanges support historical queries via `from`; some only return recent data regardless. Just pass the base pair (e.g. `pair=BTC/USDT`). For aggregated cross-exchange long/short ratio, see `/market/futures`. */
+declare function useExchangeLongShortRatio(params?: ExchangeLongShortRatioParams): _tanstack_react_query.UseQueryResult<ApiResponse<ExchangeLongShortRatioItem>, Error>;
+/** List trading pairs available on an exchange. Filter by `type` (`spot`, `swap`, `future`, `option`) or free-text `search`. Returns pair name, base/quote currencies, market type, active status, and default fee rates. Use the returned `pair` values as the `pair` parameter in other exchange endpoints. */
+declare function useExchangeMarkets(params?: ExchangeMarketsParams): _tanstack_react_query.UseQueryResult<ApiResponse<ExchangeMarketsItem>, Error>;
+/** Get a combined snapshot of perpetual contract data for a pair. Use `fields` to select which sub-resources to fetch: `funding` (current funding rate, next settlement, mark/index price) and/or `oi` (open interest in contracts and USD). Just pass the base pair (e.g. `pair=BTC/USDT`). The `:USDT` swap suffix is added automatically. */
+declare function useExchangePerp(params?: ExchangePerpParams): _tanstack_react_query.UseQueryResult<ApiObjectResponse<ExchangePerpData>, Error>;
+/** Get the real-time ticker for a trading pair — last price, bid/ask, 24h high/low, 24h volume, and 24h price change. Set `type=swap` to query perpetual contract prices instead of spot. For historical price trends, use `/market/price`. */
+declare function useExchangePrice(params?: ExchangePriceParams): _tanstack_react_query.UseQueryResult<ApiResponse<ExchangePriceItem>, Error>;
+
+/** Get a fund's **profile metadata**: X accounts, team members, recent research, and invested project count. This does NOT return the list of investments — use `/fund/portfolio` for that. Lookup by UUID (`id`) or name (`q`). Returns 404 if not found. */
+declare function useFundDetail(params?: FundDetailParams): _tanstack_react_query.UseQueryResult<ApiObjectResponse<FundDetailData>, Error>;
+/** List investment rounds for a fund's portfolio, sorted by date (newest first). A project may appear multiple times if the fund participated in multiple rounds. Each entry includes project name, logo, date, raise amount, and lead investor status. Lookup by UUID (`id`) or name (`q`). */
+declare function useInfiniteFundPortfolio(params?: Omit<FundPortfolioParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<FundPortfolioItem>, unknown>, Error>;
+/** List top-ranked funds by metric. Available metrics: `tier` (lower is better), `portfolio_count` (number of invested projects). */
+declare function useInfiniteFundRanking(params?: Omit<FundRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<FundRankingItem>, unknown>, Error>;
+
+/** Get Kalshi events with nested markets, optionally filtered by `event_ticker`. Each event includes market count and a list of markets. Data refresh: ~30 minutes */
+declare function useInfiniteKalshiEvents(params?: Omit<KalshiEventsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<KalshiEventsItem>, unknown>, Error>;
+/** Get Kalshi markets, optionally filtered by `market_ticker`. Each market includes price, volume, and status. Data refresh: ~30 minutes */
+declare function useInfiniteKalshiMarkets(params?: Omit<KalshiMarketsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<KalshiMarketsItem>, unknown>, Error>;
+/** Get daily open interest history for a Kalshi market filtered by `time_range`. Data refresh: ~30 minutes */
+declare function useKalshiOpenInterest(params?: KalshiOpenInterestParams): _tanstack_react_query.UseQueryResult<ApiResponse<KalshiOpenInterestItem>, Error>;
+/** Get price history for a Kalshi market. Use `interval=1d` for daily OHLC from market reports (~30 min delay), or `interval=latest` for real-time price from trades. Data refresh: ~30 minutes (daily), real-time (latest) */
+declare function useKalshiPrices(params?: KalshiPricesParams): _tanstack_react_query.UseQueryResult<ApiResponse<KalshiPricesItem>, Error>;
+/** Get top-ranked Kalshi markets by last day's `notional_volume_usd` or `open_interest`. Filter by `status`. Data refresh: ~30 minutes */
+declare function useInfiniteKalshiRanking(params?: Omit<KalshiRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<KalshiRankingItem>, unknown>, Error>;
+/** Get individual trade records for a Kalshi market. Filter by `taker_side`, `min_contracts`, and date range. Sort by `timestamp` or `num_contracts`. Data refresh: real-time */
+declare function useInfiniteKalshiTrades(params?: Omit<KalshiTradesParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<KalshiTradesItem>, unknown>, Error>;
+/** Get daily trading volume history for a Kalshi market filtered by `time_range`. Data refresh: ~30 minutes */
+declare function useKalshiVolumes(params?: KalshiVolumesParams): _tanstack_react_query.UseQueryResult<ApiResponse<KalshiVolumesItem>, Error>;
+
+/** Get daily ETF flow history for US spot ETFs — net flow (USD), token price, and per-ticker breakdown. Sorted by date descending. `symbol`: `BTC` or `ETH`. */
+declare function useMarketEtf(params?: MarketEtfParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketEtfItem>, Error>;
+/** Get Bitcoin Fear & Greed Index history — index value (0-100), classification label, and BTC price at each data point. Sorted newest-first. Use `from`/`to` to filter by date range. */
+declare function useMarketFearGreed(params?: MarketFearGreedParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketFearGreedItem>, Error>;
+/** Get futures market data across all tracked tokens — open interest, funding rate, long/short ratio, and 24h volume. Sort by `sort_by` (default: volume_24h). */
+declare function useMarketFutures(params?: MarketFuturesParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketFuturesItem>, Error>;
+/** Get OHLC-style aggregated liquidation data for a token on a specific exchange. Filter by `symbol`, `exchange`, and `interval`. Useful for charting liquidation volume over time. */
+declare function useMarketLiquidationChart(params?: MarketLiquidationChartParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketLiquidationChartItem>, Error>;
+/** Get liquidation breakdown by exchange — total, long, and short volumes in USD. Filter by `symbol` and `time_range` (`1h`, `4h`, `12h`, `24h`). */
+declare function useMarketLiquidationExchangeList(params?: MarketLiquidationExchangeListParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketLiquidationExchangeListItem>, Error>;
+/** Get individual large liquidation orders above a USD threshold (`min_amount`, default 10000). Filter by `exchange` and `symbol`. For aggregate totals and long/short breakdown by exchange, use `/market/liquidation/exchange-list`. For historical liquidation charts, use `/market/liquidation/chart`. */
+declare function useMarketLiquidationOrder(params?: MarketLiquidationOrderParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketLiquidationOrderItem>, Error>;
+/** Get on-chain indicator time-series for BTC or ETH. Metrics: `nupl`, `sopr`, `mvrv`, `puell-multiple`, `nvm`, `nvt`, `nvt-golden-cross`, `exchange-flows` (inflow/outflow/netflow/reserve). */
+declare function useMarketOnchainIndicator(params?: MarketOnchainIndicatorParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketOnchainIndicatorItem>, Error>;
+/** Get options market data — open interest, volume, put/call ratio, and max pain price for a `symbol`. */
+declare function useMarketOptions(params?: MarketOptionsParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketOptionsItem>, Error>;
+/** Get historical price data points for a token. Use `time_range` for predefined windows (`1d`, `7d`, `14d`, `30d`, `90d`, `180d`, `365d`, `max`) or `from`/`to` for a custom date range (Unix timestamp or YYYY-MM-DD). Granularity is automatic: 5-min for 1d, hourly for 7-90d, daily for 180d+. */
+declare function useMarketPrice(params?: MarketPriceParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketPriceItem>, Error>;
+/** Get a technical indicator for a trading pair on a given exchange and interval. Set `from`/`to` for time-series mode, omit for latest value. Use `options` for indicator-specific tuning (e.g. `period:7`, `fast_period:8,slow_period:21,signal_period:5`, `period:10,stddev:1.5`). Indicators: `rsi`, `macd`, `ema`, `sma`, `bbands`, `stoch`, `adx`, `atr`, `cci`, `obv`, `vwap`, `dmi`, `ichimoku`, `supertrend`. */
+declare function useMarketPriceIndicator(params?: MarketPriceIndicatorParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketPriceIndicatorItem>, Error>;
+/** List tokens ranked by metric. Available metrics: `market_cap`, `top_gainers`, `top_losers`, `volume`. Note: `top_gainers` and `top_losers` rank by 24h price change within the top 250 coins by market cap. For circulating supply, FDV, ATH/ATL, use `/project/detail?fields=token_info`. */
+declare function useInfiniteMarketRanking(params?: Omit<MarketRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<MarketRankingItem>, unknown>, Error>;
+
+/** Returns the full content of a single news article by its ID (returned as `id` in feed and search results). */
+declare function useNewsDetail(params?: NewsDetailParams): _tanstack_react_query.UseQueryResult<ApiObjectResponse<NewsDetailData>, Error>;
+/** Browse crypto news from major sources. Filter by `source` (enum), `project`, and time range (`from`/`to`). Sort by `recency` (default) or `trending`. Use the detail endpoint with article `id` for full content. */
+declare function useInfiniteNewsFeed(params?: Omit<NewsFeedParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<NewsFeedItem>, unknown>, Error>;
+
+/** List bridge protocols ranked by total USD volume over a time range. */
+declare function useInfiniteOnchainBridgeRanking(params?: Omit<OnchainBridgeRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<OnchainBridgeRankingItem>, unknown>, Error>;
+/** Get the current gas price for an EVM chain via `eth_gasPrice` JSON-RPC. Returns gas price in both wei (raw) and Gwei (human-readable). **Supported chains:** `ethereum`, `polygon`, `bsc`, `arbitrum`, `optimism`, `base`, `avalanche`, `fantom`, `linea`, `cyber`. */
+declare function useOnchainGasPrice(params?: OnchainGasPriceParams): _tanstack_react_query.UseQueryResult<ApiObjectResponse<OnchainGasPriceData>, Error>;
+/** Execute a structured JSON query on blockchain data. No raw SQL needed — specify source, fields, filters, sort, and pagination. All tables live in the **agent** database. Use `GET /v1/onchain/schema` to discover available tables and their columns. - Source format: `agent.<table_name>` like `agent.ethereum_transactions` or `agent.ethereum_dex_trades` - Max 10,000 rows (default 20), 30s timeout. - **Always filter on block_date** — it is the partition key. Without it, queries scan billions of rows and will timeout. - **Data refresh:** ~24 hours. */
+declare function useOnchainStructuredQuery(params: OnchainStructuredQueryParams): _tanstack_react_query.UseQueryResult<ApiResponse<OnchainStructuredQueryItem>, Error>;
+/** Get table metadata — database, table, column names, types, and comments for all available on-chain databases. */
+declare function useOnchainSchema(): _tanstack_react_query.UseQueryResult<ApiResponse<OnchainSchemaItem>, Error>;
+/** Execute a raw SQL SELECT query against blockchain data. All tables live in the **agent** database. Use `GET /v1/onchain/schema` to discover available tables and their columns before writing queries. */
+declare function useOnchainSql(params: OnchainSqlParams): _tanstack_react_query.UseQueryResult<ApiResponse<OnchainSqlItem>, Error>;
+/** Get transaction details by hash. All numeric fields are hex-encoded — use parseInt(hex, 16) to convert. **Supported chains:** `ethereum`, `polygon`, `bsc`, `arbitrum`, `optimism`, `base`, `avalanche`, `fantom`, `linea`, `cyber`. Returns 404 if the transaction is not found. */
+declare function useOnchainTx(params?: OnchainTxParams): _tanstack_react_query.UseQueryResult<ApiResponse<OnchainTxItem>, Error>;
+/** List DeFi yield pools ranked by APY or TVL. Returns the latest snapshot. Filter by protocol. */
+declare function useInfiniteOnchainYieldRanking(params?: Omit<OnchainYieldRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<OnchainYieldRankingItem>, unknown>, Error>;
+
+/** Get trade and redemption activity for a Polymarket wallet. Data refresh: ~30 minutes */
+declare function useInfinitePolymarketActivity(params?: Omit<PolymarketActivityParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PolymarketActivityItem>, unknown>, Error>;
+/** Get Polymarket events with nested markets, optionally filtered by `event_slug`. Each event includes aggregated status, volume, and a list of markets with `side_a`/`side_b` outcomes. Data refresh: ~30 minutes */
+declare function useInfinitePolymarketEvents(params?: Omit<PolymarketEventsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PolymarketEventsItem>, unknown>, Error>;
+/** Get Polymarket markets, optionally filtered by `market_slug`. Each market includes `side_a` and `side_b` outcomes. Current prices are available via `/polymarket/prices` using the `condition_id`. Data refresh: ~30 minutes */
+declare function useInfinitePolymarketMarkets(params?: Omit<PolymarketMarketsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PolymarketMarketsItem>, unknown>, Error>;
+/** Get daily open interest history for a Polymarket market. Data refresh: ~30 minutes */
+declare function usePolymarketOpenInterest(params?: PolymarketOpenInterestParams): _tanstack_react_query.UseQueryResult<ApiResponse<PolymarketOpenInterestItem>, Error>;
+/** Get wallet positions on Polymarket markets. Data refresh: ~30 minutes */
+declare function useInfinitePolymarketPositions(params?: Omit<PolymarketPositionsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PolymarketPositionsItem>, unknown>, Error>;
+/** Get aggregated price history for a Polymarket market. Use `interval=latest` for the most recent price snapshot. Data refresh: ~30 minutes */
+declare function usePolymarketPrices(params?: PolymarketPricesParams): _tanstack_react_query.UseQueryResult<ApiResponse<PolymarketPricesItem>, Error>;
+/** Get top-ranked Polymarket markets by `volume_24h`, `volume_7d`, `open_interest`, or `trade_count`. Filter by `status` and `end_before`. Data refresh: ~30 minutes */
+declare function useInfinitePolymarketRanking(params?: Omit<PolymarketRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PolymarketRankingItem>, unknown>, Error>;
+/** Get paginated trade records for a Polymarket market or wallet. Filter by `condition_id` (market) or `address` (wallet), plus `outcome_label`, `min_amount`, and date range. At least one of `condition_id` or `address` is required. Sort by `newest`, `oldest`, or `largest`. Data refresh: ~30 minutes */
+declare function useInfinitePolymarketTrades(params?: Omit<PolymarketTradesParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PolymarketTradesItem>, unknown>, Error>;
+/** Get trading volume and trade count history for a Polymarket market. Data refresh: ~30 minutes */
+declare function usePolymarketVolumes(params?: PolymarketVolumesParams): _tanstack_react_query.UseQueryResult<ApiResponse<PolymarketVolumesItem>, Error>;
+
+/** Get daily notional volume and open interest aggregated by category across Kalshi and Polymarket. Filter by `source` or `category`. Data refresh: daily */
+declare function useInfinitePredictionMarketCategoryMetrics(params?: Omit<PredictionMarketCategoryMetricsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PredictionMarketCategoryMetricsItem>, unknown>, Error>;
+
+/** Get time-series DeFi metrics for a project. Available metrics: `volume`, `fee`, `fees`, `revenue`, `tvl`, `users`. Lookup by UUID (`id`) or name (`q`). Filter by `chain` and date range (`from`/`to`). Returns 404 if the project is not found. **Note:** this endpoint only returns data for DeFi protocol projects (e.g. `aave`, `uniswap`, `lido`, `makerdao`). Use `q` with a DeFi protocol name. */
+declare function useInfiniteProjectDefiMetrics(params?: Omit<ProjectDefiMetricsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<ProjectDefiMetricsItem>, unknown>, Error>;
+/** Get top DeFi projects ranked by a protocol metric. Available metrics: `tvl`, `revenue`, `fees`, `volume`, `users`. */
+declare function useInfiniteProjectDefiRanking(params?: Omit<ProjectDefiRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<ProjectDefiRankingItem>, unknown>, Error>;
+/** Get multiple project sub-resources in a single request. Use `fields` to select: `overview`, `token_info`, `tokenomics`, `funding`, `team`, `contracts`, `social`, `tge_status`. **Accepts project names directly** via `q` (e.g. `?q=aave`) — no need to call `/search/project` first. Also accepts UUID via `id`. Returns 404 if not found. For DeFi metrics (TVL, fees, revenue, volume, users) and per-chain breakdown, use `/project/defi/metrics`. */
+declare function useProjectDetail(params?: ProjectDetailParams): _tanstack_react_query.UseQueryResult<ApiObjectResponse<ProjectDetailData>, Error>;
+
+/** Search and filter airdrop opportunities by keyword, status, reward type, and task type. Returns paginated results with optional task details. */
+declare function useInfiniteSearchAirdrop(params?: Omit<SearchAirdropParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchAirdropItem>, unknown>, Error>;
+/** Search project events by keyword, optionally filtered by `type`. Valid types: `launch`, `upgrade`, `partnership`, `news`, `airdrop`, `listing`, `twitter`. Lookup by UUID (`id`) or name (`q`). Returns 404 if the project is not found. */
+declare function useInfiniteSearchEvents(params?: Omit<SearchEventsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchEventsItem>, unknown>, Error>;
+/** Search funds by keyword. Returns matching funds with name, tier, type, logo, and top invested projects. */
+declare function useInfiniteSearchFund(params?: Omit<SearchFundParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchFundItem>, unknown>, Error>;
+/** Search Kalshi events by keyword and/or category. Filter by keyword matching event title, subtitle, or market title; or by category. At least one of `q` or `category` is required. Returns events with nested markets. Data refresh: ~30 minutes */
+declare function useInfiniteSearchKalshi(params?: Omit<SearchKalshiParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchKalshiItem>, unknown>, Error>;
+/** Search crypto news articles by keyword. Returns top 10 results ranked by relevance with highlighted matching fragments. */
+declare function useSearchNews(params?: SearchNewsParams): _tanstack_react_query.UseQueryResult<ApiResponse<SearchNewsItem>, Error>;
+/** Search Polymarket events by keyword, tags, and/or category. Filter by keyword matching market question, event title, or description; by comma-separated tag labels; or by Surf-curated category. At least one of `q`, `tags`, or `category` is required. Returns events with nested markets ranked by volume. Data refresh: ~30 minutes */
+declare function useInfiniteSearchPolymarket(params?: Omit<SearchPolymarketParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchPolymarketItem>, unknown>, Error>;
+/** Search crypto projects by keyword. Returns matching projects with name, description, chains, and logo. */
+declare function useInfiniteSearchProject(params?: Omit<SearchProjectParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchProjectItem>, unknown>, Error>;
+/** Search X (Twitter) users by keyword. Returns user profiles with handle, display name, bio, follower count, and avatar. */
+declare function useInfiniteSearchSocialPeople(params?: Omit<SearchSocialPeopleParams, 'cursor'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiCursorResponse<SearchSocialPeopleItem>, unknown>, Error>;
+/** Search X (Twitter) posts by keyword or `from:handle` syntax. Returns posts with author, content, engagement metrics, and timestamp. To load more results, check `meta.has_more`; if true, pass `meta.next_cursor` as the `cursor` query parameter in the next request. */
+declare function useInfiniteSearchSocialPosts(params?: Omit<SearchSocialPostsParams, 'cursor'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiCursorResponse<SearchSocialPostsItem>, unknown>, Error>;
+/** Search wallets by ENS name, address label, or address prefix. Returns matching wallet addresses with entity labels. */
+declare function useInfiniteSearchWallet(params?: Omit<SearchWalletParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchWalletItem>, unknown>, Error>;
+/** Search web pages, articles, and content by keyword. Filter by domain with `site` like `coindesk.com`. Returns titles, URLs, and content snippets. */
+declare function useInfiniteSearchWeb(params?: Omit<SearchWebParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchWebItem>, unknown>, Error>;
+
+/** Get a **point-in-time snapshot** of social analytics: sentiment score, follower geo breakdown, and top smart followers. Use `fields` to select: `sentiment`, `follower_geo`, `smart_followers`. Lookup by X account ID (`x_id`) or project name (`q`, e.g. `uniswap`, `solana`). The `q` parameter must be a crypto project name, not a personal Twitter handle. Returns 404 if the project has no linked Twitter account. For sentiment **trends over time**, use `/social/mindshare` instead. */
+declare function useSocialDetail(params?: SocialDetailParams): _tanstack_react_query.UseQueryResult<ApiObjectResponse<SocialDetailData>, Error>;
+/** Get mindshare (social view count) **time-series trend** for a project, aggregated by `interval`. Use this when the user asks about sentiment **trends**, mindshare **over time**, or social momentum changes. `interval` can be `5m`, `1h`, `1d`, or `7d`. Filter by date range with `from`/`to` (Unix seconds). Lookup by name (`q`). For a **point-in-time snapshot** of social analytics (sentiment score, follower geo, smart followers), use `/social/detail` instead. */
+declare function useSocialMindshare(params?: SocialMindshareParams): _tanstack_react_query.UseQueryResult<ApiResponse<SocialMindshareItem>, Error>;
+/** Get top crypto projects ranked by mindshare (social view count), sourced directly from Argus real-time data (refreshed every 5 minutes). Filter by `tag` to scope to a category (e.g. `dex`, `l1`, `meme`). Use `time_range` (`24h`, `48h`, `7d`, `30d`) to control the ranking window. Supports `limit`/`offset` pagination. */
+declare function useInfiniteSocialRanking(params?: Omit<SocialRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SocialRankingItem>, unknown>, Error>;
+/** Get smart follower count time-series for a project, sorted by date descending. Lookup by X account ID (`x_id`) or project name (`q`). The `q` parameter must be a project name (e.g. `uniswap`, `ethereum`), not a personal X handle — use `x_id` for individual accounts. Returns 404 if the project has no linked X account. */
+declare function useSocialSmartFollowersHistory(params?: SocialSmartFollowersHistoryParams): _tanstack_react_query.UseQueryResult<ApiResponse<SocialSmartFollowersHistoryItem>, Error>;
+/** Returns replies/comments on a specific tweet. Lookup by `tweet_id`. */
+declare function useInfiniteSocialTweetReplies(params?: Omit<SocialTweetRepliesParams, 'cursor'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiCursorResponse<SocialTweetRepliesItem>, unknown>, Error>;
+/** Get X (Twitter) posts by numeric post ID strings. Pass up to 100 comma-separated IDs via the `ids` query parameter. */
+declare function useSocialTweets(params?: SocialTweetsParams): _tanstack_react_query.UseQueryResult<ApiResponse<SocialTweetsItem>, Error>;
+/** Get an X (Twitter) user profile — display name, follower count, following count, and bio. Lookup by `handle` (without @). */
+declare function useSocialUser(params?: SocialUserParams): _tanstack_react_query.UseQueryResult<ApiObjectResponse<SocialUserData>, Error>;
+/** Returns a list of followers for the specified handle on X (Twitter). Lookup by `handle` (without @). */
+declare function useInfiniteSocialUserFollowers(params?: Omit<SocialUserFollowersParams, 'cursor'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiCursorResponse<SocialUserFollowersItem>, unknown>, Error>;
+/** Returns a list of users that the specified handle follows on X (Twitter). Lookup by `handle` (without @). */
+declare function useInfiniteSocialUserFollowing(params?: Omit<SocialUserFollowingParams, 'cursor'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiCursorResponse<SocialUserFollowingItem>, unknown>, Error>;
+/** Get recent X (Twitter) posts by a specific user, ordered by recency. Lookup by `handle` (without @). Use `filter=original` to exclude retweets. To load more results, check `meta.has_more`; if true, pass `meta.next_cursor` as the `cursor` query parameter in the next request. */
+declare function useInfiniteSocialUserPosts(params?: Omit<SocialUserPostsParams, 'cursor'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiCursorResponse<SocialUserPostsItem>, unknown>, Error>;
+/** Returns recent replies by the specified handle on X (Twitter). Lookup by `handle` (without @). */
+declare function useInfiniteSocialUserReplies(params?: Omit<SocialUserRepliesParams, 'cursor'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiCursorResponse<SocialUserRepliesItem>, unknown>, Error>;
+
+/** Get recent DEX swap events for a token contract address. Covers DEXes like `uniswap`, `sushiswap`, `curve`, and `balancer` on `ethereum` and `base`. Returns trading pair, amounts, USD value, and taker address. Data refresh: ~24 hours · Chain: Ethereum, Base */
+declare function useInfiniteTokenDexTrades(params?: Omit<TokenDexTradesParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<TokenDexTradesItem>, unknown>, Error>;
+/** Get top token holders for a contract address — wallet address, balance, and percentage. Lookup by `address` and `chain`. Supports EVM chains and Solana. */
+declare function useInfiniteTokenHolders(params?: Omit<TokenHoldersParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<TokenHoldersItem>, unknown>, Error>;
+/** Get token unlock time-series — unlock events with amounts and allocation breakdowns. Lookup by project UUID (`id`) or token `symbol`. Filter by date range with `from`/`to`. Defaults to the current calendar month when omitted. Returns 404 if no token found. */
+declare function useTokenTokenomics(params?: TokenTokenomicsParams): _tanstack_react_query.UseQueryResult<ApiResponse<TokenTokenomicsItem>, Error>;
+/** Get recent transfer events **for a specific token** (ERC-20/TRC-20 contract). Pass the **token contract address** in `address` — returns every on-chain transfer of that token regardless of sender/receiver. Each record includes sender, receiver, raw amount, and block timestamp. Use this to analyze a token's on-chain activity (e.g. large movements, distribution patterns). Lookup: `address` (token contract) + `chain`. Sort by `asc` or `desc`. Data refresh: ~24 hours · Chain: Ethereum, Base, TRON (Solana uses a different source with no delay) */
+declare function useInfiniteTokenTransfers(params?: Omit<TokenTransfersParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<TokenTransfersItem>, unknown>, Error>;
+
+/** Get multiple wallet sub-resources in a single request. Lookup by `address`. Use `fields` to select: `balance`, `tokens`, `labels`, `nft`. Partial failures return available fields with per-field error info. Returns 422 if `fields` is invalid. */
+declare function useWalletDetail(params?: WalletDetailParams): _tanstack_react_query.UseQueryResult<ApiObjectResponse<WalletDetailData>, Error>;
+/** Get full transaction history for a wallet — swaps, transfers, and contract interactions. Lookup by `address`. Filter by `chain` — supports `ethereum`, `polygon`, `bsc`, `arbitrum`, `optimism`, `avalanche`, `fantom`, `base`. */
+declare function useInfiniteWalletHistory(params?: Omit<WalletHistoryParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<WalletHistoryItem>, unknown>, Error>;
+/** Get entity labels for multiple wallet addresses. Pass up to 100 comma-separated addresses via the `addresses` query parameter. Returns entity name, type, and labels per address. */
+declare function useWalletLabelsBatch(params?: WalletLabelsBatchParams): _tanstack_react_query.UseQueryResult<ApiResponse<WalletLabelsBatchItem>, Error>;
+/** Get a time-series of the wallet's total net worth in USD. Returns ~288 data points at 5-minute intervals covering the last 24 hours. Fixed window — no custom time range supported. */
+declare function useWalletNetWorth(params?: WalletNetWorthParams): _tanstack_react_query.UseQueryResult<ApiResponse<WalletNetWorthItem>, Error>;
+/** Get all DeFi protocol positions for a wallet — lending, staking, LP, and farming with token breakdowns and USD values. Lookup by `address`. */
+declare function useInfiniteWalletProtocols(params?: Omit<WalletProtocolsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<WalletProtocolsItem>, unknown>, Error>;
+/** Get recent token transfers **sent or received by a wallet**. Pass the **wallet address** in `address` — returns all ERC-20/SPL token transfers where this wallet is the sender or receiver. Each record includes token contract, counterparty, raw amount, and block timestamp. Use this to audit a wallet's token flow (e.g. inflows, outflows, airdrop receipts). Lookup: `address` (wallet, raw 0x hex or base58 — ENS not supported). Filter by `chain` — supports `ethereum`, `base`, `solana`. Data refresh: ~24 hours · Chain: Ethereum, Base (Solana uses a different source with no delay) */
+declare function useInfiniteWalletTransfers(params?: Omit<WalletTransfersParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<WalletTransfersItem>, unknown>, Error>;
+
+/** Fetch a web page and convert it to clean, LLM-friendly markdown. Use `target_selector` to extract specific page sections and `remove_selector` to strip unwanted elements. Returns 400 if the URL is invalid or unreachable. */
+declare function useWebFetch(params?: WebFetchParams): _tanstack_react_query.UseQueryResult<ApiObjectResponse<WebFetchData>, Error>;
+
+export { type ApiCursorResponse, type ApiObjectResponse, type ApiResponse, type CursorMeta, type ExchangeDepthItem, type ExchangeDepthItemAsksItem, type ExchangeDepthItemBidsItem, type ExchangeDepthParams, type ExchangeFundingHistoryItem, type ExchangeFundingHistoryParams, type ExchangeKlinesItem, type ExchangeKlinesItemCandlesItem, type ExchangeKlinesParams, type ExchangeLongShortRatioItem, type ExchangeLongShortRatioParams, type ExchangeMarketsItem, type ExchangeMarketsParams, type ExchangePerpData, type ExchangePerpDataFunding, type ExchangePerpDataOpenInterest, type ExchangePerpParams, type ExchangePriceItem, type ExchangePriceParams, type FundDetailData, type FundDetailDataLinksItem, type FundDetailDataMembersItem, type FundDetailDataRecentResearchesItem, type FundDetailDataXAccountsItem, type FundDetailParams, type FundPortfolioItem, type FundPortfolioParams, type FundRankingItem, type FundRankingItemTopProjectsItem, type FundRankingParams, type KalshiEventsItem, type KalshiEventsItemMarketsItem, type KalshiEventsParams, type KalshiMarketsItem, type KalshiMarketsParams, type KalshiOpenInterestItem, type KalshiOpenInterestParams, type KalshiPricesItem, type KalshiPricesItemSideA, type KalshiPricesItemSideB, type KalshiPricesParams, type KalshiRankingItem, type KalshiRankingParams, type KalshiTradesItem, type KalshiTradesParams, type KalshiVolumesItem, type KalshiVolumesParams, type MarketEtfItem, type MarketEtfItemEtfsItem, type MarketEtfParams, type MarketFearGreedItem, type MarketFearGreedParams, type MarketFuturesItem, type MarketFuturesParams, type MarketLiquidationChartItem, type MarketLiquidationChartParams, type MarketLiquidationExchangeListItem, type MarketLiquidationExchangeListParams, type MarketLiquidationOrderItem, type MarketLiquidationOrderParams, type MarketOnchainIndicatorItem, type MarketOnchainIndicatorParams, type MarketOptionsItem, type MarketOptionsParams, type MarketPriceIndicatorItem, type MarketPriceIndicatorItemValues, type MarketPriceIndicatorParams, type MarketPriceItem, type MarketPriceParams, type MarketRankingItem, type MarketRankingParams, type NewsDetailData, type NewsDetailParams, type NewsFeedItem, type NewsFeedItemHighlights, type NewsFeedParams, type OnchainBridgeRankingItem, type OnchainBridgeRankingParams, type OnchainGasPriceData, type OnchainGasPriceParams, type OnchainSchemaItem, type OnchainSchemaItemColumnsItem, type OnchainSqlItem, type OnchainSqlParams, type OnchainStructuredQueryItem, type OnchainStructuredQueryParams, type OnchainStructuredQueryParamsFiltersItem, type OnchainStructuredQueryParamsSortItem, type OnchainTxItem, type OnchainTxItemAccesslistItem, type OnchainTxParams, type OnchainYieldRankingItem, type OnchainYieldRankingParams, type PolymarketActivityItem, type PolymarketActivityParams, type PolymarketEventsItem, type PolymarketEventsItemMarketsItem, type PolymarketEventsItemMarketsItemSideA, type PolymarketEventsItemMarketsItemSideB, type PolymarketEventsParams, type PolymarketMarketsItem, type PolymarketMarketsItemSideA, type PolymarketMarketsItemSideB, type PolymarketMarketsParams, type PolymarketOpenInterestItem, type PolymarketOpenInterestParams, type PolymarketPositionsItem, type PolymarketPositionsParams, type PolymarketPricesItem, type PolymarketPricesItemSideA, type PolymarketPricesItemSideB, type PolymarketPricesParams, type PolymarketRankingItem, type PolymarketRankingParams, type PolymarketTradesItem, type PolymarketTradesParams, type PolymarketVolumesItem, type PolymarketVolumesParams, type PredictionMarketCategoryMetricsItem, type PredictionMarketCategoryMetricsParams, type ProjectDefiMetricsItem, type ProjectDefiMetricsParams, type ProjectDefiRankingItem, type ProjectDefiRankingParams, type ProjectDetailData, type ProjectDetailDataContracts, type ProjectDetailDataContractsContractsItem, type ProjectDetailDataFunding, type ProjectDetailDataFundingRoundsItem, type ProjectDetailDataFundingRoundsItemInvestorsItem, type ProjectDetailDataOverview, type ProjectDetailDataSocial, type ProjectDetailDataSocialDiscord, type ProjectDetailDataSocialGithub, type ProjectDetailDataSocialTelegram, type ProjectDetailDataSocialTwitter, type ProjectDetailDataTeam, type ProjectDetailDataTeamMembersItem, type ProjectDetailDataTeamMembersItemSocialLinks, type ProjectDetailDataTgeStatus, type ProjectDetailDataTokenInfo, type ProjectDetailDataTokenomics, type ProjectDetailParams, type ResponseMeta, type SearchAirdropItem, type SearchAirdropItemTaskSummary, type SearchAirdropItemTasksItem, type SearchAirdropParams, type SearchEventsItem, type SearchEventsParams, type SearchFundItem, type SearchFundItemTopProjectsItem, type SearchFundParams, type SearchKalshiItem, type SearchKalshiItemMarketsItem, type SearchKalshiParams, type SearchNewsItem, type SearchNewsItemHighlights, type SearchNewsParams, type SearchPolymarketItem, type SearchPolymarketItemMarketsItem, type SearchPolymarketItemMarketsItemSideA, type SearchPolymarketItemMarketsItemSideB, type SearchPolymarketParams, type SearchProjectItem, type SearchProjectItemTokensItem, type SearchProjectParams, type SearchSocialPeopleItem, type SearchSocialPeopleParams, type SearchSocialPostsItem, type SearchSocialPostsItemAuthor, type SearchSocialPostsItemMediaItem, type SearchSocialPostsItemStats, type SearchSocialPostsParams, type SearchWalletItem, type SearchWalletItemAddressesItem, type SearchWalletParams, type SearchWebItem, type SearchWebParams, type SocialDetailData, type SocialDetailDataFollowerGeo, type SocialDetailDataFollowerGeoLocationsItem, type SocialDetailDataSentiment, type SocialDetailDataSmartFollowers, type SocialDetailDataSmartFollowersFollowersItem, type SocialDetailParams, type SocialMindshareItem, type SocialMindshareParams, type SocialRankingItem, type SocialRankingItemProject, type SocialRankingItemToken, type SocialRankingItemTwitter, type SocialRankingParams, type SocialSmartFollowersHistoryItem, type SocialSmartFollowersHistoryParams, type SocialTweetRepliesItem, type SocialTweetRepliesItemAuthor, type SocialTweetRepliesItemMediaItem, type SocialTweetRepliesItemStats, type SocialTweetRepliesParams, type SocialTweetsItem, type SocialTweetsItemAuthor, type SocialTweetsItemMediaItem, type SocialTweetsItemStats, type SocialTweetsParams, type SocialUserData, type SocialUserFollowersItem, type SocialUserFollowersParams, type SocialUserFollowingItem, type SocialUserFollowingParams, type SocialUserParams, type SocialUserPostsItem, type SocialUserPostsItemAuthor, type SocialUserPostsItemMediaItem, type SocialUserPostsItemStats, type SocialUserPostsParams, type SocialUserRepliesItem, type SocialUserRepliesItemAuthor, type SocialUserRepliesItemMediaItem, type SocialUserRepliesItemStats, type SocialUserRepliesParams, type TokenDexTradesItem, type TokenDexTradesParams, type TokenHoldersItem, type TokenHoldersParams, type TokenTokenomicsItem, type TokenTokenomicsItemAllocationsItem, type TokenTokenomicsParams, type TokenTransfersItem, type TokenTransfersParams, type WalletDetailData, type WalletDetailDataActiveChainsItem, type WalletDetailDataApprovalsItem, type WalletDetailDataApprovalsItemSpendersItem, type WalletDetailDataErrorsItem, type WalletDetailDataEvmBalance, type WalletDetailDataEvmBalanceChainBalancesItem, type WalletDetailDataEvmTokensItem, type WalletDetailDataLabels, type WalletDetailDataLabelsLabelsItem, type WalletDetailDataNftItem, type WalletDetailDataSolBalance, type WalletDetailDataSolTokensItem, type WalletDetailParams, type WalletHistoryItem, type WalletHistoryParams, type WalletLabelsBatchItem, type WalletLabelsBatchItemLabelsItem, type WalletLabelsBatchParams, type WalletNetWorthItem, type WalletNetWorthParams, type WalletProtocolsItem, type WalletProtocolsItemPositionsItem, type WalletProtocolsItemPositionsItemBorrowTokensItem, type WalletProtocolsItemPositionsItemLpTokensItem, type WalletProtocolsItemPositionsItemRewardTokensItem, type WalletProtocolsItemPositionsItemSupplyTokensItem, type WalletProtocolsParams, type WalletTransfersItem, type WalletTransfersParams, type WebFetchData, type WebFetchParams, cn, toast, useExchangeDepth, useExchangeFundingHistory, useExchangeKlines, useExchangeLongShortRatio, useExchangeMarkets, useExchangePerp, useExchangePrice, useFundDetail, useInfiniteFundPortfolio, useInfiniteFundRanking, useInfiniteKalshiEvents, useInfiniteKalshiMarkets, useInfiniteKalshiRanking, useInfiniteKalshiTrades, useInfiniteMarketRanking, useInfiniteNewsFeed, useInfiniteOnchainBridgeRanking, useInfiniteOnchainYieldRanking, useInfinitePolymarketActivity, useInfinitePolymarketEvents, useInfinitePolymarketMarkets, useInfinitePolymarketPositions, useInfinitePolymarketRanking, useInfinitePolymarketTrades, useInfinitePredictionMarketCategoryMetrics, useInfiniteProjectDefiMetrics, useInfiniteProjectDefiRanking, useInfiniteSearchAirdrop, useInfiniteSearchEvents, useInfiniteSearchFund, useInfiniteSearchKalshi, useInfiniteSearchPolymarket, useInfiniteSearchProject, useInfiniteSearchSocialPeople, useInfiniteSearchSocialPosts, useInfiniteSearchWallet, useInfiniteSearchWeb, useInfiniteSocialRanking, useInfiniteSocialTweetReplies, useInfiniteSocialUserFollowers, useInfiniteSocialUserFollowing, useInfiniteSocialUserPosts, useInfiniteSocialUserReplies, useInfiniteTokenDexTrades, useInfiniteTokenHolders, useInfiniteTokenTransfers, useInfiniteWalletHistory, useInfiniteWalletProtocols, useInfiniteWalletTransfers, useKalshiOpenInterest, useKalshiPrices, useKalshiVolumes, useMarketEtf, useMarketFearGreed, useMarketFutures, useMarketLiquidationChart, useMarketLiquidationExchangeList, useMarketLiquidationOrder, useMarketOnchainIndicator, useMarketOptions, useMarketPrice, useMarketPriceIndicator, useNewsDetail, useOnchainGasPrice, useOnchainSchema, useOnchainSql, useOnchainStructuredQuery, useOnchainTx, usePolymarketOpenInterest, usePolymarketPrices, usePolymarketVolumes, useProjectDetail, useSearchNews, useSocialDetail, useSocialMindshare, useSocialSmartFollowersHistory, useSocialTweets, useSocialUser, useToast, useTokenTokenomics, useWalletDetail, useWalletLabelsBatch, useWalletNetWorth, useWebFetch };