@surf-ai/sdk 0.1.6-beta → 1.0.0-alpha.1

package/dist/react/index.d.ts

@@ -1,3650 +0,0 @@
-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: number;
-    /** Sell orders, price ascending */
-    asks: ExchangeDepthItemAsksItem[];
-    /** Total bid-side depth in base currency units */
-    bid_depth: number;
-    /** Buy orders, price descending */
-    bids: ExchangeDepthItemBidsItem[];
-    /** Exchange identifier */
-    exchange: string;
-    /** (best_bid + best_ask) / 2 */
-    mid_price: number;
-    /** Trading pair like BTC/USDT */
-    pair: string;
-    /** Best ask - best bid */
-    spread: number;
-    /** Spread as percent of mid price */
-    spread_pct: number;
-}
-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: number;
-    /** Perpetual contract pair like BTC/USDT */
-    pair: string;
-    /** Unix timestamp in seconds */
-    timestamp: number;
-}
-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 {
-    /** OHLCV candles */
-    candles: ExchangeKlinesItemCandlesItem[];
-    /** Number of candles */
-    count: number;
-    /** Exchange identifier */
-    exchange: string;
-    /** Candle interval */
-    interval: string;
-    /** Trading pair */
-    pair: string;
-    /** Last candle datetime */
-    period_end: string;
-    /** Highest price in period */
-    period_high: number;
-    /** Lowest price in period */
-    period_low: number;
-    /** First candle datetime */
-    period_start: string;
-    /** Total volume in period */
-    period_volume: number;
-}
-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: number;
-    /** 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: number;
-    /** Perpetual contract pair like BTC/USDT */
-    pair: string;
-    /** Unix timestamp in seconds */
-    timestamp: number;
-}
-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 'bitget' */
-    exchange?: 'binance' | 'okx' | 'bybit' | 'bitget';
-}
-interface ExchangeMarketsItem {
-    /** Whether the market is active */
-    active: boolean;
-    /** Base currency */
-    base: string;
-    /** Exchange identifier */
-    exchange: string;
-    /** Default maker fee rate */
-    maker_fee: number;
-    /** Trading pair like BTC/USDT */
-    pair: string;
-    /** Quote currency */
-    quote: string;
-    /** Default taker fee rate */
-    taker_fee: number;
-    /** Market type: spot, swap, future, option */
-    type: string;
-}
-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: number;
-    /** Index price derived from the weighted average of spot prices across multiple exchanges */
-    index_price: number;
-    /** Funding interval like 8h */
-    interval: string;
-    /** Mark price calculated by the exchange from the index price and funding rate, used as the reference for liquidations */
-    mark_price: number;
-    /** Next settlement time ISO8601 */
-    next_funding: string;
-    /** Perpetual contract pair like BTC/USDT */
-    pair: string;
-}
-interface ExchangePerpDataOpenInterest {
-    /** Exchange identifier */
-    exchange: string;
-    /** Open interest in contracts */
-    open_interest_amount: number;
-    /** Open interest in USD */
-    open_interest_usd: number;
-    /** Trading pair like BTC/USDT */
-    pair: string;
-    /** Unix timestamp in seconds */
-    timestamp: number;
-}
-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,oi' */
-    fields?: string;
-    /** Exchange identifier — @default 'binance' */
-    exchange?: 'binance' | 'okx' | 'bybit' | 'bitget' | 'htx' | 'bitfinex' | 'bitmex';
-}
-interface ExchangePriceItem {
-    /** Best ask price */
-    ask: number;
-    /** Best bid price */
-    bid: number;
-    /** Price change percentage in 24h */
-    change_24h_pct: number;
-    /** Exchange identifier like binance, okx */
-    exchange: string;
-    /** 24h high price */
-    high_24h: number;
-    /** Last traded price */
-    last: number;
-    /** 24h low price */
-    low_24h: number;
-    /** Trading pair like BTC/USDT */
-    pair: string;
-    /** Unix timestamp in seconds */
-    timestamp: number;
-    /** 24h trading volume in base currency units */
-    volume_24h_base: number;
-}
-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;
-    /** Fund links (website, social, etc.) */
-    links: FundDetailDataLinksItem[];
-    /** Fund team members */
-    members: FundDetailDataMembersItem[];
-    /** Fund name */
-    name: string;
-    /** Recent research publications */
-    recent_researches: FundDetailDataRecentResearchesItem[];
-    /** Fund tier ranking (lower is better) */
-    tier: number;
-    /** Fund type like `VC` or `Accelerator` */
-    type?: string;
-    /** X (Twitter) accounts */
-    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;
-    /** Member roles */
-    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 invested projects (up to 5) */
-    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 {
-    /** Flow breakdown by individual ETF ticker */
-    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 {
-    /** Search highlight fragments with <em> tags around matching terms. Only present in search results. */
-    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 {
-}
-interface OnchainStructuredQueryParams {
-    /** Columns to return. Omit to return all columns. Example for agent.ethereum_transactions: [`transaction_hash`, `from_address`, `value`] */
-    fields?: unknown;
-    /** WHERE conditions (ANDed together) */
-    filters?: OnchainStructuredQueryParamsFiltersItem[];
-    /** Max rows to return. Default 20, max 10000 */
-    limit?: number;
-    /** Rows to skip for pagination. Default 0 */
-    offset?: number;
-    /** ORDER BY clauses */
-    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;
-    /** Comparison value. Use a JSON array for `in`/`not_in` operators like `[21000000, 21000001]` */
-    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 {
-    /** List of columns in this table */
-    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 {
-}
-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 {
-    /** List of addresses and storage keys. Empty array for legacy; populated for EIP-2930+ */
-    accessList: OnchainTxItemAccesslistItem[];
-    /** Versioned hashes of blob commitments. EIP-4844 only */
-    blobVersionedHashes?: unknown;
-    /** Block hash, null if pending */
-    blockHash: string;
-    /** Block number (hex), null if pending */
-    blockNumber: string;
-    /** 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: string;
-    /** Index in block (hex), null if pending */
-    transactionIndex: string;
-    /** 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;
-    /** List of storage slot keys (0x-prefixed hex) */
-    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';
-    /** Maximum rows to return — @default '200' */
-    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 within this event */
-    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 MatchingMarketDailyItem {
-    /** Kalshi open interest (contracts) */
-    kalshi_oi_contracts: number;
-    /** Kalshi daily volume (contracts) */
-    kalshi_volume_contracts: number;
-    /** Polymarket open interest (USD) */
-    polymarket_oi_usd: number;
-    /** Polymarket daily volume (USD) */
-    polymarket_volume_usd: number;
-    /** Unix timestamp (midnight UTC) */
-    timestamp: number;
-}
-interface MatchingMarketDailyParams {
-    /** Polymarket condition ID */
-    polymarket_condition_id: string;
-    /** Kalshi market ticker */
-    kalshi_market_ticker: string;
-    /** Time range — @default '30d' */
-    time_range?: '1d' | '7d' | '30d' | '90d' | '180d' | '1y' | 'all';
-    /** Maximum rows — @default '200' */
-    limit?: number;
-    /** Pagination offset — @default '0' */
-    offset?: number;
-}
-interface MatchingMarketFindItem {
-    /** Market category */
-    category: string;
-    /** Match confidence score (75-100) */
-    confidence: number;
-    kalshi: MatchingMarketFindItemKalshi;
-    /** Match type: exact or related */
-    match_type: string;
-    polymarket: MatchingMarketFindItemPolymarket;
-}
-interface MatchingMarketFindItemKalshi {
-    /** Kalshi event ticker */
-    event_ticker: string;
-    /** Kalshi market ticker */
-    market_ticker: string;
-    /** Open interest in contracts */
-    open_interest: number;
-    /** Market status */
-    status: string;
-    /** Market title */
-    title: string;
-    /** Total volume in contracts */
-    volume_contracts: number;
-}
-interface MatchingMarketFindItemPolymarket {
-    /** Polymarket condition identifier */
-    condition_id: string;
-    /** Event slug identifier */
-    event_slug: string;
-    /** Whether the market is currently active */
-    is_active: boolean;
-    /** Market question text */
-    question: string;
-    /** Total trading volume (USD) */
-    volume_usd: number;
-}
-interface MatchingMarketFindParams {
-    /** Polymarket condition ID to find match for */
-    polymarket_condition_id?: string;
-    /** Kalshi market ticker to find match for */
-    kalshi_market_ticker?: string;
-    /** Maximum rows to return — @default '20' */
-    limit?: number;
-    /** Pagination offset — @default '0' */
-    offset?: number;
-}
-interface MatchingMarketPairsItem {
-    /** Market category */
-    category: string;
-    /** Match confidence score (75-100) */
-    confidence: number;
-    kalshi: MatchingMarketPairsItemKalshi;
-    /** Match type: exact or related */
-    match_type: string;
-    polymarket: MatchingMarketPairsItemPolymarket;
-}
-interface MatchingMarketPairsItemKalshi {
-    /** Kalshi event ticker */
-    event_ticker: string;
-    /** Kalshi market ticker */
-    market_ticker: string;
-    /** Open interest in contracts */
-    open_interest: number;
-    /** Market status */
-    status: string;
-    /** Market title */
-    title: string;
-    /** Total volume in contracts */
-    volume_contracts: number;
-}
-interface MatchingMarketPairsItemPolymarket {
-    /** Polymarket condition identifier */
-    condition_id: string;
-    /** Event slug identifier */
-    event_slug: string;
-    /** Whether the market is currently active */
-    is_active: boolean;
-    /** Market question text */
-    question: string;
-    /** Total trading volume (USD) */
-    volume_usd: number;
-}
-interface MatchingMarketPairsParams {
-    /** Filter by category */
-    category?: 'crypto' | 'culture' | 'economics' | 'financials' | 'politics' | 'stem' | 'sports';
-    /** Filter by match type */
-    match_type?: 'exact' | 'related';
-    /** Only return pairs where both markets are currently active — @default 'False' */
-    active_only?: boolean;
-    /** Minimum confidence score (0-100) — @default '0' */
-    min_confidence?: number;
-    /** Sort field — @default 'confidence' */
-    sort_by?: 'confidence' | 'polymarket_volume' | 'kalshi_volume';
-    /** Sort order — @default 'desc' */
-    order?: 'asc' | 'desc';
-    /** Maximum rows to return — @default '20' */
-    limit?: number;
-    /** Pagination offset — @default '0' */
-    offset?: number;
-}
-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 within this event */
-    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;
-    /** Event tags */
-    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;
-    /** Market tags */
-    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;
-    /** Market tags */
-    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;
-    /** Market tags */
-    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 {
-    /** List of deployed smart contract addresses across chains */
-    contracts?: ProjectDetailDataContractsContractsItem[];
-}
-interface ProjectDetailDataFunding {
-    /** List of individual funding rounds */
-    rounds?: ProjectDetailDataFundingRoundsItem[];
-    /** Total capital raised across all rounds in USD */
-    total_raise?: number;
-}
-interface ProjectDetailDataOverview {
-    /** Chains the project is deployed on */
-    chains?: unknown;
-    /** Short description of the project */
-    description?: string;
-    /** Exchange names where the token is listed */
-    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;
-    /** Project category tags like `DeFi`, `NFT`, or `Layer2` */
-    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 {
-    /** List of team members with their roles and social links */
-    members?: ProjectDetailDataTeamMembersItem[];
-}
-interface ProjectDetailDataTgeStatus {
-    /** TGE status: `pre`, `upcoming`, or `post`. Omitted when unknown. */
-    current_status?: string;
-    /** Exchange names where the token is listed */
-    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 participating in this round */
-    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 profile links keyed by platform name like `twitter` or `linkedin` */
-    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,token_info,tokenomics,funding,team,contracts,social,tge_status' */
-    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;
-    /** Full task list (only with include_tasks=true) */
-    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;
-    /** Distinct task types */
-    types: unknown;
-}
-interface SearchAirdropItemTasksItem {
-    /** Supported blockchain names */
-    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,claimable' */
-    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 invested projects (up to 5) */
-    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 within this event */
-    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 {
-    /** Search highlight fragments with <em> tags around matching terms. Only present in search results. */
-    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 within this event */
-    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;
-    /** Event tags */
-    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;
-    /** Market tags */
-    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 the project operates on */
-    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;
-    /** Project category tags */
-    tags?: unknown;
-    /** Associated tokens */
-    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;
-    /** Attached media items (photos, videos, GIFs) */
-    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;
-    /** Known wallet addresses for this entity (max 10, use num_addresses for the total count) */
-    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 {
-    /** Follower count breakdown by geographic location */
-    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: number;
-    /** Time range for the sentiment analysis like 7d or 30d */
-    time_range: string;
-}
-interface SocialDetailDataSmartFollowers {
-    /** Total number of smart followers */
-    count: number;
-    /** List of top smart followers sorted by influence score */
-    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,follower_geo,smart_followers' */
-    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;
-    /** Project category tags */
-    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;
-    /** Attached media items (photos, videos, GIFs) */
-    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;
-    /** Attached media items (photos, videos, GIFs) */
-    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;
-    /** Attached media items (photos, videos, GIFs) */
-    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;
-    /** Attached media items (photos, videos, GIFs) */
-    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 {
-    /** Breakdown by allocation */
-    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 {
-    /** Chains the wallet has non-zero balances on. Always present (not controlled by fields param). For Solana addresses, returns a single entry. */
-    active_chains?: WalletDetailDataActiveChainsItem[];
-    /** Token approvals (EVM-only, up to 50). Only present when `approvals` is included in the `fields` param. */
-    approvals?: WalletDetailDataApprovalsItem[];
-    /** Per-field errors for any fields that failed to load */
-    errors?: WalletDetailDataErrorsItem[];
-    evm_balance?: WalletDetailDataEvmBalance;
-    /** EVM token holdings (up to 50). Populated for EVM chains only. */
-    evm_tokens?: WalletDetailDataEvmTokensItem[];
-    labels?: WalletDetailDataLabels;
-    /** NFT holdings (EVM-only, top 200 by value) */
-    nft?: WalletDetailDataNftItem[];
-    sol_balance?: WalletDetailDataSolBalance;
-    /** Solana SPL token holdings from Solscan (up to 50). Populated for Solana chain only. */
-    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;
-    /** List of approved spender contracts */
-    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;
-    /** Per-chain balance breakdown, sorted by value descending (EVM only) */
-    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;
-    /** List of labels assigned to this address */
-    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,tokens,labels,nft' */
-    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;
-    /** List of labels assigned to this address */
-    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;
-    /** Individual positions held in this protocol */
-    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;
-    /** Tokens borrowed in this position */
-    borrow_tokens?: WalletProtocolsItemPositionsItemBorrowTokensItem[];
-    /** LP tokens in this position */
-    lp_tokens?: WalletProtocolsItemPositionsItemLpTokensItem[];
-    /** Position name or type like `Lending` or `Staking` */
-    name: string;
-    /** Unclaimed reward tokens in this position */
-    reward_tokens?: WalletProtocolsItemPositionsItemRewardTokensItem[];
-    /** Tokens supplied/deposited in this position */
-    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;
-}
-interface V2KalshiOrderbooksItem {
-}
-interface V2KalshiOrderbooksParams {
-    /** Kalshi market ticker */
-    ticker: string;
-    /** Start time in Unix milliseconds. 0 means 7 days ago. */
-    start_time?: number;
-    /** End time in Unix milliseconds. 0 means current time. */
-    end_time?: number;
-    /** Maximum number of snapshots to return — @default '100' */
-    limit?: number;
-    /** Base64 cursor for pagination */
-    pagination_key?: string;
-}
-interface V2PolymarketCandlesticksItem {
-}
-interface V2PolymarketCandlesticksParams {
-    /** Start time (Unix seconds). 0 means no lower bound. */
-    start_time?: number;
-    /** End time (Unix seconds). 0 means current time. */
-    end_time?: number;
-    /** Candle interval in minutes: 1=1min, 60=1hour, 1440=1day — @default '60' */
-    interval?: number;
-}
-interface V2PolymarketVolumeTimeseriesItem {
-}
-interface V2PolymarketVolumeTimeseriesParams {
-    /** Time granularity for aggregation — @default 'day' */
-    granularity?: 'day' | 'week' | 'month' | 'year' | 'all';
-    /** Start time (Unix seconds). 0 means no lower bound. */
-    start_time?: number;
-    /** End time (Unix seconds). 0 means current time. */
-    end_time?: number;
-}
-interface V2PolymarketOrderbooksItem {
-}
-interface V2PolymarketOrderbooksParams {
-    /** Token identifier */
-    token_id: string;
-    /** Start time in Unix milliseconds. 0 means 7 days ago. */
-    start_time?: number;
-    /** End time in Unix milliseconds. 0 means current time. */
-    end_time?: number;
-    /** Maximum number of snapshots to return — @default '100' */
-    limit?: number;
-    /** Base64 cursor for pagination */
-    pagination_key?: string;
-}
-interface V2PolymarketVolumeChartItem {
-}
-interface V2PolymarketVolumeChartParams {
-    /** Time granularity for volume aggregation — @default 'hour' */
-    granularity?: 'hour' | 'day' | 'week';
-    /** Start time (Unix seconds). 0 means no lower bound. */
-    start_time?: number;
-    /** End time (Unix seconds). 0 means current time. */
-    end_time?: number;
-}
-
-/** Returns order book bid/ask levels with computed stats. **Included fields:** 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>;
-/** Returns historical funding rate records for a perpetual contract. **Pagination:** use `from` to set the start time and `limit` to control result count. For longer history, pass 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>;
-/** Returns OHLCV candlestick data with period summary stats (high, low, total volume). **Intervals:** 15 options from `1m` to `1M`. **Pagination:** use `from` to set the start time and `limit` to control candle count. For longer ranges, pass 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>;
-/** Returns historical long/short ratio for a perpetual contract. **Included fields:** ratio value, long account percentage, short account percentage. **Granularity:** `interval` supports `1h`, `4h`, `1d`. **Pagination:** use `from` for start time and `limit` for result count. For longer history, pass 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>;
-/** Returns trading pairs available on an exchange. **Filters:** `type` (`spot`, `swap`, `future`, `option`) or free-text `search`. **Included fields:** 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>;
-/** Returns a combined snapshot of perpetual contract data for a pair. **Available fields** (via `fields`): - `funding` — current funding rate, next settlement, mark/index price - `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>;
-/** Returns the real-time ticker for a trading pair. **Included fields:** last price, bid/ask, 24h high/low, 24h volume, 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>;
-
-/** Returns a fund's **profile metadata**. **Included fields:** X accounts, team members, recent research, 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>;
-/** Returns 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. **Included fields:** project name, logo, date, raise amount, 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>;
-/** Returns top-ranked funds by a specified 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>;
-
-/** Returns 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>;
-/** Returns 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>;
-/** Returns daily open interest history for a Kalshi market, filtered by `time_range`. **Data refresh:** ~30 minutes */
-declare function useInfiniteKalshiOpenInterest(params: Omit<KalshiOpenInterestParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<KalshiOpenInterestItem>, unknown>, Error>;
-/** Returns price history for a Kalshi market. **Interval options:** - `interval=1d` — daily OHLC from market reports (~30 min delay) - `interval=latest` — real-time price from trades **Data refresh:** ~30 minutes (daily), real-time (latest) */
-declare function useInfiniteKalshiPrices(params: Omit<KalshiPricesParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<KalshiPricesItem>, unknown>, Error>;
-/** Returns top-ranked Kalshi markets by last day's `notional_volume_usd` or `open_interest`. **Filters:** `status`. **Data refresh:** ~30 minutes */
-declare function useInfiniteKalshiRanking(params?: Omit<KalshiRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<KalshiRankingItem>, unknown>, Error>;
-/** Returns individual trade records for a Kalshi market. **Filters:** `taker_side`, `min_contracts`, and date range. **Sort:** `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>;
-/** Returns daily trading volume history for a Kalshi market, filtered by `time_range`. **Data refresh:** ~30 minutes */
-declare function useInfiniteKalshiVolumes(params: Omit<KalshiVolumesParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<KalshiVolumesItem>, unknown>, Error>;
-
-/** Returns daily ETF flow history for US spot ETFs. **Included fields:** net flow (USD), token price, per-ticker breakdown. Sorted by date descending. `symbol`: `BTC` or `ETH`. */
-declare function useMarketEtf(params: MarketEtfParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketEtfItem>, Error>;
-/** Returns Bitcoin Fear & Greed Index history. **Included fields:** index value (0-100), classification label, 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>;
-/** Returns futures market data across all tracked tokens. **Included fields:** open interest, funding rate, long/short ratio, 24h volume. Sorted by `volume_24h` by default — use `sort_by` to change. */
-declare function useMarketFutures(params?: MarketFuturesParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketFuturesItem>, Error>;
-/** Returns OHLC-style aggregated liquidation data for a token on a specific exchange. **Filters:** `symbol`, `exchange`, `interval`. Useful for charting liquidation volume over time. */
-declare function useMarketLiquidationChart(params: MarketLiquidationChartParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketLiquidationChartItem>, Error>;
-/** Returns liquidation breakdown by exchange. **Included fields:** total, long, and short volumes in USD. **Filters:** `symbol` and `time_range` (`1h`, `4h`, `12h`, `24h`). */
-declare function useMarketLiquidationExchangeList(params?: MarketLiquidationExchangeListParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketLiquidationExchangeListItem>, Error>;
-/** Returns individual large liquidation orders above a USD threshold (`min_amount`, default 10000). **Filters:** `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>;
-/** Returns on-chain indicator time-series for BTC or ETH. **Available 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>;
-/** Returns options market data for a `symbol`. **Included fields:** open interest, volume, put/call ratio, max pain price. */
-declare function useMarketOptions(params: MarketOptionsParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketOptionsItem>, Error>;
-/** Returns historical price data points for a token over a specified time range. **Time range options:** - Predefined: `1d`, `7d`, `14d`, `30d`, `90d`, `180d`, `365d`, `max` - Custom: use `from` / `to` (Unix seconds or `YYYY-MM-DD`) **Granularity** is automatic based on range: - `1d` → 5-minute intervals - `7d`–`90d` → hourly - `180d`+ → daily */
-declare function useMarketPrice(params: MarketPriceParams): _tanstack_react_query.UseQueryResult<ApiResponse<MarketPriceItem>, Error>;
-/** Returns a technical indicator for a trading pair on a given exchange and interval. **Modes:** - Set `from`/`to` for time-series - Omit for latest value only **Indicator-specific tuning** via `options` (e.g. `period:7`, `fast_period:8,slow_period:21,signal_period:5`, `period:10,stddev:1.5`). **Available 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>;
-/** Returns tokens ranked by a specified 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 daily volume and open interest comparison for a specific matched market pair. Both `polymarket_condition_id` and `kalshi_market_ticker` are required. **Volume units:** Polymarket = USD, Kalshi = contracts. */
-declare function useInfiniteMatchingMarketDaily(params: Omit<MatchingMarketDailyParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<MatchingMarketDailyItem>, unknown>, Error>;
-/** Given a Polymarket condition_id or Kalshi market_ticker, find the corresponding match on the other platform. Provide at least one of `polymarket_condition_id` or `kalshi_market_ticker`. When both are provided, results are filtered to pairs matching both (useful for verifying a specific pair). */
-declare function useInfiniteMatchingMarketFind(params?: Omit<MatchingMarketFindParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<MatchingMarketFindItem>, unknown>, Error>;
-/** Returns one-to-one matched market pairs between Polymarket and Kalshi. Each pair maps a Polymarket condition_id to a Kalshi market_ticker with a confidence score. **Volume units differ:** Polymarket = USD, Kalshi = contracts ($1 binary options). **Data refresh:** seed-driven, updated periodically. */
-declare function useInfiniteMatchingMarketPairs(params?: Omit<MatchingMarketPairsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<MatchingMarketPairsItem>, 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>;
-/** Returns crypto news from major sources. **Filters:** `source` (enum), `project`, and time range (`from`/`to`). **Sort:** `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>;
-
-/** Returns bridge protocols ranked by total USD volume over a specified time range. */
-declare function useInfiniteOnchainBridgeRanking(params?: Omit<OnchainBridgeRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<OnchainBridgeRankingItem>, unknown>, Error>;
-/** Returns the current gas price for an EVM chain via `eth_gasPrice` JSON-RPC. **Included fields:** 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>;
-/** Executes 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. **Key rules:** - **Source format:** `agent.<table_name>` (e.g. `agent.ethereum_transactions`, `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. ## Example ```json { "source": "agent.ethereum_dex_trades", "fields": ["block_time", "project", "token_pair", "amount_usd", "taker"], "filters": [ {"field": "block_date", "op": "gte", "value": "2025-03-01"}, {"field": "project", "op": "eq", "value": "uniswap"}, {"field": "amount_usd", "op": "gte", "value": 100000} ], "sort": [{"field": "amount_usd", "order": "desc"}], "limit": 20 } ``` */
-declare function useInfiniteOnchainStructuredQuery(params: Omit<OnchainStructuredQueryParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<OnchainStructuredQueryItem>, unknown>, Error>;
-/** Returns table metadata for all available on-chain databases. **Included fields:** database name, table name, column names, types, and comments. */
-declare function useInfiniteOnchainSchema(): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<OnchainSchemaItem>, unknown>, Error>;
-/** Executes 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. ## Rules - Only SELECT/WITH statements allowed (read-only) - All table references must be database-qualified: `agent.<table_name>` - Max 10,000 rows (default 1,000), 30s timeout - **Always filter on block_date or block_number** — partition key, without it queries will timeout - Avoid `SELECT *` on large tables — specify only the columns you need **Data refresh:** ~24 hours. ## Example ```sql SELECT block_time, token_pair, amount_usd, taker, tx_hash FROM agent.ethereum_dex_trades WHERE block_date >= today() - 7 AND project = 'uniswap' AND amount_usd > 100000 ORDER BY amount_usd DESC LIMIT 20 ``` */
-declare function useInfiniteOnchainSql(params: Omit<OnchainSqlParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<OnchainSqlItem>, unknown>, Error>;
-/** Returns 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 useInfiniteOnchainTx(params: Omit<OnchainTxParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<OnchainTxItem>, unknown>, Error>;
-/** Returns 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>;
-
-/** Returns 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>;
-/** Returns 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>;
-/** Returns 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>;
-/** Returns daily open interest history for a Polymarket market. **Data refresh:** ~30 minutes */
-declare function useInfinitePolymarketOpenInterest(params: Omit<PolymarketOpenInterestParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PolymarketOpenInterestItem>, unknown>, Error>;
-/** Returns 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>;
-/** Returns aggregated price history for a Polymarket market. Use `interval=latest` for the most recent price snapshot. **Data refresh:** ~30 minutes */
-declare function useInfinitePolymarketPrices(params: Omit<PolymarketPricesParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PolymarketPricesItem>, unknown>, Error>;
-/** Returns top-ranked Polymarket markets. **Sort by:** `volume_24h`, `volume_7d`, `open_interest`, or `trade_count`. **Filters:** `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>;
-/** Returns paginated trade records for a Polymarket market or wallet. **Filters:** `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:** `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>;
-/** Returns trading volume and trade count history for a Polymarket market. **Data refresh:** ~30 minutes */
-declare function useInfinitePolymarketVolumes(params: Omit<PolymarketVolumesParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<PolymarketVolumesItem>, unknown>, Error>;
-
-/** Returns daily notional volume and open interest aggregated by category across Kalshi and Polymarket. **Filters:** `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>;
-
-/** Returns 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>;
-/** Returns 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>;
-/** Returns multiple project sub-resources in a single request. **Available fields** (via `fields`): `overview`, `token_info`, `tokenomics`, `funding`, `team`, `contracts`, `social`, `tge_status`. **Lookup:** 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>;
-
-/** Searches and filters airdrop opportunities. **Filters:** keyword, status, reward type, 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>;
-/** Searches 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>;
-/** Searches funds by keyword. **Included fields:** name, tier, type, logo, top invested projects. */
-declare function useInfiniteSearchFund(params: Omit<SearchFundParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchFundItem>, unknown>, Error>;
-/** Searches Kalshi events by keyword and/or category. **Filters:** - Keyword matching event title, subtitle, or market title - 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>;
-/** Searches crypto news articles by keyword. Returns top 10 results ranked by relevance with highlighted matching fragments. */
-declare function useInfiniteSearchNews(params: Omit<SearchNewsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchNewsItem>, unknown>, Error>;
-/** Searches Polymarket events by keyword, tags, and/or category. **Filters:** - Keyword matching market question, event title, or description - Comma-separated tag labels - 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>;
-/** Searches crypto projects by keyword. **Included fields:** name, description, chains, logo. */
-declare function useInfiniteSearchProject(params: Omit<SearchProjectParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchProjectItem>, unknown>, Error>;
-/** Searches X (Twitter) users by keyword. **Included fields:** handle, display name, bio, follower count, avatar. */
-declare function useInfiniteSearchSocialPeople(params: Omit<SearchSocialPeopleParams, 'cursor'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiCursorResponse<SearchSocialPeopleItem>, unknown>, Error>;
-/** Searches X (Twitter) posts by keyword or `from:handle` syntax. **Included fields:** author, content, engagement metrics, timestamp. **Pagination:** 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>;
-/** Searches 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>;
-/** Searches web pages, articles, and content by keyword. **Filters:** domain via `site` (e.g. `coindesk.com`). **Included fields:** titles, URLs, content snippets. */
-declare function useInfiniteSearchWeb(params: Omit<SearchWebParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SearchWebItem>, unknown>, Error>;
-
-/** Returns a **point-in-time snapshot** of social analytics for a project. **Available fields** (via `fields`): `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>;
-/** Returns mindshare (social view count) **time-series trend** for a project, aggregated by `interval`. **Intervals:** `5m`, `1h`, `1d`, `7d`. **Filters:** date range with `from`/`to` (Unix seconds). Lookup by name (`q`). Use this for sentiment **trends**, mindshare **over time**, or social momentum changes. For a **point-in-time snapshot** of social analytics (sentiment score, follower geo, smart followers), use `/social/detail` instead. */
-declare function useInfiniteSocialMindshare(params: Omit<SocialMindshareParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SocialMindshareItem>, unknown>, Error>;
-/** Returns top crypto projects ranked by mindshare (social view count), refreshed every 5 minutes. **Filters:** - `tag` — scope to a category (e.g. `dex`, `l1`, `meme`) - `time_range` — ranking window (`24h`, `48h`, `7d`, `30d`) Supports `limit`/`offset` pagination. */
-declare function useInfiniteSocialRanking(params?: Omit<SocialRankingParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SocialRankingItem>, unknown>, Error>;
-/** Returns 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 useInfiniteSocialSmartFollowersHistory(params?: Omit<SocialSmartFollowersHistoryParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SocialSmartFollowersHistoryItem>, unknown>, 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>;
-/** Returns X (Twitter) posts by numeric post ID strings. Pass up to 100 comma-separated IDs via the `ids` query parameter. */
-declare function useInfiniteSocialTweets(params: Omit<SocialTweetsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<SocialTweetsItem>, unknown>, Error>;
-/** Returns an X (Twitter) user profile. **Included fields:** 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>;
-/** Returns recent X (Twitter) posts by a specific user, ordered by recency. **Lookup:** by `handle` (without @). Use `filter=original` to exclude retweets. **Pagination:** 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>;
-
-/** Returns recent DEX swap events for a token contract address. **Covered DEXes:** `uniswap`, `sushiswap`, `curve`, `balancer`. **Included fields:** trading pair, amounts, USD value, taker address. **Data refresh:** ~24 hours · **Chains:** Ethereum, Base */
-declare function useInfiniteTokenDexTrades(params: Omit<TokenDexTradesParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<TokenDexTradesItem>, unknown>, Error>;
-/** Returns top token holders for a contract address. **Included fields:** 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>;
-/** Returns token unlock time-series 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 useInfiniteTokenTokenomics(params?: Omit<TokenTokenomicsParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<TokenTokenomicsItem>, unknown>, Error>;
-/** Returns 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. **Included fields:** sender, receiver, raw amount, 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 · **Chains:** 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>;
-
-/** Historical orderbook snapshots for a Kalshi market. Returns yes-side bid/ask levels. Timestamps in milliseconds, prices in cents. Data refresh: ~5 minutes */
-declare function useV2KalshiOrderbooks(params: V2KalshiOrderbooksParams): _tanstack_react_query.UseQueryResult<ApiResponse<V2KalshiOrderbooksItem>, Error>;
-/** OHLCV candlestick data for a Polymarket market. Prices normalized to YES side. Data refresh: ~30 minutes */
-declare function useV2PolymarketCandlesticks(params?: V2PolymarketCandlesticksParams): _tanstack_react_query.UseQueryResult<ApiResponse<V2PolymarketCandlesticksItem>, Error>;
-/** Cumulative volume time series for a Polymarket token. Data refresh: ~30 minutes */
-declare function useV2PolymarketVolumeTimeseries(params?: V2PolymarketVolumeTimeseriesParams): _tanstack_react_query.UseQueryResult<ApiResponse<V2PolymarketVolumeTimeseriesItem>, Error>;
-/** Historical orderbook snapshots for a Polymarket token. Returns raw bid/ask depth levels. Timestamps in milliseconds. Data refresh: ~5 minutes */
-declare function useV2PolymarketOrderbooks(params: V2PolymarketOrderbooksParams): _tanstack_react_query.UseQueryResult<ApiResponse<V2PolymarketOrderbooksItem>, Error>;
-/** Volume breakdown by outcome (YES/NO) for a Polymarket market. Data refresh: ~30 minutes */
-declare function useV2PolymarketVolumeChart(params?: V2PolymarketVolumeChartParams): _tanstack_react_query.UseQueryResult<ApiResponse<V2PolymarketVolumeChartItem>, Error>;
-
-/** Returns multiple wallet sub-resources in a single request. **Available fields** (via `fields`): `balance`, `tokens`, `labels`, `nft`. **Lookup:** by `address`. 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>;
-/** Returns 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>;
-/** Returns entity labels for multiple wallet addresses. Pass up to 100 comma-separated addresses via the `addresses` query parameter. **Included fields:** entity name, type, and labels per address. */
-declare function useInfiniteWalletLabelsBatch(params: Omit<WalletLabelsBatchParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<WalletLabelsBatchItem>, unknown>, Error>;
-/** Returns 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 useInfiniteWalletNetWorth(params: Omit<WalletNetWorthParams, 'offset'>): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_query_core.InfiniteData<ApiResponse<WalletNetWorthItem>, unknown>, Error>;
-/** Returns 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>;
-/** Returns 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. **Included fields:** token contract, counterparty, raw amount, 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 · **Chains:** 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>;
-
-/** Fetches a web page and converts it to clean, LLM-friendly markdown. **Options:** - `target_selector` — extract specific page sections - `remove_selector` — 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 MatchingMarketDailyItem, type MatchingMarketDailyParams, type MatchingMarketFindItem, type MatchingMarketFindItemKalshi, type MatchingMarketFindItemPolymarket, type MatchingMarketFindParams, type MatchingMarketPairsItem, type MatchingMarketPairsItemKalshi, type MatchingMarketPairsItemPolymarket, type MatchingMarketPairsParams, 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 V2KalshiOrderbooksItem, type V2KalshiOrderbooksParams, type V2PolymarketCandlesticksItem, type V2PolymarketCandlesticksParams, type V2PolymarketOrderbooksItem, type V2PolymarketOrderbooksParams, type V2PolymarketVolumeChartItem, type V2PolymarketVolumeChartParams, type V2PolymarketVolumeTimeseriesItem, type V2PolymarketVolumeTimeseriesParams, 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, useInfiniteKalshiOpenInterest, useInfiniteKalshiPrices, useInfiniteKalshiRanking, useInfiniteKalshiTrades, useInfiniteKalshiVolumes, useInfiniteMarketRanking, useInfiniteMatchingMarketDaily, useInfiniteMatchingMarketFind, useInfiniteMatchingMarketPairs, useInfiniteNewsFeed, useInfiniteOnchainBridgeRanking, useInfiniteOnchainSchema, useInfiniteOnchainSql, useInfiniteOnchainStructuredQuery, useInfiniteOnchainTx, useInfiniteOnchainYieldRanking, useInfinitePolymarketActivity, useInfinitePolymarketEvents, useInfinitePolymarketMarkets, useInfinitePolymarketOpenInterest, useInfinitePolymarketPositions, useInfinitePolymarketPrices, useInfinitePolymarketRanking, useInfinitePolymarketTrades, useInfinitePolymarketVolumes, useInfinitePredictionMarketCategoryMetrics, useInfiniteProjectDefiMetrics, useInfiniteProjectDefiRanking, useInfiniteSearchAirdrop, useInfiniteSearchEvents, useInfiniteSearchFund, useInfiniteSearchKalshi, useInfiniteSearchNews, useInfiniteSearchPolymarket, useInfiniteSearchProject, useInfiniteSearchSocialPeople, useInfiniteSearchSocialPosts, useInfiniteSearchWallet, useInfiniteSearchWeb, useInfiniteSocialMindshare, useInfiniteSocialRanking, useInfiniteSocialSmartFollowersHistory, useInfiniteSocialTweetReplies, useInfiniteSocialTweets, useInfiniteSocialUserFollowers, useInfiniteSocialUserFollowing, useInfiniteSocialUserPosts, useInfiniteSocialUserReplies, useInfiniteTokenDexTrades, useInfiniteTokenHolders, useInfiniteTokenTokenomics, useInfiniteTokenTransfers, useInfiniteWalletHistory, useInfiniteWalletLabelsBatch, useInfiniteWalletNetWorth, useInfiniteWalletProtocols, useInfiniteWalletTransfers, useMarketEtf, useMarketFearGreed, useMarketFutures, useMarketLiquidationChart, useMarketLiquidationExchangeList, useMarketLiquidationOrder, useMarketOnchainIndicator, useMarketOptions, useMarketPrice, useMarketPriceIndicator, useNewsDetail, useOnchainGasPrice, useProjectDetail, useSocialDetail, useSocialUser, useToast, useV2KalshiOrderbooks, useV2PolymarketCandlesticks, useV2PolymarketOrderbooks, useV2PolymarketVolumeChart, useV2PolymarketVolumeTimeseries, useWalletDetail, useWebFetch };