@surf-ai/sdk 0.1.0

package/dist/server/index.d.ts

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