@surf-ai/sdk 0.1.0 → 0.1.4

package/dist/server/index.d.ts

@@ -12,7 +12,7 @@ import express from 'express';
  */
 
 interface ServerOptions {
-    /** Port to listen on (default: PORT env or 3001) */
+    /** Port to listen on (default: PORT env, fallback 3001) */
     port?: number;
     /** Directory containing route files (default: ./routes) */
     routesDir?: string;
@@ -55,21 +55,23 @@ interface ApiCursorResponse<T> {
 }
 interface ExchangeDepthItem {
     /** Total ask-side depth in base currency units */
-    ask_depth: unknown;
+    ask_depth: number;
+    /** Sell orders, price ascending */
     asks: ExchangeDepthItemAsksItem[];
     /** Total bid-side depth in base currency units */
-    bid_depth: unknown;
+    bid_depth: number;
+    /** Buy orders, price descending */
     bids: ExchangeDepthItemBidsItem[];
     /** Exchange identifier */
     exchange: string;
     /** (best_bid + best_ask) / 2 */
-    mid_price: unknown;
+    mid_price: number;
     /** Trading pair like BTC/USDT */
     pair: string;
     /** Best ask - best bid */
-    spread: unknown;
+    spread: number;
     /** Spread as percent of mid price */
-    spread_pct: unknown;
+    spread_pct: number;
 }
 interface ExchangeDepthItemAsksItem {
     /** Amount at this level */
@@ -85,7 +87,7 @@ interface ExchangeDepthItemBidsItem {
 }
 interface ExchangeDepthParams {
     /** Trading pair (e.g. BTC/USDT) */
-    pair?: string;
+    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' */
@@ -97,15 +99,15 @@ interface ExchangeFundingHistoryItem {
     /** Exchange identifier */
     exchange: string;
     /** Funding rate at this settlement */
-    funding_rate: unknown;
+    funding_rate: number;
     /** Perpetual contract pair like BTC/USDT */
     pair: string;
     /** Unix timestamp in seconds */
-    timestamp: unknown;
+    timestamp: number;
 }
 interface ExchangeFundingHistoryParams {
     /** Trading pair (e.g. BTC/USDT) */
-    pair?: string;
+    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' */
@@ -114,6 +116,7 @@ interface ExchangeFundingHistoryParams {
     exchange?: 'binance' | 'okx' | 'bybit' | 'bitget' | 'gate' | 'htx' | 'mexc' | 'bitfinex' | 'bitmex';
 }
 interface ExchangeKlinesItem {
+    /** OHLCV candles */
     candles: ExchangeKlinesItemCandlesItem[];
     /** Number of candles */
     count: number;
@@ -124,15 +127,15 @@ interface ExchangeKlinesItem {
     /** Trading pair */
     pair: string;
     /** Last candle datetime */
-    period_end: unknown;
+    period_end: string;
     /** Highest price in period */
-    period_high: unknown;
+    period_high: number;
     /** Lowest price in period */
-    period_low: unknown;
+    period_low: number;
     /** First candle datetime */
-    period_start: unknown;
+    period_start: string;
     /** Total volume in period */
-    period_volume: unknown;
+    period_volume: number;
 }
 interface ExchangeKlinesItemCandlesItem {
     /** Closing price */
@@ -144,13 +147,13 @@ interface ExchangeKlinesItemCandlesItem {
     /** Opening price */
     open: number;
     /** Candle open time in Unix seconds */
-    timestamp: unknown;
+    timestamp: number;
     /** Trading volume in base currency units */
     volume: number;
 }
 interface ExchangeKlinesParams {
     /** Trading pair (e.g. BTC/USDT) */
-    pair?: string;
+    pair: string;
     /** Market type: spot for spot trading, swap for perpetual contracts — @default 'spot' */
     type?: 'spot' | 'swap';
     /** Candle interval — @default '1h' */
@@ -166,15 +169,15 @@ 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;
+    long_short_ratio: number;
     /** Perpetual contract pair like BTC/USDT */
     pair: string;
     /** Unix timestamp in seconds */
-    timestamp: unknown;
+    timestamp: number;
 }
 interface ExchangeLongShortRatioParams {
     /** Trading pair (e.g. BTC/USDT) */
-    pair?: string;
+    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. */
@@ -186,21 +189,21 @@ interface ExchangeLongShortRatioParams {
 }
 interface ExchangeMarketsItem {
     /** Whether the market is active */
-    active: unknown;
+    active: boolean;
     /** Base currency */
-    base: unknown;
+    base: string;
     /** Exchange identifier */
     exchange: string;
     /** Default maker fee rate */
-    maker_fee: unknown;
+    maker_fee: number;
     /** Trading pair like BTC/USDT */
     pair: string;
     /** Quote currency */
-    quote: unknown;
+    quote: string;
     /** Default taker fee rate */
-    taker_fee: unknown;
+    taker_fee: number;
     /** Market type: spot, swap, future, option */
-    type: unknown;
+    type: string;
 }
 interface ExchangeMarketsParams {
     /** Exchange identifier. When omitted, searches across all supported exchanges. */
@@ -228,15 +231,15 @@ interface ExchangePerpDataFunding {
     /** Exchange identifier */
     exchange: string;
     /** Current funding rate (0.0001 = 0.01%) */
-    funding_rate: unknown;
+    funding_rate: number;
     /** Index price derived from the weighted average of spot prices across multiple exchanges */
-    index_price: unknown;
+    index_price: number;
     /** Funding interval like 8h */
-    interval: unknown;
+    interval: string;
     /** Mark price calculated by the exchange from the index price and funding rate, used as the reference for liquidations */
-    mark_price: unknown;
+    mark_price: number;
     /** Next settlement time ISO8601 */
-    next_funding: unknown;
+    next_funding: string;
     /** Perpetual contract pair like BTC/USDT */
     pair: string;
 }
@@ -244,47 +247,47 @@ interface ExchangePerpDataOpenInterest {
     /** Exchange identifier */
     exchange: string;
     /** Open interest in contracts */
-    open_interest_amount: unknown;
+    open_interest_amount: number;
     /** Open interest in USD */
-    open_interest_usd: unknown;
+    open_interest_usd: number;
     /** Trading pair like BTC/USDT */
     pair: string;
     /** Unix timestamp in seconds */
-    timestamp: unknown;
+    timestamp: number;
 }
 interface ExchangePerpParams {
     /** Trading pair (e.g. BTC/USDT). The swap suffix ':USDT' is added automatically. */
-    pair?: string;
-    /** Comma-separated fields to include: 'funding' (current funding rate), 'oi' (open interest). Defaults to all fields. — @default 'funding' */
+    pair: string;
+    /** Comma-separated fields to include: 'funding' (current funding rate), 'oi' (open interest). Defaults to all fields. — @default 'funding,oi' */
     fields?: string;
     /** Exchange identifier — @default 'binance' */
     exchange?: 'binance' | 'okx' | 'bybit' | 'bitget' | 'htx' | 'bitfinex' | 'bitmex';
 }
 interface ExchangePriceItem {
     /** Best ask price */
-    ask: unknown;
+    ask: number;
     /** Best bid price */
-    bid: unknown;
+    bid: number;
     /** Price change percentage in 24h */
-    change_24h_pct: unknown;
+    change_24h_pct: number;
     /** Exchange identifier like binance, okx */
     exchange: string;
     /** 24h high price */
-    high_24h: unknown;
+    high_24h: number;
     /** Last traded price */
-    last: unknown;
+    last: number;
     /** 24h low price */
-    low_24h: unknown;
+    low_24h: number;
     /** Trading pair like BTC/USDT */
     pair: string;
     /** Unix timestamp in seconds */
-    timestamp: unknown;
+    timestamp: number;
     /** 24h trading volume in base currency units */
-    volume_24h_base: unknown;
+    volume_24h_base: number;
 }
 interface ExchangePriceParams {
     /** Trading pair (e.g. BTC/USDT) */
-    pair?: string;
+    pair: string;
     /** Market type: spot for spot trading, swap for perpetual contracts — @default 'spot' */
     type?: 'spot' | 'swap';
     /** Exchange identifier — @default 'binance' */
@@ -301,15 +304,19 @@ interface FundDetailData {
     invested_projects_count: number;
     /** Fund jurisdiction */
     jurisdiction?: string;
+    /** Fund links (website, social, etc.) */
     links: FundDetailDataLinksItem[];
+    /** Fund team members */
     members: FundDetailDataMembersItem[];
     /** Fund name */
     name: string;
+    /** Recent research publications */
     recent_researches: FundDetailDataRecentResearchesItem[];
     /** Fund tier ranking (lower is better) */
     tier: number;
     /** Fund type like `VC` or `Accelerator` */
     type?: string;
+    /** X (Twitter) accounts */
     x_accounts: FundDetailDataXAccountsItem[];
 }
 interface FundDetailDataLinksItem {
@@ -323,6 +330,7 @@ interface FundDetailDataMembersItem {
     avatar?: string;
     /** Member name */
     name: string;
+    /** Member roles */
     roles: unknown;
 }
 interface FundDetailDataRecentResearchesItem {
@@ -402,6 +410,7 @@ interface FundRankingItem {
     name: string;
     /** Fund tier ranking (lower is better) */
     tier: number;
+    /** Top invested projects (up to 5) */
     top_projects: FundRankingItemTopProjectsItem[];
     /** Fund type */
     type?: string;
@@ -426,13 +435,14 @@ interface FundRankingItemTopProjectsItem {
 }
 interface FundRankingParams {
     /** Ranking metric. Can be `tier` (lower is better) or `portfolio_count` (number of invested projects). */
-    metric?: 'tier' | 'portfolio_count';
+    metric: 'tier' | 'portfolio_count';
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
     offset?: number;
 }
 interface MarketEtfItem {
+    /** Flow breakdown by individual ETF ticker */
     etfs?: MarketEtfItemEtfsItem[];
     /** Daily net flow in USD (positive=inflow, negative=outflow) */
     flow_usd: number;
@@ -449,7 +459,7 @@ interface MarketEtfItemEtfsItem {
 }
 interface MarketEtfParams {
     /** Token symbol. Can be `BTC` or `ETH`. */
-    symbol?: 'BTC' | 'ETH';
+    symbol: 'BTC' | 'ETH';
     /** Field to sort results by — @default 'timestamp' */
     sort_by?: 'flow_usd' | 'timestamp';
     /** Sort order — @default 'desc' */
@@ -507,7 +517,7 @@ interface MarketLiquidationChartItem {
 }
 interface MarketLiquidationChartParams {
     /** Token ticker symbol like `BTC` or `ETH` */
-    symbol?: string;
+    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' */
@@ -585,9 +595,9 @@ interface MarketOnchainIndicatorItem {
 }
 interface MarketOnchainIndicatorParams {
     /** Token ticker symbol. Can be `BTC` or `ETH`. */
-    symbol?: 'BTC' | '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';
+    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. */
@@ -615,7 +625,7 @@ interface MarketOptionsItem {
 }
 interface MarketOptionsParams {
     /** Token symbol. Can be `BTC`, `ETH`, `SOL`, `XRP`, `BNB`, `DOGE`, `ADA`, or `AVAX`. */
-    symbol?: 'BTC' | 'ETH' | 'SOL' | 'XRP' | 'BNB' | 'DOGE' | 'ADA' | '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' */
@@ -633,7 +643,7 @@ interface MarketPriceItem {
 }
 interface MarketPriceParams {
     /** Single token ticker symbol like `BTC`, `ETH`, or `SOL` (multi-symbol not supported) */
-    symbol?: string;
+    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. */
@@ -704,9 +714,9 @@ interface MarketPriceIndicatorItemValues {
 }
 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';
+    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;
+    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' */
@@ -786,9 +796,10 @@ interface NewsDetailData {
 }
 interface NewsDetailParams {
     /** Article ID (returned as id in feed/search results) */
-    id?: string;
+    id: string;
 }
 interface NewsFeedItem {
+    /** Search highlight fragments with <em> tags around matching terms. Only present in search results. */
     highlights?: NewsFeedItemHighlights;
     /** Article ID. Use with the detail endpoint to fetch full content. */
     id: string;
@@ -852,18 +863,20 @@ interface OnchainGasPriceData {
 }
 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';
+    chain: 'ethereum' | 'polygon' | 'bsc' | 'arbitrum' | 'optimism' | 'base' | 'avalanche' | 'fantom' | 'linea' | 'cyber';
 }
 interface OnchainStructuredQueryItem {
-    [key: string]: unknown;
 }
 interface OnchainStructuredQueryParams {
+    /** Columns to return. Omit to return all columns. Example for agent.ethereum_transactions: [`transaction_hash`, `from_address`, `value`] */
     fields?: unknown;
+    /** WHERE conditions (ANDed together) */
     filters?: OnchainStructuredQueryParamsFiltersItem[];
     /** Max rows to return. Default 20, max 10000 */
     limit?: number;
     /** Rows to skip for pagination. Default 0 */
     offset?: number;
+    /** ORDER BY clauses */
     sort?: OnchainStructuredQueryParamsSortItem[];
     /** Fully-qualified table name like `agent.my_table` */
     source: string;
@@ -873,7 +886,7 @@ interface OnchainStructuredQueryParamsFiltersItem {
     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> */
+    /** Comparison value. Use a JSON array for `in`/`not_in` operators like `[21000000, 21000001]` */
     value: unknown;
 }
 interface OnchainStructuredQueryParamsSortItem {
@@ -883,6 +896,7 @@ interface OnchainStructuredQueryParamsSortItem {
     order?: string;
 }
 interface OnchainSchemaItem {
+    /** List of columns in this table */
     columns: OnchainSchemaItemColumnsItem[];
     /** Database name (always `agent`) */
     database: string;
@@ -898,7 +912,6 @@ interface OnchainSchemaItemColumnsItem {
     type: string;
 }
 interface OnchainSqlItem {
-    [key: string]: unknown;
 }
 interface OnchainSqlParams {
     /** Maximum number of rows to return — @default '1000' */
@@ -907,12 +920,14 @@ interface OnchainSqlParams {
     sql: string;
 }
 interface OnchainTxItem {
+    /** List of addresses and storage keys. Empty array for legacy; populated for EIP-2930+ */
     accessList: OnchainTxItemAccesslistItem[];
+    /** Versioned hashes of blob commitments. EIP-4844 only */
     blobVersionedHashes?: unknown;
     /** Block hash, null if pending */
-    blockHash: unknown;
+    blockHash: string;
     /** Block number (hex), null if pending */
-    blockNumber: unknown;
+    blockNumber: string;
     /** Chain ID (hex) */
     chainId?: string;
     /** Sender address (0x-prefixed) */
@@ -938,9 +953,9 @@ interface OnchainTxItem {
     /** Signature S (hex) */
     s: string;
     /** Recipient address, null for contract creation */
-    to: unknown;
+    to: string;
     /** Index in block (hex), null if pending */
-    transactionIndex: unknown;
+    transactionIndex: string;
     /** Transaction type: 0x0=legacy, 0x1=EIP-2930, 0x2=EIP-1559, 0x3=EIP-4844 */
     type: string;
     /** Signature V (hex). Legacy: recovery ID (0x1b/0x1c); EIP-2930+: parity (0x0/0x1) */
@@ -953,13 +968,14 @@ interface OnchainTxItem {
 interface OnchainTxItemAccesslistItem {
     /** Account address (0x-prefixed) */
     address: string;
+    /** List of storage slot keys (0x-prefixed hex) */
     storageKeys: unknown;
 }
 interface OnchainTxParams {
     /** Transaction hash (0x-prefixed hex) */
-    hash?: string;
+    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';
+    chain: 'ethereum' | 'polygon' | 'bsc' | 'arbitrum' | 'optimism' | 'base' | 'avalanche' | 'fantom' | 'linea' | 'cyber';
 }
 interface OnchainYieldRankingItem {
     /** Total APY (base + reward) */
@@ -1014,7 +1030,7 @@ interface PredictionMarketCategoryMetricsParams {
     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' */
+    /** Maximum rows to return — @default '200' */
     limit?: number;
     /** Pagination offset — @default '0' */
     offset?: number;
@@ -1028,6 +1044,7 @@ interface KalshiEventsItem {
     event_title: string;
     /** Number of markets in this event */
     market_count: number;
+    /** Markets within this event */
     markets: KalshiEventsItemMarketsItem[];
 }
 interface KalshiEventsItemMarketsItem {
@@ -1066,7 +1083,7 @@ interface KalshiEventsItemMarketsItem {
 }
 interface KalshiEventsParams {
     /** Event ticker identifier */
-    event_ticker?: string;
+    event_ticker: string;
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -1108,7 +1125,7 @@ interface KalshiMarketsItem {
 }
 interface KalshiMarketsParams {
     /** Market ticker identifier */
-    market_ticker?: string;
+    market_ticker: string;
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -1122,7 +1139,7 @@ interface KalshiOpenInterestItem {
 }
 interface KalshiOpenInterestParams {
     /** Market ticker identifier */
-    ticker?: string;
+    ticker: string;
     /** Predefined time range: `7d`, `30d`, `90d`, `180d`, or `1y` — @default '30d' */
     time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
 }
@@ -1152,7 +1169,7 @@ interface KalshiPricesItemSideB {
 }
 interface KalshiPricesParams {
     /** Market ticker identifier */
-    ticker?: string;
+    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' */
@@ -1224,7 +1241,7 @@ interface KalshiTradesItem {
 }
 interface KalshiTradesParams {
     /** Market ticker identifier */
-    ticker?: string;
+    ticker: string;
     /** Filter by taker side: `yes` or `no` */
     taker_side?: 'yes' | 'no';
     /** Minimum notional volume in USD (each contract = $1) */
@@ -1250,7 +1267,7 @@ interface KalshiVolumesItem {
 }
 interface KalshiVolumesParams {
     /** Market ticker identifier */
-    ticker?: string;
+    ticker: string;
     /** Predefined time range: `7d`, `30d`, `90d`, `180d`, or `1y` — @default '30d' */
     time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
 }
@@ -1278,7 +1295,7 @@ interface PolymarketActivityItem {
 }
 interface PolymarketActivityParams {
     /** Polymarket proxy wallet address */
-    address?: string;
+    address: string;
     /** Results per page — @default '50' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -1297,6 +1314,7 @@ interface PolymarketEventsItem {
     image?: string;
     /** Number of markets in this event */
     market_count: number;
+    /** Markets within this event */
     markets: PolymarketEventsItemMarketsItem[];
     /** Resolution source URL */
     settlement_sources?: string;
@@ -1306,6 +1324,7 @@ interface PolymarketEventsItem {
     status: string;
     /** Surf curated event subcategory */
     subcategory?: string;
+    /** Event tags */
     tags?: unknown;
     /** Event title */
     title: string;
@@ -1347,6 +1366,7 @@ interface PolymarketEventsItemMarketsItem {
     status: string;
     /** Surf curated market subcategory */
     subcategory?: string;
+    /** Market tags */
     tags?: unknown;
     /** Market title */
     title: string;
@@ -1375,7 +1395,7 @@ interface PolymarketEventsItemMarketsItemSideB {
 }
 interface PolymarketEventsParams {
     /** Event slug identifier */
-    event_slug?: string;
+    event_slug: string;
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -1416,6 +1436,7 @@ interface PolymarketMarketsItem {
     status: string;
     /** Surf curated market subcategory */
     subcategory?: string;
+    /** Market tags */
     tags?: unknown;
     /** Market title */
     title: string;
@@ -1444,7 +1465,7 @@ interface PolymarketMarketsItemSideB {
 }
 interface PolymarketMarketsParams {
     /** Market slug identifier */
-    market_slug?: string;
+    market_slug: string;
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -1460,7 +1481,7 @@ interface PolymarketOpenInterestItem {
 }
 interface PolymarketOpenInterestParams {
     /** Market condition identifier */
-    condition_id?: string;
+    condition_id: string;
     /** Predefined time range — @default '30d' */
     time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
 }
@@ -1488,7 +1509,7 @@ interface PolymarketPositionsItem {
 }
 interface PolymarketPositionsParams {
     /** Polymarket proxy wallet address */
-    address?: string;
+    address: string;
     /** Results per page — @default '50' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -1518,7 +1539,7 @@ interface PolymarketPricesItemSideB {
 }
 interface PolymarketPricesParams {
     /** Market condition identifier */
-    condition_id?: string;
+    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' */
@@ -1543,6 +1564,7 @@ interface PolymarketRankingItem {
     status: string;
     /** Surf curated market subcategory */
     subcategory?: string;
+    /** Market tags */
     tags?: unknown;
 }
 interface PolymarketRankingParams {
@@ -1625,7 +1647,7 @@ interface PolymarketVolumesItem {
 }
 interface PolymarketVolumesParams {
     /** Market condition identifier */
-    condition_id?: string;
+    condition_id: string;
     /** Predefined time range — @default '30d' */
     time_range?: '7d' | '30d' | '90d' | '180d' | '1y';
     /** Aggregation interval: `1h` (hourly) or `1d` (daily) — @default '1d' */
@@ -1643,7 +1665,7 @@ interface ProjectDefiMetricsParams {
     /** 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';
+    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`) */
@@ -1668,7 +1690,7 @@ interface ProjectDefiRankingItem {
 }
 interface ProjectDefiRankingParams {
     /** Ranking metric. Can be `tvl`, `revenue`, `fees`, `volume`, or `users`. */
-    metric?: 'tvl' | 'revenue' | 'fees' | 'volume' | 'users';
+    metric: 'tvl' | 'revenue' | 'fees' | 'volume' | 'users';
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -1685,17 +1707,21 @@ interface ProjectDetailData {
     tokenomics?: ProjectDetailDataTokenomics;
 }
 interface ProjectDetailDataContracts {
+    /** List of deployed smart contract addresses across chains */
     contracts?: ProjectDetailDataContractsContractsItem[];
 }
 interface ProjectDetailDataFunding {
+    /** List of individual funding rounds */
     rounds?: ProjectDetailDataFundingRoundsItem[];
     /** Total capital raised across all rounds in USD */
     total_raise?: number;
 }
 interface ProjectDetailDataOverview {
+    /** Chains the project is deployed on */
     chains?: unknown;
     /** Short description of the project */
     description?: string;
+    /** Exchange names where the token is listed */
     exchanges?: unknown;
     /** Surf project UUID — pass as 'id' parameter to /project/detail, /project/events, or /project/defi/metrics for exact lookup. Prefer over 'q' (fuzzy name search). */
     id: string;
@@ -1705,6 +1731,7 @@ interface ProjectDetailDataOverview {
     name: string;
     /** URL-friendly project slug */
     slug?: string;
+    /** Project category tags like `DeFi`, `NFT`, or `Layer2` */
     tags?: unknown;
     /** TGE status: pre, upcoming, or post */
     tge_status?: string;
@@ -1724,11 +1751,13 @@ interface ProjectDetailDataSocial {
     twitter?: ProjectDetailDataSocialTwitter;
 }
 interface ProjectDetailDataTeam {
+    /** List of team members with their roles and social links */
     members?: ProjectDetailDataTeamMembersItem[];
 }
 interface ProjectDetailDataTgeStatus {
     /** TGE status: `pre`, `upcoming`, or `post`. Omitted when unknown. */
     current_status?: string;
+    /** Exchange names where the token is listed */
     exchanges?: unknown;
     /** Unix timestamp of the last TGE event */
     last_event_time?: number;
@@ -1790,6 +1819,7 @@ interface ProjectDetailDataFundingRoundsItem {
     amount?: number;
     /** Date when the round closed in ISO 8601 format */
     date?: string;
+    /** Investors participating in this round */
     investors?: ProjectDetailDataFundingRoundsItemInvestorsItem[];
     /** Funding round name like `Seed`, `Series A`, or `Private` */
     round_name: string;
@@ -1835,6 +1865,7 @@ interface ProjectDetailDataTeamMembersItem {
     name: string;
     /** Team member's role or title */
     role?: string;
+    /** Social profile links keyed by platform name like `twitter` or `linkedin` */
     social_links?: ProjectDetailDataTeamMembersItemSocialLinks;
 }
 interface ProjectDetailDataFundingRoundsItemInvestorsItem {
@@ -1855,7 +1886,7 @@ interface ProjectDetailParams {
     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' */
+    /** Comma-separated sub-resources to include. Can be `overview`, `token_info`, `tokenomics`, `funding`, `team`, `contracts`, `social`, or `tge_status`. — @default 'overview,token_info,tokenomics,funding,team,contracts,social,tge_status' */
     fields?: string;
 }
 interface SearchAirdropItem {
@@ -1878,6 +1909,7 @@ interface SearchAirdropItem {
     /** Airdrop lifecycle stage: `POTENTIAL` (speculated, tasks open), `CONFIRMED` (announced, tasks open), `SNAPSHOT` (eligibility snapshot taken), `VERIFICATION` (claim window open), `REWARD_AVAILABLE` (ready to claim), `DISTRIBUTED` (sent, historical) */
     status: string;
     task_summary?: SearchAirdropItemTaskSummary;
+    /** Full task list (only with include_tasks=true) */
     tasks?: SearchAirdropItemTasksItem[];
     /** Total project fundraise in USD (0 if unknown) */
     total_raise: number;
@@ -1889,9 +1921,11 @@ interface SearchAirdropItemTaskSummary {
     open: number;
     /** Total number of tasks */
     total: number;
+    /** Distinct task types */
     types: unknown;
 }
 interface SearchAirdropItemTasksItem {
+    /** Supported blockchain names */
     blockchains?: unknown;
     /** Task close date as Unix seconds (0 if unknown) */
     close_date: number;
@@ -1915,13 +1949,13 @@ interface SearchAirdropItemTasksItem {
 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' */
+    /** Comma-separated lifecycle phases. `active` = tasks open, can participate (POTENTIAL + CONFIRMED). `claimable` = eligible, can claim (SNAPSHOT + VERIFICATION + REWARD_AVAILABLE). `completed` = done (DISTRIBUTED). Defaults to `active,claimable` to show actionable airdrops. — @default 'active,claimable' */
     phase?: string;
     /** Filter by reward type */
     reward_type?: 'airdrop' | 'points' | 'whitelist' | 'nft' | 'role' | 'ambassador';
     /** Filter activities containing tasks of this type */
     task_type?: 'social' | 'bounty-platforms' | 'testnet' | 'mainnet' | 'role' | 'form' | 'liquidity' | 'mint-nft' | 'game' | 'trading' | 'staking' | 'depin' | 'node' | 'ambassador' | 'hold' | 'check-wallet' | 'mint-domain' | 'predictions' | 'deploy';
-    /** Only return activities with currently OPEN tasks — @default 'false' */
+    /** 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';
@@ -1931,7 +1965,7 @@ interface SearchAirdropParams {
     limit?: number;
     /** Pagination offset — @default '0' */
     offset?: number;
-    /** Include full task list per activity — @default 'false' */
+    /** Include full task list per activity — @default 'False' */
     include_tasks?: boolean;
 }
 interface SearchEventsItem {
@@ -1969,6 +2003,7 @@ interface SearchFundItem {
     name: string;
     /** Fund tier ranking (lower is better) */
     tier: number;
+    /** Top invested projects (up to 5) */
     top_projects: SearchFundItemTopProjectsItem[];
     /** Fund type */
     type?: string;
@@ -1993,7 +2028,7 @@ interface SearchFundItemTopProjectsItem {
 }
 interface SearchFundParams {
     /** Search keyword — fund name like `a16z`, `paradigm`, or `coinbase ventures` */
-    q?: string;
+    q: string;
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -2008,6 +2043,7 @@ interface SearchKalshiItem {
     event_title: string;
     /** Number of markets in this event */
     market_count: number;
+    /** Markets within this event */
     markets: SearchKalshiItemMarketsItem[];
 }
 interface SearchKalshiItemMarketsItem {
@@ -2057,6 +2093,7 @@ interface SearchKalshiParams {
     offset?: number;
 }
 interface SearchNewsItem {
+    /** Search highlight fragments with <em> tags around matching terms. Only present in search results. */
     highlights?: SearchNewsItemHighlights;
     /** Article ID. Use with the detail endpoint to fetch full content. */
     id: string;
@@ -2080,7 +2117,7 @@ interface SearchNewsItemHighlights {
 }
 interface SearchNewsParams {
     /** Search keyword or phrase */
-    q?: string;
+    q: string;
 }
 interface SearchPolymarketItem {
     /** Surf curated event category */
@@ -2095,6 +2132,7 @@ interface SearchPolymarketItem {
     image?: string;
     /** Number of markets in this event */
     market_count: number;
+    /** Markets within this event */
     markets: SearchPolymarketItemMarketsItem[];
     /** Resolution source URL */
     settlement_sources?: string;
@@ -2104,6 +2142,7 @@ interface SearchPolymarketItem {
     status: string;
     /** Surf curated event subcategory */
     subcategory?: string;
+    /** Event tags */
     tags?: unknown;
     /** Event title */
     title: string;
@@ -2145,6 +2184,7 @@ interface SearchPolymarketItemMarketsItem {
     status: string;
     /** Surf curated market subcategory */
     subcategory?: string;
+    /** Market tags */
     tags?: unknown;
     /** Market title */
     title: string;
@@ -2186,6 +2226,7 @@ interface SearchPolymarketParams {
     offset?: number;
 }
 interface SearchProjectItem {
+    /** Chains the project operates on */
     chains?: unknown;
     /** Short description of the project */
     description?: string;
@@ -2199,7 +2240,9 @@ interface SearchProjectItem {
     slug?: string;
     /** Primary token symbol like `BTC` or `ETH` */
     symbol?: string;
+    /** Project category tags */
     tags?: unknown;
+    /** Associated tokens */
     tokens?: SearchProjectItemTokensItem[];
 }
 interface SearchProjectItemTokensItem {
@@ -2214,7 +2257,7 @@ interface SearchProjectItemTokensItem {
 }
 interface SearchProjectParams {
     /** Search keyword — project name or ticker like `uniswap`, `bitcoin`, or `ETH` */
-    q?: string;
+    q: string;
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -2238,7 +2281,7 @@ interface SearchSocialPeopleItem {
 }
 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;
+    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 */
@@ -2248,6 +2291,7 @@ interface SearchSocialPostsItem {
     author: SearchSocialPostsItemAuthor;
     /** Unix timestamp (seconds) when the tweet was posted */
     created_at: number;
+    /** Attached media items (photos, videos, GIFs) */
     media?: SearchSocialPostsItemMediaItem[];
     stats: SearchSocialPostsItemStats;
     /** Full text content of the tweet */
@@ -2285,7 +2329,7 @@ interface SearchSocialPostsItemStats {
 }
 interface SearchSocialPostsParams {
     /** Search keyword or `from:handle` syntax like `ethereum` or `from:cz_binance` */
-    q?: string;
+    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 */
@@ -2294,6 +2338,7 @@ interface SearchSocialPostsParams {
 interface SearchWalletItem {
     /** Primary wallet address for this entity */
     address?: string;
+    /** Known wallet addresses for this entity (max 10, use num_addresses for the total count) */
     addresses?: SearchWalletItemAddressesItem[];
     /** Chain of the primary address */
     chain?: string;
@@ -2316,7 +2361,7 @@ interface SearchWalletItemAddressesItem {
 }
 interface SearchWalletParams {
     /** Search keyword like `binance`, `vitalik.eth`, or `0xd8dA...` */
-    q?: string;
+    q: string;
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -2334,7 +2379,7 @@ interface SearchWebItem {
 }
 interface SearchWebParams {
     /** Search query like `bitcoin price prediction 2026` */
-    q?: string;
+    q: string;
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -2354,19 +2399,21 @@ interface SocialDetailData {
     twitter_id: string;
 }
 interface SocialDetailDataFollowerGeo {
+    /** Follower count breakdown by geographic location */
     locations: SocialDetailDataFollowerGeoLocationsItem[];
     /** Total number of followers across all locations */
     total_follower_count: number;
 }
 interface SocialDetailDataSentiment {
     /** Sentiment score from -1 (very negative) to 1 (very positive) */
-    score: unknown;
+    score: number;
     /** Time range for the sentiment analysis like 7d or 30d */
     time_range: string;
 }
 interface SocialDetailDataSmartFollowers {
     /** Total number of smart followers */
     count: number;
+    /** List of top smart followers sorted by influence score */
     followers: SocialDetailDataSmartFollowersFollowersItem[];
 }
 interface SocialDetailDataFollowerGeoLocationsItem {
@@ -2402,7 +2449,7 @@ interface SocialDetailParams {
     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' */
+    /** Comma-separated sub-resources to include. Can be `sentiment`, `follower_geo`, or `smart_followers`. — @default 'sentiment,follower_geo,smart_followers' */
     fields?: string;
     /** Timeframe for sentiment data. Can be `24h`, `48h`, `7d`, `30d`, `3m`, `6m`, or `1y`. — @default '7d' */
     time_range?: '24h' | '48h' | '7d' | '30d' | '3m' | '6m' | '1y';
@@ -2417,9 +2464,9 @@ interface SocialMindshareItem {
 }
 interface SocialMindshareParams {
     /** Entity name to resolve like `uniswap`, `ethereum`, or `aave` */
-    q?: string;
+    q: string;
     /** Time aggregation interval. Can be `5m`, `1h`, `1d`, or `7d`. */
-    interval?: '5m' | '1h' | '1d' | '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) */
@@ -2433,6 +2480,7 @@ interface SocialRankingItem {
     sentiment?: string;
     /** Weighted sentiment score from -1 (very negative) to 1 (very positive) */
     sentiment_score?: number;
+    /** Project category tags */
     tags?: unknown;
     token?: SocialRankingItemToken;
     /** Deprecated: no longer populated. */
@@ -2499,6 +2547,7 @@ interface SocialTweetRepliesItem {
     author: SocialTweetRepliesItemAuthor;
     /** Unix timestamp (seconds) when the tweet was posted */
     created_at: number;
+    /** Attached media items (photos, videos, GIFs) */
     media?: SocialTweetRepliesItemMediaItem[];
     stats: SocialTweetRepliesItemStats;
     /** Full text content of the tweet */
@@ -2536,7 +2585,7 @@ interface SocialTweetRepliesItemStats {
 }
 interface SocialTweetRepliesParams {
     /** Tweet ID to get replies for */
-    tweet_id?: string;
+    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 */
@@ -2546,6 +2595,7 @@ interface SocialTweetsItem {
     author: SocialTweetsItemAuthor;
     /** Unix timestamp (seconds) when the tweet was posted */
     created_at: number;
+    /** Attached media items (photos, videos, GIFs) */
     media?: SocialTweetsItemMediaItem[];
     stats: SocialTweetsItemStats;
     /** Full text content of the tweet */
@@ -2583,7 +2633,7 @@ interface SocialTweetsItemStats {
 }
 interface SocialTweetsParams {
     /** Comma-separated numeric post ID strings, max 100 */
-    ids?: string;
+    ids: string;
 }
 interface SocialUserData {
     /** Profile picture URL */
@@ -2603,7 +2653,7 @@ interface SocialUserData {
 }
 interface SocialUserParams {
     /** X (Twitter) username without @ like `cz_binance` or `vitalikbuterin` */
-    handle?: string;
+    handle: string;
 }
 interface SocialUserFollowersItem {
     /** Profile picture URL */
@@ -2623,7 +2673,7 @@ interface SocialUserFollowersItem {
 }
 interface SocialUserFollowersParams {
     /** X (Twitter) username without @ like `vitalikbuterin` or `cz_binance` */
-    handle?: string;
+    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 */
@@ -2647,7 +2697,7 @@ interface SocialUserFollowingItem {
 }
 interface SocialUserFollowingParams {
     /** X (Twitter) username without @ like `vitalikbuterin` or `cz_binance` */
-    handle?: string;
+    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 */
@@ -2657,6 +2707,7 @@ interface SocialUserPostsItem {
     author: SocialUserPostsItemAuthor;
     /** Unix timestamp (seconds) when the tweet was posted */
     created_at: number;
+    /** Attached media items (photos, videos, GIFs) */
     media?: SocialUserPostsItemMediaItem[];
     stats: SocialUserPostsItemStats;
     /** Full text content of the tweet */
@@ -2694,7 +2745,7 @@ interface SocialUserPostsItemStats {
 }
 interface SocialUserPostsParams {
     /** X (Twitter) username without @ like `vitalikbuterin` or `cz_binance` */
-    handle?: string;
+    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 */
@@ -2706,6 +2757,7 @@ interface SocialUserRepliesItem {
     author: SocialUserRepliesItemAuthor;
     /** Unix timestamp (seconds) when the tweet was posted */
     created_at: number;
+    /** Attached media items (photos, videos, GIFs) */
     media?: SocialUserRepliesItemMediaItem[];
     stats: SocialUserRepliesItemStats;
     /** Full text content of the tweet */
@@ -2743,7 +2795,7 @@ interface SocialUserRepliesItemStats {
 }
 interface SocialUserRepliesParams {
     /** X (Twitter) username without @ like `vitalikbuterin` or `cz_binance` */
-    handle?: string;
+    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 */
@@ -2779,7 +2831,7 @@ interface TokenDexTradesItem {
 }
 interface TokenDexTradesParams {
     /** Token contract address (0x-prefixed hex) */
-    address?: string;
+    address: string;
     /** Chain. Can be `ethereum` or `base`. — @default 'ethereum' */
     chain?: 'ethereum' | 'base';
     /** Results per page — @default '20' */
@@ -2801,15 +2853,16 @@ interface TokenHoldersItem {
 }
 interface TokenHoldersParams {
     /** Token contract address (0x-prefixed hex or Solana base58) */
-    address?: string;
+    address: string;
     /** Chain. Can be `ethereum`, `polygon`, `bsc`, `solana`, `avalanche`, `arbitrum`, `optimism`, or `base`. */
-    chain?: 'ethereum' | 'polygon' | 'bsc' | 'solana' | 'avalanche' | 'arbitrum' | 'optimism' | 'base';
+    chain: 'ethereum' | 'polygon' | 'bsc' | 'solana' | 'avalanche' | 'arbitrum' | 'optimism' | 'base';
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset (accepted for API consistency but currently ignored) — @default '0' */
     offset?: number;
 }
 interface TokenTokenomicsItem {
+    /** Breakdown by allocation */
     allocations?: TokenTokenomicsItemAllocationsItem[];
     /** Unix timestamp in seconds */
     timestamp: number;
@@ -2852,9 +2905,9 @@ interface TokenTransfersItem {
 }
 interface TokenTransfersParams {
     /** Token contract address (0x-prefixed hex or Solana base58) */
-    address?: string;
+    address: string;
     /** Chain. Can be `ethereum`, `base`, `solana`, or `tron`. */
-    chain?: 'ethereum' | 'base' | 'solana' | '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. */
@@ -2865,14 +2918,20 @@ interface TokenTransfersParams {
     offset?: number;
 }
 interface WalletDetailData {
+    /** Chains the wallet has non-zero balances on. Always present (not controlled by fields param). For Solana addresses, returns a single entry. */
     active_chains?: WalletDetailDataActiveChainsItem[];
+    /** Token approvals (EVM-only, up to 50). Only present when `approvals` is included in the `fields` param. */
     approvals?: WalletDetailDataApprovalsItem[];
+    /** Per-field errors for any fields that failed to load */
     errors?: WalletDetailDataErrorsItem[];
     evm_balance?: WalletDetailDataEvmBalance;
+    /** EVM token holdings (up to 50). Populated for EVM chains only. */
     evm_tokens?: WalletDetailDataEvmTokensItem[];
     labels?: WalletDetailDataLabels;
+    /** NFT holdings (EVM-only, top 200 by value) */
     nft?: WalletDetailDataNftItem[];
     sol_balance?: WalletDetailDataSolBalance;
+    /** Solana SPL token holdings from Solscan (up to 50). Populated for Solana chain only. */
     sol_tokens?: WalletDetailDataSolTokensItem[];
 }
 interface WalletDetailDataActiveChainsItem {
@@ -2890,6 +2949,7 @@ interface WalletDetailDataApprovalsItem {
     chain: string;
     /** Full token name */
     name?: string;
+    /** List of approved spender contracts */
     spenders: WalletDetailDataApprovalsItemSpendersItem[];
     /** Token ticker symbol */
     symbol: string;
@@ -2905,6 +2965,7 @@ interface WalletDetailDataErrorsItem {
 interface WalletDetailDataEvmBalance {
     /** Wallet address */
     address: string;
+    /** Per-chain balance breakdown, sorted by value descending (EVM only) */
     chain_balances?: WalletDetailDataEvmBalanceChainBalancesItem[];
     /** Total portfolio value in USD (EVM only) */
     total_usd: number;
@@ -2936,6 +2997,7 @@ interface WalletDetailDataLabels {
     entity_name?: string;
     /** Type of entity like `exchange`, `fund`, or `whale` */
     entity_type?: string;
+    /** List of labels assigned to this address */
     labels: WalletDetailDataLabelsLabelsItem[];
 }
 interface WalletDetailDataNftItem {
@@ -2996,10 +3058,10 @@ interface WalletDetailDataLabelsLabelsItem {
 }
 interface WalletDetailParams {
     /** Wallet address (0x hex for EVM, base58 for Solana) */
-    address?: string;
+    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' */
+    /** Comma-separated sub-resources to include. Valid: `balance`, `tokens`, `labels`, `nft`, `approvals`. The `active_chains` field is always returned. `approvals` is opt-in (not in default) as it triggers additional upstream calls. — @default 'balance,tokens,labels,nft' */
     fields?: string;
 }
 interface WalletHistoryItem {
@@ -3018,7 +3080,7 @@ interface WalletHistoryItem {
 }
 interface WalletHistoryParams {
     /** Wallet address — must be a raw 0x-prefixed hex address, not an ENS name */
-    address?: string;
+    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' */
@@ -3037,6 +3099,7 @@ interface WalletLabelsBatchItem {
     entity_name?: string;
     /** Type of entity like `exchange`, `fund`, or `whale` */
     entity_type?: string;
+    /** List of labels assigned to this address */
     labels: WalletLabelsBatchItemLabelsItem[];
 }
 interface WalletLabelsBatchItemLabelsItem {
@@ -3047,7 +3110,7 @@ interface WalletLabelsBatchItemLabelsItem {
 }
 interface WalletLabelsBatchParams {
     /** Comma-separated wallet addresses to look up, max 100 */
-    addresses?: string;
+    addresses: string;
 }
 interface WalletNetWorthItem {
     /** Unix timestamp in seconds */
@@ -3057,13 +3120,14 @@ interface WalletNetWorthItem {
 }
 interface WalletNetWorthParams {
     /** Wallet address (0x hex, base58, or ENS name like `vitalik.eth`) */
-    address?: string;
+    address: string;
 }
 interface WalletProtocolsItem {
     /** Canonical chain name where the protocol operates */
     chain: string;
     /** Protocol logo image URL */
     logo_url?: string;
+    /** Individual positions held in this protocol */
     positions: WalletProtocolsItemPositionsItem[];
     /** Human-readable protocol name */
     protocol_name: string;
@@ -3075,11 +3139,15 @@ interface WalletProtocolsItem {
 interface WalletProtocolsItemPositionsItem {
     /** Total USD value of this position */
     balance_usd: number;
+    /** Tokens borrowed in this position */
     borrow_tokens?: WalletProtocolsItemPositionsItemBorrowTokensItem[];
+    /** LP tokens in this position */
     lp_tokens?: WalletProtocolsItemPositionsItemLpTokensItem[];
     /** Position name or type like `Lending` or `Staking` */
     name: string;
+    /** Unclaimed reward tokens in this position */
     reward_tokens?: WalletProtocolsItemPositionsItemRewardTokensItem[];
+    /** Tokens supplied/deposited in this position */
     supply_tokens?: WalletProtocolsItemPositionsItemSupplyTokensItem[];
 }
 interface WalletProtocolsItemPositionsItemBorrowTokensItem {
@@ -3140,7 +3208,7 @@ interface WalletProtocolsItemPositionsItemSupplyTokensItem {
 }
 interface WalletProtocolsParams {
     /** Wallet address — must be a raw 0x-prefixed hex address, not an ENS name */
-    address?: string;
+    address: string;
     /** Results per page — @default '20' */
     limit?: number;
     /** Pagination offset — @default '0' */
@@ -3170,7 +3238,7 @@ interface WalletTransfersItem {
 }
 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;
+    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. */
@@ -3192,7 +3260,7 @@ interface WebFetchData {
 }
 interface WebFetchParams {
     /** URL to fetch and parse */
-    url?: string;
+    url: string;
     /** CSS selector to extract specific content */
     target_selector?: string;
     /** CSS selector to remove unwanted elements */
@@ -3227,115 +3295,115 @@ declare const dataApi: {
     /** 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>>;
+        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>>;
+        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>>;
+        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>>;
+        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>>;
+        trades: (params: KalshiTradesParams) => Promise<ApiResponse<KalshiTradesItem>>;
+        volumes: (params: KalshiVolumesParams) => Promise<ApiResponse<KalshiVolumesItem>>;
     };
     market: {
-        etf: (params?: MarketEtfParams) => Promise<ApiResponse<MarketEtfItem>>;
+        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_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>>;
+        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>>;
+        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>>;
+        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>>;
+        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>>;
+        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>>;
+        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>>;
+        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>>;
+        fund: (params: SearchFundParams) => Promise<ApiResponse<SearchFundItem>>;
         kalshi: (params?: SearchKalshiParams) => Promise<ApiResponse<SearchKalshiItem>>;
-        news: (params?: SearchNewsParams) => Promise<ApiResponse<SearchNewsItem>>;
+        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>>;
+        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>>;
+        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>>;
+        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>>;
+        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>>;
+        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>>;
+        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>>;
+        fetch: (params: WebFetchParams) => Promise<ApiObjectResponse<WebFetchData>>;
     };
 };