@bitget-ai/getagent-skill 0.2.2 → 0.3.0

package/skills/getagent/references/sdk/data/crypto.md

@@ -64,7 +64,6 @@ are callable through the DataSDK wrapper.
 - [`crypto.hyperliquid.whale_alert`](#cryptohyperliquidwhale-alert)
 - [`crypto.hyperliquid.whale_position`](#cryptohyperliquidwhale-position)
 - [`crypto.market`](#cryptomarket)
-- [`crypto.market.markets_list`](#cryptomarketmarkets-list)
 - [`crypto.market_dominance`](#cryptomarket-dominance)
 - [`crypto.nft_info`](#cryptonft-info)
 - [`crypto.nft_list`](#cryptonft-list)
@@ -127,6 +126,16 @@ Summary: Asset Platforms
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `platform_id` | `string` | Platform identifier (e.g. 'ethereum', 'polygon-pos'). |
+| `chain_identifier` | `integer` | EVM chain ID (e.g. 1 for Ethereum mainnet). |
+| `name` | `string` | Platform display name. |
+| `shortname` | `string` | Platform short name. |
+| `native_coin_id` | `string` | CoinGecko ID of the native coin (e.g. 'ethereum'). |
+
 ---
 
 ### `crypto.categories`
@@ -151,6 +160,17 @@ Summary: Categories
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `category_id` | `string` | Category identifier. |
+| `name` | `string` | Category name. |
+| `market_cap` | `number` | Total market capitalization of the category in USD. |
+| `market_cap_change_24h` | `number` | 24-hour market cap change percentage. |
+| `volume_24h` | `number` | 24-hour trading volume in USD. |
+| `top_3_coins` | `array` | Icon URLs of the top 3 coins in this category. |
+
 ---
 
 ### `crypto.coin_history`
@@ -177,6 +197,19 @@ Summary: Coin History
 | `symbol` | `yes` | `string` | `-` | Cryptocurrency ticker symbol (e.g. 'BTC'). |
 | `date` | `yes` | `string` | `-` | Snapshot date in dd-mm-yyyy format (e.g. '30-12-2022'). |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | CoinGecko coin identifier. |
+| `symbol` | `string` | Coin ticker symbol. |
+| `name` | `string` | Coin name. |
+| `date` | `string` | Snapshot date in dd-mm-yyyy format. |
+| `price` | `number` | Price in USD at the snapshot date. |
+| `market_cap` | `number` | Market capitalization in USD. |
+| `total_volume` | `number` | 24h trading volume in USD. |
+| `image` | `string` | Coin thumbnail image URL. |
+
 ---
 
 ### `crypto.coin_info`
@@ -202,6 +235,38 @@ Summary: Coin Info
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | Coin identifier. |
+| `symbol` | `string` | Coin ticker symbol. |
+| `name` | `string` | Coin name. |
+| `description` | `string` | Coin description. |
+| `homepage` | `string` | Official homepage URL. |
+| `image` | `string` | Coin logo URL. |
+| `market_cap_rank` | `integer` | Market capitalization rank. |
+| `current_price` | `number` | Current price in USD. |
+| `market_cap` | `number` | Market capitalization in USD. |
+| `total_volume` | `number` | 24-hour trading volume in USD. |
+| `high_24h` | `number` | 24-hour high price in USD. |
+| `low_24h` | `number` | 24-hour low price in USD. |
+| `price_change_24h` | `number` | Absolute price change over 24 hours. |
+| `price_change_percentage_24h` | `number` | Percentage price change over 24 hours. |
+| `circulating_supply` | `number` | Circulating supply. |
+| `total_supply` | `number` | Total supply. |
+| `max_supply` | `number` | Maximum supply. |
+| `ath` | `number` | All-time high price in USD. |
+| `atl` | `number` | All-time low price in USD. |
+| `genesis_date` | `string` | Date the coin was first created. |
+| `categories` | `array` | Categories the coin belongs to. |
+| `sentiment_votes_up_percentage` | `number` | Percentage of positive sentiment votes. |
+| `sentiment_votes_down_percentage` | `number` | Percentage of negative sentiment votes. |
+| `coingecko_rank` | `integer` | CoinGecko popularity rank. |
+| `developer_score` | `number` | Developer activity score. |
+| `community_score` | `number` | Community engagement score. |
+| `liquidity_score` | `number` | Liquidity score. |
+
 ---
 
 ### `crypto.coin_tickers`
@@ -227,6 +292,23 @@ Summary: Coin Tickers
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `exchange` | `string` | Exchange name. |
+| `exchange_id` | `string` | Exchange identifier. |
+| `base` | `string` | Base currency symbol. |
+| `target` | `string` | Quote/target currency symbol. |
+| `last_price` | `number` | Last traded price. |
+| `volume` | `number` | 24h trading volume in base currency. |
+| `bid_ask_spread_percentage` | `number` | Bid-ask spread as a percentage. |
+| `trust_score` | `string` | Trust score: 'green', 'yellow', or 'red'. |
+| `trade_url` | `string` | Direct URL to trade this pair. |
+| `last_traded_at` | `string` | Last trade timestamp. |
+| `converted_last_usd` | `number` | Last price converted to USD. |
+| `converted_volume_usd` | `number` | 24h volume converted to USD. |
+
 ---
 
 ### `crypto.defi.fees.historical`
@@ -251,6 +333,14 @@ Summary: Historical
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | Date of the record. |
+| `total_fees` | `number` | Total fees across all protocols in USD. |
+| `daily_fees` | `number` | Daily fees in USD. |
+
 ---
 
 ### `crypto.defi.fees.overview`
@@ -275,6 +365,25 @@ Summary: Overview
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `name` | `string` | Protocol name. |
+| `disabled` | `boolean` | Whether the protocol is disabled. |
+| `display_name` | `string` | Display name. |
+| `module` | `string` | Module identifier. |
+| `category` | `string` | Protocol category. |
+| `logo` | `string` | Logo URL. |
+| `chains` | `array` | Supported blockchain networks. |
+| `total_24h` | `number` | Total fees in last 24 hours (USD). |
+| `total_48h_to_24h` | `number` | Total fees 48h to 24h ago (USD). |
+| `change_1d` | `number` | 24h fees change percentage. |
+| `total_7d` | `number` | Total fees in last 7 days (USD). |
+| `change_7d` | `number` | 7d fees change percentage. |
+| `total_30d` | `number` | Total fees in last 30 days (USD). |
+| `change_30d` | `number` | 30d fees change percentage. |
+
 ---
 
 ### `crypto.defi.fees.protocol_fees`
@@ -300,6 +409,15 @@ Summary: Protocol Fees
 |---|---|---|---|---|
 | `protocol` | `yes` | `string` | `-` | Protocol slug identifier. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | Date of the record. |
+| `total_fees` | `number` | Total fees collected in USD. |
+| `daily_fees` | `number` | Daily fees collected in USD. |
+| `revenue` | `number` | Protocol revenue in USD. |
+
 ---
 
 ### `crypto.defi.tvl.chains`
@@ -325,6 +443,16 @@ Summary: Chains
 |---|---|---|---|---|
 | `chain` | `no` | `string | null` | `-` | Specific blockchain network. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | Date of the TVL record. |
+| `chain` | `string` | Blockchain network identifier. |
+| `tvl` | `number` | Total Value Locked in USD. |
+| `token_symbol` | `string` | Native token symbol. |
+| `token_price` | `number` | Native token price in USD. |
+
 ---
 
 ### `crypto.defi.tvl.historical`
@@ -349,6 +477,13 @@ Summary: Historical
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | Date of the TVL record. |
+| `tvl` | `number` | Total Value Locked across all protocols in USD. |
+
 ---
 
 ### `crypto.defi.tvl.protocol_history`
@@ -374,6 +509,14 @@ Summary: Protocol History
 |---|---|---|---|---|
 | `protocol` | `yes` | `string` | `-` | Protocol slug identifier. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | Date of the TVL record. |
+| `tvl` | `number` | Total Value Locked in USD. |
+| `chain` | `string` | Specific chain (if applicable). |
+
 ---
 
 ### `crypto.defi.tvl.protocols`
@@ -398,6 +541,24 @@ Summary: Protocols
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `name` | `string` | Protocol name. |
+| `slug` | `string` | Protocol slug identifier. |
+| `symbol` | `string` | Protocol token symbol. |
+| `category` | `string` | Protocol category. |
+| `chain` | `string` | Primary blockchain network. |
+| `chains` | `array` | All blockchain networks the protocol is on. |
+| `tvl` | `number` | Total Value Locked in USD. |
+| `change_1h` | `number` | TVL change percentage over 1 hour. |
+| `change_1d` | `number` | TVL change percentage over 1 day. |
+| `change_7d` | `number` | TVL change percentage over 7 days. |
+| `mcap` | `number` | Market capitalization in USD. |
+| `url` | `string` | Protocol website URL. |
+| `logo` | `string` | Protocol logo URL. |
+
 ---
 
 ### `crypto.defi.volumes.chain_volume`
@@ -423,6 +584,15 @@ Summary: Chain Volume
 |---|---|---|---|---|
 | `chain` | `yes` | `string` | `-` | Blockchain network identifier. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | Date of the record. |
+| `chain` | `string` | Blockchain network. |
+| `daily_volume` | `number` | Daily trading volume in USD. |
+| `total_volume` | `number` | Cumulative trading volume in USD. |
+
 ---
 
 ### `crypto.defi.volumes.dex_overview`
@@ -450,6 +620,25 @@ Summary: Dex Overview
 | `exclude_total_data_chart_breakdown` | `no` | `boolean | null` | `true` | Exclude total data chart breakdown arrays. |
 | `data_type` | `no` | `string | null` | `dailyVolume` | Data type (dailyVolume, totalVolume). |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `name` | `string` | DEX protocol name. |
+| `disabled` | `boolean` | Whether the DEX is disabled. |
+| `display_name` | `string` | Display name. |
+| `module` | `string` | Module identifier. |
+| `category` | `string` | DEX category. |
+| `logo` | `string` | Logo URL. |
+| `chains` | `array` | Supported blockchain networks. |
+| `total_24h` | `number` | Total volume in last 24 hours (USD). |
+| `total_48h_to_24h` | `number` | Total volume 48h to 24h ago (USD). |
+| `change_1d` | `number` | 24h volume change percentage. |
+| `total_7d` | `number` | Total volume in last 7 days (USD). |
+| `change_7d` | `number` | 7d volume change percentage. |
+| `total_30d` | `number` | Total volume in last 30 days (USD). |
+| `change_30d` | `number` | 30d volume change percentage. |
+
 ---
 
 ### `crypto.defi.volumes.protocol_volume`
@@ -475,6 +664,14 @@ Summary: Protocol Volume
 |---|---|---|---|---|
 | `protocol` | `yes` | `string` | `-` | Protocol slug identifier. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | Date of the record. |
+| `daily_volume` | `number` | Daily trading volume in USD. |
+| `total_volume` | `number` | Cumulative trading volume in USD. |
+
 ---
 
 ### `crypto.derivatives_tickers`
@@ -499,6 +696,25 @@ Summary: Derivatives Tickers
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `market` | `string` | Exchange or market name. |
+| `symbol` | `string` | Contract symbol. |
+| `index_id` | `string` | Index identifier. |
+| `price` | `number` | Current price. |
+| `price_percentage_change_24h` | `number` | 24h price change percentage. |
+| `contract_type` | `string` | Contract type (e.g. 'perpetual', 'futures'). |
+| `index` | `number` | Index price. |
+| `basis` | `number` | Basis (futures price - index price) percentage. |
+| `spread` | `number` | Bid-ask spread percentage. |
+| `funding_rate` | `number` | Current funding rate. |
+| `open_interest` | `number` | Open interest in USD. |
+| `volume_24h` | `number` | 24h trading volume in USD. |
+| `last_traded_at` | `string` | Last trade timestamp. |
+| `expired_at` | `string` | Contract expiry timestamp (for dated futures). |
+
 ---
 
 ### `crypto.dex.boosted_tokens`
@@ -523,6 +739,19 @@ Summary: Boosted Tokens
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `token_address` | `string` | Token contract address. |
+| `chain_id` | `string` | Blockchain network identifier. |
+| `description` | `string` | Token description. |
+| `website_url` | `string` | Official website URL. |
+| `twitter_url` | `string` | Twitter profile URL. |
+| `telegram_url` | `string` | Telegram group URL. |
+| `discord_url` | `string` | Discord server URL. |
+| `logo_url` | `string` | Token logo image URL. |
+
 ---
 
 ### `crypto.dex.latest_pairs`
@@ -548,6 +777,25 @@ Summary: Latest Pairs
 |---|---|---|---|---|
 | `query` | `yes` | `string` | `-` | Search query (token name, symbol, or address). |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `chain_id` | `string` | Blockchain network identifier. |
+| `dex_id` | `string` | DEX platform identifier (e.g., uniswap, pancakeswap). |
+| `pair_address` | `string` | Trading pair contract address. |
+| `base_token_address` | `string` | Base token contract address. |
+| `base_token_symbol` | `string` | Base token symbol. |
+| `base_token_name` | `string` | Base token name. |
+| `quote_token_address` | `string` | Quote token contract address. |
+| `quote_token_symbol` | `string` | Quote token symbol. |
+| `quote_token_name` | `string` | Quote token name. |
+| `price_usd` | `number` | Current price in USD. |
+| `volume_24h` | `number` | 24-hour trading volume in USD. |
+| `liquidity_usd` | `number` | Total liquidity in USD. |
+| `price_change_24h` | `number` | 24-hour price change percentage. |
+| `fdv` | `number` | Fully diluted valuation in USD. |
+
 ---
 
 ### `crypto.dex.pair_details`
@@ -574,6 +822,33 @@ Summary: Pair Details
 | `chain_id` | `yes` | `string` | `-` | Blockchain network identifier (e.g., ethereum, bsc, polygon). |
 | `pair_addresses` | `yes` | `string` | `-` | Comma-separated pair addresses (max 30). Multiple comma separated items allowed |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `chain_id` | `string` | Blockchain network identifier. |
+| `dex_id` | `string` | DEX platform identifier (e.g., uniswap, pancakeswap). |
+| `pair_address` | `string` | Trading pair contract address. |
+| `base_token_address` | `string` | Base token contract address. |
+| `base_token_symbol` | `string` | Base token symbol. |
+| `base_token_name` | `string` | Base token name. |
+| `quote_token_address` | `string` | Quote token contract address. |
+| `quote_token_symbol` | `string` | Quote token symbol. |
+| `quote_token_name` | `string` | Quote token name. |
+| `price_usd` | `number` | Current price in USD. |
+| `price_native` | `number` | Price in native token. |
+| `volume_24h` | `number` | 24-hour trading volume in USD. |
+| `volume_24h_buys` | `number` | 24-hour buy volume in USD. |
+| `volume_24h_sells` | `number` | 24-hour sell volume in USD. |
+| `transactions_24h_buys` | `integer` | Number of buy transactions in 24 hours. |
+| `transactions_24h_sells` | `integer` | Number of sell transactions in 24 hours. |
+| `liquidity_usd` | `number` | Total liquidity in USD. |
+| `price_change_5m` | `number` | 5-minute price change percentage. |
+| `price_change_1h` | `number` | 1-hour price change percentage. |
+| `price_change_6h` | `number` | 6-hour price change percentage. |
+| `price_change_24h` | `number` | 24-hour price change percentage. |
+| `fdv` | `number` | Fully diluted valuation in USD. |
+
 ---
 
 ### `crypto.dex.search`
@@ -599,6 +874,25 @@ Summary: Search
 |---|---|---|---|---|
 | `query` | `yes` | `string` | `-` | Search query (token name, symbol, or address). |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `chain_id` | `string` | Blockchain network identifier. |
+| `dex_id` | `string` | DEX platform identifier (e.g., uniswap, pancakeswap). |
+| `pair_address` | `string` | Trading pair contract address. |
+| `base_token_address` | `string` | Base token contract address. |
+| `base_token_symbol` | `string` | Base token symbol. |
+| `base_token_name` | `string` | Base token name. |
+| `quote_token_address` | `string` | Quote token contract address. |
+| `quote_token_symbol` | `string` | Quote token symbol. |
+| `quote_token_name` | `string` | Quote token name. |
+| `price_usd` | `number` | Current price in USD. |
+| `volume_24h` | `number` | 24-hour trading volume in USD. |
+| `liquidity_usd` | `number` | Total liquidity in USD. |
+| `price_change_24h` | `number` | 24-hour price change percentage. |
+| `fdv` | `number` | Fully diluted valuation in USD. |
+
 ---
 
 ### `crypto.dex.token_orders`
@@ -625,6 +919,20 @@ Summary: Token Orders
 | `chain_id` | `yes` | `string` | `-` | Blockchain network identifier (e.g., ethereum, bsc, polygon). |
 | `token_address` | `yes` | `string` | `-` | Token contract address. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `order_type` | `string` | Order type: 'buy' or 'sell'. |
+| `price` | `number` | Order price. |
+| `amount` | `number` | Order amount. |
+| `total` | `number` | Total value. |
+| `timestamp` | `string` | Order timestamp. |
+| `status` | `string` | Order status. |
+| `chain_id` | `string` | Chain identifier. |
+| `token_address` | `string` | Token address. |
+| `payment_timestamp` | `integer` | Payment timestamp (ms). |
+
 ---
 
 ### `crypto.dex.token_pairs`
@@ -650,6 +958,25 @@ Summary: Token Pairs
 |---|---|---|---|---|
 | `token_addresses` | `yes` | `string` | `-` | Comma-separated token addresses (max 30). Multiple comma separated items allowed |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `chain_id` | `string` | Blockchain network identifier. |
+| `dex_id` | `string` | DEX platform identifier (e.g., uniswap, pancakeswap). |
+| `pair_address` | `string` | Trading pair contract address. |
+| `base_token_address` | `string` | Base token contract address. |
+| `base_token_symbol` | `string` | Base token symbol. |
+| `base_token_name` | `string` | Base token name. |
+| `quote_token_address` | `string` | Quote token contract address. |
+| `quote_token_symbol` | `string` | Quote token symbol. |
+| `quote_token_name` | `string` | Quote token name. |
+| `price_usd` | `number` | Current price in USD. |
+| `volume_24h` | `number` | 24-hour trading volume in USD. |
+| `liquidity_usd` | `number` | Total liquidity in USD. |
+| `price_change_24h` | `number` | 24-hour price change percentage. |
+| `fdv` | `number` | Fully diluted valuation in USD. |
+
 ---
 
 ### `crypto.dex.token_profiles`
@@ -674,6 +1001,19 @@ Summary: Token Profiles
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `token_address` | `string` | Token contract address. |
+| `chain_id` | `string` | Blockchain network identifier. |
+| `description` | `string` | Token description. |
+| `website_url` | `string` | Official website URL. |
+| `twitter_url` | `string` | Twitter profile URL. |
+| `telegram_url` | `string` | Telegram group URL. |
+| `discord_url` | `string` | Discord server URL. |
+| `logo_url` | `string` | Token logo image URL. |
+
 ---
 
 ### `crypto.etf.flows`
@@ -701,6 +1041,18 @@ Summary: Flows
 | `interval` | `no` | `string | null` | `1d` | Time interval for the data. Default is '1d'. |
 | `etf_name` | `no` | `string | null` | `-` | Specific ETF name to query. If not provided, returns aggregated data. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `etf_name` | `string` | ETF name. None if aggregated across all ETFs. |
+| `inflow` | `number` | Capital inflow to the ETF in USD. |
+| `outflow` | `number` | Capital outflow from the ETF in USD. |
+| `net_flow` | `number` | Net flow (inflow - outflow) in USD. |
+| `total_aum` | `number` | Total assets under management in USD. |
+
 ---
 
 ### `crypto.etf.holdings`
@@ -727,6 +1079,17 @@ Summary: Holdings
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. Currently supports BTC and ETH. |
 | `etf_name` | `no` | `string | null` | `-` | Specific ETF name to query. If not provided, returns all ETFs. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `etf_name` | `string` | ETF name. |
+| `holdings` | `number` | ETF holdings amount in native cryptocurrency units. |
+| `holdings_value` | `number` | ETF holdings value in USD. |
+| `percentage` | `number` | Percentage of total cryptocurrency supply held by this ETF. |
+
 ---
 
 ### `crypto.exchange_info`
@@ -752,6 +1115,23 @@ Summary: Exchange Info
 |---|---|---|---|---|
 | `exchange_id` | `yes` | `string` | `-` | CoinGecko exchange ID e.g. 'binance'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `exchange_id` | `string` | Exchange identifier. |
+| `name` | `string` | Exchange name. |
+| `year_established` | `integer` | Year the exchange was established. |
+| `country` | `string` | Country of registration. |
+| `description` | `string` | Exchange description. |
+| `trust_score` | `integer` | Trust score (1-10). |
+| `trust_score_rank` | `integer` | Trust score rank. |
+| `trade_volume_24h_btc` | `number` | 24h trade volume in BTC. |
+| `trade_volume_24h_btc_normalized` | `number` | 24h normalized trade volume in BTC. |
+| `url` | `string` | Exchange website URL. |
+| `image` | `string` | Exchange logo URL. |
+| `has_trading_incentive` | `boolean` | Whether the exchange has trading incentives. |
+
 ---
 
 ### `crypto.exchange_rates`
@@ -776,6 +1156,16 @@ Summary: Exchange Rates
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `currency` | `string` | Currency identifier (e.g. 'usd', 'eth', 'ltc'). |
+| `name` | `string` | Currency display name. |
+| `unit` | `string` | Currency unit symbol (e.g. '$', 'BTC'). |
+| `rate` | `number` | Exchange rate against BTC. |
+| `currency_type` | `string` | Type: 'fiat', 'crypto', or 'commodity'. |
+
 ---
 
 ### `crypto.exchange_tickers`
@@ -802,6 +1192,23 @@ Summary: Exchange Tickers
 | `exchange_id` | `yes` | `string` | `-` | CoinGecko exchange ID e.g. 'binance'. |
 | `page` | `no` | `integer | null` | `-` | Page number for paginated results. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `exchange` | `string` | Exchange name. |
+| `exchange_id` | `string` | Exchange identifier. |
+| `base` | `string` | Base currency symbol. |
+| `target` | `string` | Quote/target currency symbol. |
+| `last_price` | `number` | Last traded price. |
+| `volume` | `number` | 24h trading volume in base currency. |
+| `bid_ask_spread_percentage` | `number` | Bid-ask spread as a percentage. |
+| `trust_score` | `string` | Trust score: 'green', 'yellow', or 'red'. |
+| `trade_url` | `string` | Direct URL to trade this pair. |
+| `last_traded_at` | `string` | Last trade timestamp. |
+| `converted_last_usd` | `number` | Last price converted to USD. |
+| `converted_volume_usd` | `number` | 24h volume converted to USD. |
+
 ---
 
 ### `crypto.exchange_volume_chart`
@@ -828,6 +1235,13 @@ Summary: Exchange Volume Chart
 | `exchange_id` | `yes` | `string` | `-` | CoinGecko exchange ID e.g. 'binance'. |
 | `days` | `no` | `integer` | `1` | Data up to N days ago. Values: 1/7/14/30/60/90/180/365. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `timestamp` | `string` | Timestamp of the data point. |
+| `volume_btc` | `number` | Exchange volume in BTC. |
+
 ---
 
 ### `crypto.exchanges`
@@ -854,12 +1268,29 @@ Summary: Exchanges
 | `per_page` | `no` | `integer` | `100` | Number of results per page. Default 100, max 250. |
 | `page` | `no` | `integer` | `1` | Page number. Default 1. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `exchange_id` | `string` | Exchange identifier. |
+| `name` | `string` | Exchange name. |
+| `year_established` | `integer` | Year the exchange was established. |
+| `country` | `string` | Country of registration. |
+| `description` | `string` | Exchange description. |
+| `trust_score` | `integer` | Trust score (1-10). |
+| `trust_score_rank` | `integer` | Trust score rank. |
+| `trade_volume_24h_btc` | `number` | 24h trade volume in BTC. |
+| `trade_volume_24h_btc_normalized` | `number` | 24h normalized trade volume in BTC. |
+| `url` | `string` | Exchange website URL. |
+| `image` | `string` | Exchange logo URL. |
+| `has_trading_incentive` | `boolean` | Whether the exchange has trading incentives. |
+
 ---
 
 ### `crypto.futures.funding_rate`
 
 ```python
-data.crypto.futures.funding_rate(symbol=..., exchange='binance', start_time=None, end_time=None, interval='4h', limit=200)
+data.crypto.futures.funding_rate(symbol=..., exchange='binance', interval='4h', limit=1000, start_time=None, end_time=None, start_date=None, end_date=None, days=None)
 ```
 
 Summary: Funding Rate
@@ -878,11 +1309,31 @@ Summary: Funding Rate
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
-| `exchange` | `no` | `string | null` | `binance` | Filter by specific exchange. If None, returns data from all exchanges.; Exchange identifier (e.g. 'binance', 'okx', 'gate').; Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid.; Futures exchange name (e.g. Binance, OKX, Bybit). |
-| `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
-| `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
-| `interval` | `no` | `string` | `4h` | Aggregation interval for funding-rate data.; Time interval for data aggregation. |
-| `limit` | `no` | `integer | null` | `200` | Maximum number of records to return. |
+| `exchange` | `no` | `string | null` | `binance` | Exchange identifier. Supported: binance, bitget. |
+| `interval` | `no` | `string` | `4h` | Aggregation interval for funding-rate data. Supported values: 5m, 15m, 1h, 4h, 1d. |
+| `limit` | `no` | `integer | null` | `1000` | Maximum number of records to return. Capped at 1000. |
+| `start_time` | `no` | `integer | null` | `-` | Start time as Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
+| `end_time` | `no` | `integer | null` | `-` | End time as Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
+| `start_date` | `no` | `string | null` | `-` | Start date in YYYY-MM-DD format. Defaults to 90 days ago when neither start_date nor days is specified. |
+| `end_date` | `no` | `string | null` | `-` | End date in YYYY-MM-DD format. Defaults to today. |
+| `days` | `no` | `integer | null` | `-` | Number of days to look back from end_date (or today). Range: 1–90. Takes precedence over start_date when both are provided. Defaults to 90 when neither days nor start_date is specified. |
+
+> **Time range**: Maximum window is **90 days**. The window is automatically clamped if start/end exceeds this limit.
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol representing the entity requested in the data. |
+| `timestamp` | `string` | Timestamp of the current funding period (UTC). |
+| `funding_rate` | `number` | Funding rate as a decimal (e.g., 0.0001 = 0.01%). Multiplied ×100 for percent display. |
+| `next_funding_time` | `string` | Next funding settlement time (UTC). |
+| `estimated_rate` | `number` | Estimated next funding rate. |
+| `exchange` | `string` | Exchange name. |
+| `fr_open` | `number` | Funding rate at interval start. |
+| `fr_high` | `number` | Highest funding rate during interval. |
+| `fr_low` | `number` | Lowest funding rate during interval. |
 
 #### Verified Playbook usage notes
 
@@ -919,6 +1370,20 @@ Summary: Funding Weighted
 | `weight_type` | `no` | `string` | `volume` | Weighting method: 'oi' for open interest weighting, 'volume' for volume weighting. |
 | `limit` | `no` | `integer` | `100` | Number of records to return. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `weighted_funding_rate` | `number` | Funding rate weighted by open interest across all exchanges. |
+| `average_funding_rate` | `number` | Simple average funding rate across all exchanges. |
+| `weight_by_oi` | `boolean` | Whether the rate is weighted by open interest. |
+| `fr_open` | `number` | Weighted funding rate at interval start. |
+| `fr_high` | `number` | Highest weighted funding rate during interval. |
+| `fr_low` | `number` | Lowest weighted funding rate during interval. |
+| `fr_close` | `number` | Weighted funding rate at interval end. |
+
 #### Verified Playbook usage notes
 
 - Coinglass expects base-asset symbols such as `BTC`, not pair symbols such as `BTCUSDT`.
@@ -930,7 +1395,7 @@ Summary: Funding Weighted
 ### `crypto.futures.kline`
 
 ```python
-data.crypto.futures.kline(symbol=..., start_time=None, end_time=None, interval='1d', exchange='binance', limit=200, vs_currency='usd', data_type='ohlc', days=30, exchanges=None)
+data.crypto.futures.kline(symbol=..., interval='1d', exchange='binance', limit=1000, start_time=None, end_time=None, start_date=None, end_date=None, days=None, vs_currency='usd', data_type='ohlc', exchanges=None)
 ```
 
 Summary: Kline
@@ -949,16 +1414,35 @@ Summary: Kline
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. Multiple comma separated items allowed |
-| `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
-| `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
-| `interval` | `no` | `string` | `1d` | Candlestick interval.; Data interval. Supported values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 1w.; Time interval of the data to return. |
-| `exchange` | `no` | `string` | `binance` | Exchange identifier (e.g. 'binance', 'okx', 'gate').; Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid.; Exchange name (e.g., Binance, OKX). Use support-exchange-pair API to get supported exchanges. |
-| `limit` | `no` | `integer | null` | `200` | Maximum number of candles to return.; Number of candles per API request. Maximum varies by exchange (typically 500–1500).; Number of data points to return. Default: 1000, Max: 1000. |
+| `interval` | `no` | `string` | `1d` | Candlestick interval. Supported values: 5m, 15m, 1h, 4h, 1d. |
+| `exchange` | `no` | `string` | `binance` | Exchange identifier. Supported: binance, bitget. |
+| `limit` | `no` | `integer | null` | `1000` | Maximum number of candles to return. Capped at 1000. |
+| `start_time` | `no` | `integer | null` | `-` | Start time as Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
+| `end_time` | `no` | `integer | null` | `-` | End time as Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
+| `start_date` | `no` | `string | null` | `-` | Start date in YYYY-MM-DD format. Defaults to 90 days ago when neither start_date nor days is specified. |
+| `end_date` | `no` | `string | null` | `-` | End date in YYYY-MM-DD format. Defaults to today. |
+| `days` | `no` | `integer | null` | `-` | Number of days to look back from end_date (or today). Range: 1–90. Takes precedence over start_date when both are provided. |
 | `vs_currency` | `no` | `string` | `usd` | Target currency for prices. Default is 'usd'. |
 | `data_type` | `no` | `string` | `ohlc` | enum: ohlc, market_chart Data type: 'ohlc' for OHLC candles, 'market_chart' for close-only price history. |
-| `days` | `no` | `integer` | `30` | Number of days of historical data. Used when start_date/end_date are not set. |
 | `exchanges` | `no` | `array | string | null` | `-` | accepts array values To limit the query to a subset of exchanges e.g. ['POLONIEX', 'GDAX'] Multiple comma separated items allowed. |
 
+> **Time range**: Maximum window is **90 days**. The window is automatically clamped if start/end exceeds this limit.
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `open` | `number` | The open price. |
+| `high` | `number` | The high price. |
+| `low` | `number` | The low price. |
+| `close` | `number` | The close price. |
+| `volume` | `number` | The trading volume. |
+| `vwap` | `number` | Volume Weighted Average Price over the period. |
+| `exchange` | `string` | Exchange the data was fetched from. |
+| `symbol` | `string` | Trading pair symbol. |
+| `interval` | `string` | Candlestick interval. |
+
 #### Verified Playbook usage notes
 
 - Coinglass returns OHLCV fields and does not include Binance raw `quote_volume` / `taker_buy_quote_volume`; derive or omit those features unless a probe proves the fields exist.
@@ -989,6 +1473,14 @@ Summary: Liquidation Aggregated Map
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 | `range` | `no` | `string` | `1d` | Time range for liquidation map data. Supported values: 1d, 7d, 30d.; Time range for liquidation map data. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Symbol to get data for. |
+| `liquidation_price` | `number` | Liquidation price level. |
+| `liquidation_intensity` | `number` | Liquidation intensity at this price level (in USD). |
+
 #### Verified Playbook usage notes
 
 - Coinglass expects base-asset symbols such as `BTC`, not pair symbols such as `BTCUSDT`.
@@ -1021,6 +1513,17 @@ Summary: Liquidation Heatmap
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 | `price_range` | `no` | `string | null` | `5%` | Price range for heatmap ('5%', '10%', '20%'). Default is '5%'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Symbol to get data for. |
+| `current_price` | `number` | Current market price. |
+| `price_level` | `number` | Price level for potential liquidations. |
+| `long_liquidation_amount` | `number` | Estimated long position liquidation amount at this price level (in USD). |
+| `short_liquidation_amount` | `number` | Estimated short position liquidation amount at this price level (in USD). |
+| `total_liquidation_amount` | `number` | Total liquidation amount at this price level (in USD). |
+
 ---
 
 ### `crypto.futures.liquidation_max_pain`
@@ -1046,6 +1549,17 @@ Summary: Liquidation Max Pain
 |---|---|---|---|---|
 | `range` | `no` | `string` | `24h` | Time range for liquidation data. Supported values: 12h, 24h, 48h, 3d, 7d, 14d, 30d.; Time range for liquidation data. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Symbol to get data for. |
+| `price` | `number` | Current market price. |
+| `long_max_pain_liq_level` | `number` | Long position maximum pain liquidation intensity (in USD). |
+| `long_max_pain_liq_price` | `number` | Long position maximum pain liquidation price. |
+| `short_max_pain_liq_level` | `number` | Short position maximum pain liquidation intensity (in USD). |
+| `short_max_pain_liq_price` | `number` | Short position maximum pain liquidation price. |
+
 #### Verified Playbook usage notes
 
 - `range` defaults to `"24h"` and the endpoint is market-wide; it has no `symbol` parameter in the current OpenAPI spec.
@@ -1056,7 +1570,7 @@ Summary: Liquidation Max Pain
 ### `crypto.futures.liquidations`
 
 ```python
-data.crypto.futures.liquidations(symbol=None, interval='1d', start_time=None, end_time=None, exchange=None, limit=200)
+data.crypto.futures.liquidations(symbol=None, interval='1d', exchange=None, limit=1000, start_time=None, end_time=None, start_date=None, end_date=None, days=None)
 ```
 
 Summary: Liquidations
@@ -1075,11 +1589,27 @@ Summary: Liquidations
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 | `symbol` | `no` | `string | null` | `-` | Crypto symbol. If None, returns total market liquidations. |
-| `interval` | `no` | `string | null` | `1d` | Time interval for the data. Common values: 1h, 4h, 1d. |
-| `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
-| `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
-| `exchange` | `no` | `string | null` | `-` | Futures exchange name (e.g. binance, okx, bybit). |
-| `limit` | `no` | `integer | null` | `200` | Maximum number of records to return (max 1000).; Number of records to return. |
+| `interval` | `no` | `string | null` | `1d` | Aggregation interval. Supported values: 5m, 15m, 1h, 4h, 1d. |
+| `exchange` | `no` | `string | null` | `-` | Exchange identifier. Supported: binance, bitget. |
+| `limit` | `no` | `integer | null` | `1000` | Maximum number of records to return. Capped at 1000. |
+| `start_time` | `no` | `integer | null` | `-` | Start time as Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
+| `end_time` | `no` | `integer | null` | `-` | End time as Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
+| `start_date` | `no` | `string | null` | `-` | Start date in YYYY-MM-DD format. Defaults to 90 days ago when neither start_date nor days is specified. |
+| `end_date` | `no` | `string | null` | `-` | End date in YYYY-MM-DD format. Defaults to today. |
+| `days` | `no` | `integer | null` | `-` | Number of days to look back from end_date (or today). Range: 1–90. Takes precedence over start_date when both are provided. |
+
+> **Time range**: Maximum window is **90 days**. The window is automatically clamped if start/end exceeds this limit.
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol representing the entity requested in the data. |
+| `long_liquidations` | `number` | Total long liquidations in USD. |
+| `short_liquidations` | `number` | Total short liquidations in USD. |
+| `total_liquidations` | `number` | Total liquidations (long + short) in USD. |
+| `exchange` | `string` | Exchange name. |
 
 #### Verified Playbook usage notes
 
@@ -1092,7 +1622,7 @@ Summary: Liquidations
 ### `crypto.futures.long_short_ratio`
 
 ```python
-data.crypto.futures.long_short_ratio(symbol=..., start_time=None, end_time=None, period='1h', limit=30, exchange='binance', interval='5m')
+data.crypto.futures.long_short_ratio(symbol=..., interval='5m', exchange='binance', limit=1000, start_time=None, end_time=None, start_date=None, end_date=None, days=None)
 ```
 
 Summary: Long Short Ratio
@@ -1111,19 +1641,34 @@ Summary: Long Short Ratio
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Trading pair symbol (e.g., BTCUSDT) |
-| `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
-| `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
-| `period` | `no` | `string` | `1h` | Time period (5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d) |
-| `limit` | `no` | `integer | null` | `30` | Number of results (max 500); Maximum number of records to return. |
-| `exchange` | `no` | `string` | `binance` | Exchange identifier (e.g. 'binance', 'okx', 'gate').; Futures exchange name (e.g. Binance, OKX, Bybit). |
-| `interval` | `no` | `string` | `5m` | enum: 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d Data granularity interval. |
+| `interval` | `no` | `string` | `5m` | enum: 5m, 15m, 1h, 4h, 1d Data granularity interval. |
+| `exchange` | `no` | `string` | `binance` | Exchange identifier. Supported: binance, bitget. |
+| `limit` | `no` | `integer | null` | `1000` | Maximum number of records to return. Capped at 1000. |
+| `start_time` | `no` | `integer | null` | `-` | Start time as Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
+| `end_time` | `no` | `integer | null` | `-` | End time as Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
+| `start_date` | `no` | `string | null` | `-` | Start date in YYYY-MM-DD format. Defaults to 90 days ago when neither start_date nor days is specified. |
+| `end_date` | `no` | `string | null` | `-` | End date in YYYY-MM-DD format. Defaults to today. |
+| `days` | `no` | `integer | null` | `-` | Number of days to look back from end_date (or today). Range: 1–90. Takes precedence over start_date when both are provided. |
+
+> **Time range**: Maximum window is **90 days**. The window is automatically clamped if start/end exceeds this limit.
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Trading pair symbol. |
+| `long_short_ratio` | `number` | Long to short ratio. |
+| `long_account` | `number` | Long account percentage. |
+| `short_account` | `number` | Short account percentage. |
+| `timestamp` | `integer` | Unix timestamp. |
+| `exchange` | `string` | Exchange name. |
 
 ---
 
 ### `crypto.futures.long_short_top_account_ratio`
 
 ```python
-data.crypto.futures.long_short_top_account_ratio(symbol=..., start_time=None, end_time=None, period='1h', limit=30, exchange='binance', interval='5m')
+data.crypto.futures.long_short_top_account_ratio(symbol=..., interval='5m', exchange='binance', limit=1000, start_time=None, end_time=None, start_date=None, end_date=None, days=None)
 ```
 
 Summary: Long Short Top Account Ratio
@@ -1142,19 +1687,34 @@ Summary: Long Short Top Account Ratio
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Trading pair symbol (e.g., BTCUSDT) |
-| `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
-| `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
-| `period` | `no` | `string` | `1h` | Time period (5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d) |
-| `limit` | `no` | `integer | null` | `30` | Number of results (max 500); Maximum number of records to return. |
-| `exchange` | `no` | `string` | `binance` | Exchange identifier (e.g. 'binance', 'okx', 'gate').; Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid.; Futures exchange name (e.g. Binance, OKX, Bybit). |
-| `interval` | `no` | `string` | `5m` | enum: 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d Data granularity interval. |
+| `interval` | `no` | `string` | `5m` | enum: 5m, 15m, 1h, 4h, 1d Data granularity interval. |
+| `exchange` | `no` | `string` | `binance` | Exchange identifier. Supported: binance, bitget. |
+| `limit` | `no` | `integer | null` | `1000` | Maximum number of records to return. Capped at 1000. |
+| `start_time` | `no` | `integer | null` | `-` | Start time as Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
+| `end_time` | `no` | `integer | null` | `-` | End time as Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
+| `start_date` | `no` | `string | null` | `-` | Start date in YYYY-MM-DD format. Defaults to 90 days ago when neither start_date nor days is specified. |
+| `end_date` | `no` | `string | null` | `-` | End date in YYYY-MM-DD format. Defaults to today. |
+| `days` | `no` | `integer | null` | `-` | Number of days to look back from end_date (or today). Range: 1–90. Takes precedence over start_date when both are provided. |
+
+> **Time range**: Maximum window is **90 days**. The window is automatically clamped if start/end exceeds this limit.
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Trading pair symbol. |
+| `long_short_ratio` | `number` | Long to short ratio. |
+| `long_account` | `number` | Long account percentage. |
+| `short_account` | `number` | Short account percentage. |
+| `timestamp` | `integer` | Unix timestamp. |
+| `exchange` | `string` | Exchange name. |
 
 ---
 
 ### `crypto.futures.long_short_top_position_ratio`
 
 ```python
-data.crypto.futures.long_short_top_position_ratio(symbol=..., start_time=None, end_time=None, period='1h', limit=30, exchange='binance', interval='5m')
+data.crypto.futures.long_short_top_position_ratio(symbol=..., interval='5m', exchange='binance', limit=1000, start_time=None, end_time=None, start_date=None, end_date=None, days=None)
 ```
 
 Summary: Long Short Top Position Ratio
@@ -1173,12 +1733,27 @@ Summary: Long Short Top Position Ratio
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Trading pair symbol (e.g., BTCUSDT) |
-| `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
-| `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
-| `period` | `no` | `string` | `1h` | Time period (5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d) |
-| `limit` | `no` | `integer | null` | `30` | Number of results (max 500); Maximum number of records to return. |
-| `exchange` | `no` | `string` | `binance` | Exchange identifier (e.g. 'binance', 'okx', 'gate').; Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid.; Futures exchange name (e.g. Binance, OKX, Bybit). |
-| `interval` | `no` | `string` | `5m` | enum: 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d Data granularity interval. |
+| `interval` | `no` | `string` | `5m` | enum: 5m, 15m, 1h, 4h, 1d Data granularity interval. |
+| `exchange` | `no` | `string` | `binance` | Exchange identifier. Supported: binance, bitget. |
+| `limit` | `no` | `integer | null` | `1000` | Maximum number of records to return. Capped at 1000. |
+| `start_time` | `no` | `integer | null` | `-` | Start time as Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
+| `end_time` | `no` | `integer | null` | `-` | End time as Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
+| `start_date` | `no` | `string | null` | `-` | Start date in YYYY-MM-DD format. Defaults to 90 days ago when neither start_date nor days is specified. |
+| `end_date` | `no` | `string | null` | `-` | End date in YYYY-MM-DD format. Defaults to today. |
+| `days` | `no` | `integer | null` | `-` | Number of days to look back from end_date (or today). Range: 1–90. Takes precedence over start_date when both are provided. |
+
+> **Time range**: Maximum window is **90 days**. The window is automatically clamped if start/end exceeds this limit.
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Trading pair symbol. |
+| `long_short_ratio` | `number` | Long to short ratio. |
+| `long_account` | `number` | Long account percentage. |
+| `short_account` | `number` | Short account percentage. |
+| `timestamp` | `integer` | Unix timestamp. |
+| `exchange` | `string` | Exchange name. |
 
 ---
 
@@ -1206,12 +1781,25 @@ Summary: Mark Price
 | `symbol` | `no` | `string | null` | `-` | Trading pair symbol (e.g., BTCUSDT). If not provided, returns all symbols. |
 | `exchange` | `no` | `string` | `binance` | enum: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Trading pair symbol. |
+| `mark_price` | `number` | Mark price. |
+| `index_price` | `number` | Index price. |
+| `estimated_settle_price` | `number` | Estimated settlement price. |
+| `last_funding_rate` | `number` | Last funding rate. |
+| `next_funding_time` | `integer` | Next funding time (Unix timestamp). |
+| `time` | `integer` | Current timestamp. |
+| `interest_rate` | `number` | Interest rate. |
+
 ---
 
 ### `crypto.futures.open_interest`
 
 ```python
-data.crypto.futures.open_interest(symbol=..., start_time=None, end_time=None, interval='1h', limit=100, exchange='binance')
+data.crypto.futures.open_interest(symbol=..., interval='1h', exchange='binance', unit='coin', limit=1000, start_time=None, end_time=None, start_date=None, end_date=None, days=None)
 ```
 
 Summary: Open Interest
@@ -1230,18 +1818,42 @@ Summary: Open Interest
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
-| `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
-| `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
-| `interval` | `no` | `string` | `1h` | enum: 5m, 15m, 30m, 1h, 2h, 4h, 12h, 1d Aggregation interval for open interest data. |
-| `limit` | `no` | `integer` | `100` | Number of records to return. |
-| `exchange` | `no` | `string` | `binance` | enum: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid. |
+| `interval` | `no` | `string` | `1h` | enum: 5m, 15m, 1h, 4h, 1d Aggregation interval for open interest data. |
+| `exchange` | `no` | `string` | `binance` | enum: binance, bitget Exchange identifier. Supported: binance, bitget. |
+| `unit` | `no` | `string` | `coin` | enum: coin, usd Unit for OI values: 'coin' returns coin-denominated OI (oi_open/oi_high/oi_low/oi_close), 'usd' returns USDT-denominated OI. Both raw sets (open_value/high_value/low_value/close_value) are always included. |
+| `limit` | `no` | `integer` | `1000` | Maximum number of records to return. Capped at 1000. |
+| `start_time` | `no` | `integer | null` | `-` | Start time as Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
+| `end_time` | `no` | `integer | null` | `-` | End time as Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
+| `start_date` | `no` | `string | null` | `-` | Start date in YYYY-MM-DD format. Defaults to 90 days ago when neither start_date nor days is specified. |
+| `end_date` | `no` | `string | null` | `-` | End date in YYYY-MM-DD format. Defaults to today. |
+| `days` | `no` | `integer | null` | `-` | Number of days to look back from end_date (or today). Range: 1–90. Takes precedence over start_date when both are provided. |
+
+> **Time range**: Maximum window is **90 days**. The window is automatically clamped if start/end exceeds this limit.
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Trading pair symbol. |
+| `exchange` | `string` | Exchange identifier. |
+| `interval` | `string` | Aggregation interval. |
+| `open_interest` | `number` | Open interest in base currency (oi_close when unit='coin', or close_value when unit='usd'). |
+| `oi_open` | `number` | Open interest at interval start (coin-denominated when unit='coin', USD when unit='usd'). |
+| `oi_high` | `number` | Highest open interest during interval. |
+| `oi_low` | `number` | Lowest open interest during interval. |
+| `oi_close` | `number` | Open interest at interval end. |
+| `open_value` | `number` | Open interest value in USD at interval start (always included). |
+| `high_value` | `number` | Highest OI value in USD during interval (always included). |
+| `low_value` | `number` | Lowest OI value in USD during interval (always included). |
+| `close_value` | `number` | OI value in USD at interval end (always included). |
 
 ---
 
 ### `crypto.futures.open_interest_history`
 
 ```python
-data.crypto.futures.open_interest_history(symbol=..., period='1h', limit=30, start_time=None, end_time=None, interval='1h', exchange='binance', unit='coin')
+data.crypto.futures.open_interest_history(symbol=..., interval='1h', exchange='binance', unit='coin', limit=1000, start_time=None, end_time=None, start_date=None, end_date=None, days=None)
 ```
 
 Summary: Open Interest History
@@ -1260,13 +1872,34 @@ Summary: Open Interest History
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Trading pair symbol (e.g., BTCUSDT) |
-| `period` | `no` | `string` | `1h` | Time period (5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d) |
-| `limit` | `no` | `integer | null` | `30` | Number of results (max 500); Maximum number of records to return. |
-| `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
-| `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
-| `interval` | `no` | `string` | `1h` | Aggregation interval for open interest data. |
-| `exchange` | `no` | `string` | `binance` | Exchange identifier (e.g. 'binance', 'okx', 'gate').; Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid.; Futures exchange name (e.g. Binance, OKX, Bybit). |
-| `unit` | `no` | `string` | `coin` | enum: coin, usd Unit for OI values: 'coin' returns coin-denominated OI (open/high/low/close), 'usd' returns USDT-denominated OI (open_value/high_value/low_value/close_value).; Unit for the returned data: 'usd' or 'coin'. |
+| `interval` | `no` | `string` | `1h` | Aggregation interval for open interest data. Supported values: 5m, 15m, 1h, 4h, 1d. |
+| `exchange` | `no` | `string` | `binance` | Exchange identifier. Supported: binance, bitget. |
+| `unit` | `no` | `string` | `coin` | enum: coin, usd Unit for OI values: 'coin' returns coin-denominated OI (oi_open/oi_high/oi_low/oi_close), 'usd' returns USDT-denominated OI (open_value/high_value/low_value/close_value). |
+| `limit` | `no` | `integer | null` | `1000` | Maximum number of records to return. Capped at 1000. |
+| `start_time` | `no` | `integer | null` | `-` | Start time as Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
+| `end_time` | `no` | `integer | null` | `-` | End time as Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
+| `start_date` | `no` | `string | null` | `-` | Start date in YYYY-MM-DD format. Defaults to 90 days ago when neither start_date nor days is specified. |
+| `end_date` | `no` | `string | null` | `-` | End date in YYYY-MM-DD format. Defaults to today. |
+| `days` | `no` | `integer | null` | `-` | Number of days to look back from end_date (or today). Range: 1–90. Takes precedence over start_date when both are provided. |
+
+> **Time range**: Maximum window is **90 days**. The window is automatically clamped if start/end exceeds this limit.
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Trading pair symbol. |
+| `exchange` | `string` | Exchange identifier. |
+| `interval` | `string` | Aggregation interval. |
+| `oi_open` | `number` | Open interest at interval start (coin or USD depending on unit). |
+| `oi_high` | `number` | Highest open interest during interval. |
+| `oi_low` | `number` | Lowest open interest during interval. |
+| `oi_close` | `number` | Open interest at interval end. |
+| `open_value` | `number` | Open interest value in USD at interval start (always included). |
+| `high_value` | `number` | Highest OI value in USD during interval (always included). |
+| `low_value` | `number` | Lowest OI value in USD during interval (always included). |
+| `close_value` | `number` | OI value in USD at interval end (always included). |
 
 ---
 
@@ -1325,6 +1958,15 @@ Summary: Taker Volume
 | `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
 | `exchange` | `no` | `string` | `Binance` | Exchange name (e.g. Binance, OKX, Bybit). Can be obtained from support-exchange-pair endpoint. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `buy_sell_ratio` | `number` | Taker buy to sell volume ratio. |
+| `buy_vol` | `number` | Taker buy volume. |
+| `sell_vol` | `number` | Taker sell volume. |
+| `timestamp` | `integer` | Unix timestamp. |
+
 #### Verified Playbook usage notes
 
 - Returned fields include `timestamp`, `buy_vol`, `sell_vol`, and `buy_sell_ratio`.
@@ -1358,6 +2000,35 @@ Summary: Ticker
 | `vs_currency` | `no` | `string` | `usd` | Target currency for prices. Default is 'usd'. |
 | `include_market_data` | `no` | `boolean` | `true` | Use /coins/markets for richer data (market cap, volume, 24h change). Set to False to use /simple/price for a faster, lighter response. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Symbol representing the entity requested in the data. |
+| `exchange` | `string` | Exchange or venue the data was fetched from. |
+| `timestamp` | `string` | Timestamp of the ticker snapshot (UTC). |
+| `last` | `number` | Last traded price. |
+| `open` | `number` | The open price (24h rolling window). |
+| `high` | `number` | The high price (24h rolling window). |
+| `low` | `number` | The low price (24h rolling window). |
+| `bid` | `number` | Current best bid price. |
+| `ask` | `number` | Current best ask price. |
+| `vwap` | `number` | Volume Weighted Average Price over the period. |
+| `volume` | `number` | The trading volume (base currency, 24h). |
+| `quote_volume` | `number` | 24h trading volume in quote currency. |
+| `prev_close` | `number` | The previous close price. |
+| `change` | `number` | Absolute price change over 24h. |
+| `change_percent` | `number` | Percentage price change over 24h. |
+| `market_cap` | `number` | Market capitalization in quote currency. |
+| `bid_volume` | `number` | Volume at the best bid. |
+| `ask_volume` | `number` | Volume at the best ask. |
+| `average` | `number` | Average of open and last price. |
+| `coin_id` | `string` | CoinGecko coin identifier. |
+| `market_cap_rank` | `integer` | Market cap rank. |
+| `fully_diluted_valuation` | `number` | Fully diluted valuation in quote currency. |
+| `circulating_supply` | `number` | Circulating supply. |
+| `total_supply` | `number` | Total supply. |
+
 ---
 
 ### `crypto.futures.trades`
@@ -1385,6 +2056,19 @@ Summary: Trades
 | `limit` | `no` | `integer` | `100` | Number of most recent trades to return. |
 | `exchange` | `no` | `string` | `binance` | Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `trade_id` | `string` | Exchange-assigned trade ID. |
+| `symbol` | `string` | Trading pair symbol. |
+| `timestamp` | `string` | Trade execution time (UTC). |
+| `side` | `string` | Taker side: buy or sell. |
+| `price` | `number` | Execution price. |
+| `amount` | `number` | Trade size in base currency. |
+| `cost` | `number` | Trade value in quote currency (price × amount). |
+| `taker_or_maker` | `string` | Whether the trade was executed as taker or maker. |
+
 ---
 
 ### `crypto.global_defi`
@@ -1409,6 +2093,18 @@ Summary: Global Defi
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `defi_market_cap` | `number` | Total DeFi market capitalization in USD. |
+| `eth_market_cap` | `number` | Ethereum market capitalization in USD. |
+| `defi_to_eth_ratio` | `number` | Ratio of DeFi market cap to ETH market cap. |
+| `trading_volume_24h` | `number` | 24h DeFi trading volume in USD. |
+| `defi_dominance` | `number` | DeFi dominance as a percentage of total crypto market. |
+| `top_coin_name` | `string` | Name of the top DeFi coin by market cap. |
+| `top_coin_defi_dominance` | `number` | Top DeFi coin's dominance within the DeFi market. |
+
 ---
 
 ### `crypto.global_market`
@@ -1433,6 +2129,23 @@ Summary: Global Market
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `active_cryptocurrencies` | `integer` | Total number of active cryptocurrencies. |
+| `markets` | `integer` | Total number of markets (trading pairs). |
+| `total_market_cap_usd` | `number` | Total cryptocurrency market cap in USD. |
+| `total_volume_usd` | `number` | Total 24h trading volume in USD. |
+| `btc_dominance` | `number` | Bitcoin market dominance percentage. |
+| `eth_dominance` | `number` | Ethereum market dominance percentage. |
+| `market_cap_change_percentage_24h_usd` | `number` | 24h market cap change percentage. |
+| `defi_volume_24h` | `number` | DeFi 24h trading volume in USD. |
+| `defi_market_cap` | `number` | DeFi total market cap in USD. |
+| `defi_dominance` | `number` | DeFi dominance percentage of total market. |
+| `top_coin_name` | `string` | Name of the top DeFi coin. |
+| `top_coin_defi_dominance` | `number` | Top DeFi coin's dominance percentage. |
+
 ---
 
 ### `crypto.hyperliquid.account_long_short_ratio`
@@ -1462,6 +2175,18 @@ Summary: Account Long Short Ratio
 | `start_time` | `no` | `integer | null` | `-` | Start timestamp in milliseconds. |
 | `end_time` | `no` | `integer | null` | `-` | End timestamp in milliseconds. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `global_account_long_count` | `integer` | Number of accounts holding long positions. |
+| `global_account_short_count` | `integer` | Number of accounts holding short positions. |
+| `global_account_total_count` | `integer` | Total number of accounts. |
+| `global_account_long_percent` | `number` | Percentage of long accounts. |
+| `global_account_short_percent` | `number` | Percentage of short accounts. |
+| `global_account_long_short_ratio` | `number` | Long to short account ratio. |
+
 ---
 
 ### `crypto.hyperliquid.account_long_short_ratio_by_tag`
@@ -1492,6 +2217,17 @@ Summary: Account Long Short Ratio By Tag
 | `start_time` | `no` | `integer | null` | `-` | Start timestamp in milliseconds. Historical data starts from 2026-03-20 00:00:00 UTC. |
 | `end_time` | `no` | `integer | null` | `-` | End timestamp in milliseconds. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `group_name` | `string` | Wallet tag group name. |
+| `account_long_count` | `integer` | Number of long accounts. |
+| `account_short_count` | `integer` | Number of short accounts. |
+| `short_position_usd` | `number` | Short position value in USD. |
+| `long_position_usd` | `number` | Long position value in USD. |
+
 ---
 
 ### `crypto.hyperliquid.position_distribution_by_tag`
@@ -1521,6 +2257,24 @@ Summary: Position Distribution By Tag
 | `start_time` | `no` | `integer | null` | `-` | Start timestamp in milliseconds. Historical data starts from 2026-03-20 00:00:00 UTC. |
 | `end_time` | `no` | `integer | null` | `-` | End timestamp in milliseconds. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `group_name` | `string` | Wallet tag group name. |
+| `all_address_count` | `integer` | Total address count. |
+| `position_address_count` | `integer` | Address count with positions. |
+| `bias_score` | `number` | Long/short bias score. |
+| `bias_remark` | `string` | Sentiment label. |
+| `minimum_amount` | `number` | Minimum position range. |
+| `maximum_amount` | `number` | Maximum position range. |
+| `long_position_usd` | `number` | Long position value in USD. |
+| `short_position_usd` | `number` | Short position value in USD. |
+| `position_usd` | `number` | Total position value in USD. |
+| `profit_address_count` | `integer` | Profitable address count. |
+| `loss_address_count` | `integer` | Loss address count. |
+
 ---
 
 ### `crypto.hyperliquid.symbol_position`
@@ -1547,6 +2301,27 @@ Summary: Symbol Position
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 | `current_page` | `no` | `integer` | `1` | Current page number. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `user` | `string` | User wallet address. |
+| `symbol` | `string` | Trading symbol. |
+| `position_size` | `number` | Position size (positive for long, negative for short). |
+| `entry_price` | `number` | Entry price. |
+| `mark_price` | `number` | Current mark price. |
+| `liq_price` | `number` | Liquidation price. |
+| `leverage` | `integer` | Leverage multiplier. |
+| `margin_balance` | `number` | Margin balance in USD. |
+| `position_value_usd` | `number` | Position value in USD. |
+| `unrealized_pnl` | `number` | Unrealized profit and loss in USD. |
+| `funding_fee` | `number` | Funding fee in USD. |
+| `margin_mode` | `string` | Margin mode (cross or isolated). |
+| `create_time` | `string` | Position creation time. |
+| `update_time` | `string` | Last update time. |
+| `total_pages` | `integer` | Total number of pages. |
+| `current_page` | `integer` | Current page number. |
+
 ---
 
 ### `crypto.hyperliquid.user_position`
@@ -1572,6 +2347,16 @@ Summary: User Position
 |---|---|---|---|---|
 | `user_address` | `yes` | `string` | `-` | User wallet address. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `margin_summary` | `object` | Margin summary including account value, total position, and margin used. |
+| `cross_margin_summary` | `object` | Cross margin summary. |
+| `cross_maintenance_margin_used` | `number` | Cross maintenance margin used. |
+| `withdrawable` | `number` | Withdrawable balance. |
+| `asset_positions` | `array` | List of asset positions with details. |
+
 ---
 
 ### `crypto.hyperliquid.wallet_pnl_distribution`
@@ -1596,6 +2381,28 @@ Summary: Wallet Pnl Distribution
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `group_name` | `string` | PNL tier label (money_printer, smart_money, grinder, humble_earner, exit_liquidity, semi_rekt, full_rekt, giga_rekt). |
+| `all_address_count` | `integer` | Total address count. |
+| `position_address_count` | `integer` | Address count with positions. |
+| `position_address_percent` | `number` | Percentage of addresses with positions. |
+| `bias_score` | `number` | Long/short bias score. |
+| `bias_remark` | `string` | Sentiment label (bearish, slightly_bearish, indecisive, bullish, very_bullish). |
+| `minimum_amount` | `number` | Minimum PNL range. |
+| `maximum_amount` | `number` | Maximum PNL range. |
+| `long_position_usd` | `number` | Long position value in USD. |
+| `short_position_usd` | `number` | Short position value in USD. |
+| `long_position_usd_percent` | `number` | Long position value percentage. |
+| `short_position_usd_percent` | `number` | Short position value percentage. |
+| `position_usd` | `number` | Total position value in USD. |
+| `profit_address_count` | `integer` | Profitable address count. |
+| `loss_address_count` | `integer` | Loss address count. |
+| `profit_address_percent` | `number` | Profitable address percentage. |
+| `loss_address_percent` | `number` | Loss address percentage. |
+
 ---
 
 ### `crypto.hyperliquid.wallet_position_distribution`
@@ -1620,6 +2427,28 @@ Summary: Wallet Position Distribution
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `group_name` | `string` | Position tier label (shrimp, fish, dolphin, apex_predator, small_whale, whale, tidal_whale, leviathan). |
+| `all_address_count` | `integer` | Total address count. |
+| `position_address_count` | `integer` | Address count with positions. |
+| `position_address_percent` | `number` | Percentage of addresses with positions. |
+| `bias_score` | `number` | Long/short bias score. |
+| `bias_remark` | `string` | Sentiment label (bearish, slightly_bearish, indecisive, bullish, very_bullish). |
+| `minimum_amount` | `number` | Minimum position range. |
+| `maximum_amount` | `number` | Maximum position range. |
+| `long_position_usd` | `number` | Long position value in USD. |
+| `short_position_usd` | `number` | Short position value in USD. |
+| `long_position_usd_percent` | `number` | Long position value percentage. |
+| `short_position_usd_percent` | `number` | Short position value percentage. |
+| `position_usd` | `number` | Total position value in USD. |
+| `profit_address_count` | `integer` | Profitable address count. |
+| `loss_address_count` | `integer` | Loss address count. |
+| `profit_address_percent` | `number` | Profitable address percentage. |
+| `loss_address_percent` | `number` | Loss address percentage. |
+
 ---
 
 ### `crypto.hyperliquid.whale_alert`
@@ -1644,6 +2473,19 @@ Summary: Whale Alert
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `user` | `string` | User wallet address. |
+| `symbol` | `string` | Trading symbol. |
+| `position_size` | `number` | Position size (positive for long, negative for short). |
+| `entry_price` | `number` | Entry price. |
+| `liq_price` | `number` | Liquidation price. |
+| `position_value_usd` | `number` | Position value in USD. |
+| `position_action` | `integer` | Position action type (1: open, 2: close). |
+| `create_time` | `string` | Position creation time. |
+
 ---
 
 ### `crypto.hyperliquid.whale_position`
@@ -1668,15 +2510,34 @@ Summary: Whale Position
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `user` | `string` | User wallet address. |
+| `symbol` | `string` | Trading symbol. |
+| `position_size` | `number` | Position size (positive for long, negative for short). |
+| `entry_price` | `number` | Entry price. |
+| `mark_price` | `number` | Current mark price. |
+| `liq_price` | `number` | Liquidation price. |
+| `leverage` | `integer` | Leverage multiplier. |
+| `margin_balance` | `number` | Margin balance in USD. |
+| `position_value_usd` | `number` | Position value in USD. |
+| `unrealized_pnl` | `number` | Unrealized profit and loss in USD. |
+| `funding_fee` | `number` | Funding fee in USD. |
+| `margin_mode` | `string` | Margin mode (cross or isolated). |
+| `create_time` | `string` | Position creation time. |
+| `update_time` | `string` | Last update time. |
+
 ---
 
 ### `crypto.market`
 
 ```python
-data.crypto.market(market_type=None, exchange='binance')
+data.crypto.market(symbol=None, exchange=None, base=None, market_type=None, is_rwa=None, category=None, page=None, size=None)
 ```
 
-Summary: Market
+Summary: Market — trading instrument info. Supports two providers: **ccxt** (live exchange data via CCXT library) and **bitget_data** (internal `upex_market_info` table via AGENT_DATA_QUERY service).
 
 | Field | Value |
 |---|---|
@@ -1685,42 +2546,100 @@ Summary: Market
 | Path | `/inner/v1/agent-data/crypto/market` |
 | SDK | `supported` |
 | Host | `supported` |
-| Notes | - |
+| Notes | ccxt: calls `exchange.fetch_markets()` on the specified exchange. bitget_data: calls `/inner/agent-data-query/markets`; for Bitget exchange queries, RWA r-prefix mapping is applied automatically (e.g. TSLA/USDT → rTSLA/USDT). |
 
 #### Query parameters
 
+Parameters differ by provider. All parameters are optional unless noted.
+
+**ccxt** provider:
+
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
-| `market_type` | `no` | `string | null` | `-` | Filter by market type. Returns all types when omitted. |
-| `exchange` | `no` | `string` | `binance` | Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid. |
+| `exchange` | `yes` | `string` | `binance` | Exchange to query. enum: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid. |
+| `symbol` | `no` | `string / null` | `-` | Trading pair symbol (e.g. 'BTC/USDT'). Filters results to this symbol. |
+| `base` | `no` | `string / null` | `-` | Base currency filter (e.g. 'BTC'). |
+| `market_type` | `no` | `string / null` | `-` | enum: spot, perpetual, future, option. Market type filter. |
+| `is_rwa` | `no` | `boolean / null` | `-` | Filter by Real World Asset status. Populated only for bitget exchange. |
 
----
+**bitget_data** provider:
 
-### `crypto.market.markets_list`
+| Param | Required | Type | Default | Notes |
+|---|---|---|---|---|
+| `symbol` | `no` | `string / null` | `-` | Trading pair symbol (e.g. 'BTC/USDT'). Returns all market entries for this symbol across exchanges. |
+| `exchange` | `no` | `string / null` | `-` | Exchange identifier (e.g. 'binance', 'bitget'). Returns all tradable pairs on this exchange. |
+| `base` | `no` | `string / null` | `-` | Base currency filter (e.g. 'BTC'). |
+| `market_type` | `no` | `string / null` | `-` | enum: spot, perpetual, future, option. Market type filter. |
+| `is_rwa` | `no` | `boolean / null` | `-` | Filter by Real World Asset status. True = RWA only; False = exclude RWA. |
+| `category` | `no` | `string / null` | `-` | Filter by asset category (e.g. 'Stocks', 'ETF', 'Commodity'). |
+| `page` | `no` | `integer / null` | `1` | Page number (1-based). |
+| `size` | `no` | `integer / null` | `20` | Number of rows per page. Maximum 200. |
 
-```python
-data.crypto.market.markets_list(symbol=None, exchange=None, type=None, limit=100)
-```
+#### Response fields
 
-Summary: Markets List
+Common fields (all providers):
 
-| Field | Value |
-|---|---|
-| Endpoint ID | `crypto.market.markets_list` |
-| HTTP | `GET` |
-| Path | `/inner/v1/agent-data/crypto/market/markets_list` |
-| SDK | `supported` |
-| Host | `supported` |
-| Notes | - |
+| Field | Type | Notes |
+|---|---|---|
+| `exchange` | `string` | Exchange identifier (e.g. 'binance', 'bitget'). |
+| `symbol` | `string` | Unified trading pair symbol (e.g. 'BTC/USDT', 'BTC/USDT:USDT'). |
+| `base` | `string` | Base currency (e.g. 'BTC'). |
+| `quote` | `string` | Quote currency (e.g. 'USDT'). |
+| `market_type` | `string` | Market type: spot, perpetual, future, or option. |
+| `is_rwa` | `boolean / null` | Whether the instrument is a Real World Asset (stock/ETF/commodity) contract. Populated by ccxt (bitget exchange only) and bitget_data. |
+| `category` | `string / null` | Asset category (e.g. 'Stocks', 'ETF', 'Commodity'). bitget_data only. |
 
-#### Query parameters
+Extended fields — **ccxt** provider only:
 
-| Param | Required | Type | Default | Notes |
-|---|---|---|---|---|
-| `symbol` | `no` | `string | null` | `-` | Trading pair symbol to query (e.g. 'BTC/USDT', 'ETH/USDT'). |
-| `exchange` | `no` | `string | null` | `-` | Exchange identifier to query (e.g. 'binance', 'okx'). |
-| `type` | `no` | `string | null` | `-` | Market type filter: 'spot', 'perpetual', or 'future'. |
-| `limit` | `no` | `integer | null` | `100` | Maximum number of entries to return. |
+| Field | Type | Notes |
+|---|---|---|
+| `settle` | `string / null` | Settlement currency for derivatives (e.g. 'USDT' for linear, 'BTC' for inverse). |
+| `active` | `boolean / null` | Whether the market is currently active/tradable. |
+| `linear` | `boolean / null` | True for linear (USDT-margined) contracts. |
+| `inverse` | `boolean / null` | True for inverse (coin-margined) contracts. |
+| `contract_size` | `number / null` | Contract multiplier — size of one contract in base currency (derivatives only). |
+| `expiry` | `string / null` | Expiry datetime for dated futures/options (UTC). |
+| `exchange_id` | `string / null` | Exchange-native instrument ID (e.g. 'BTCUSDT'). |
+| `taker` | `number / null` | Taker fee rate (e.g. 0.001 = 0.1%). |
+| `maker` | `number / null` | Maker fee rate (e.g. 0.001 = 0.1%). |
+| `precision_price` | `number / null` | Minimum price tick size. |
+| `precision_amount` | `number / null` | Minimum order size in base currency. |
+
+Extended fields — **bitget_data** provider only:
+
+Core fields (all market types):
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol_type` | `string / null` | Asset type of the trading pair: crypto, metal, stock, or commodity. |
+| `status` | `string / null` | Market status: listed, online, limit_open, limit_close, offline, or restrictedAPI. |
+| `launch_time` | `string / null` | Launch time of the trading pair (Unix ms timestamp). |
+| `off_time` | `string / null` | Trading halt time (Unix ms timestamp). Empty string if not configured. |
+| `limit_open_time` | `string / null` | Restricted open time (Unix ms timestamp). Non-empty means the symbol is under maintenance. |
+| `price_precision` | `string / null` | Number of allowed decimal places for price. |
+| `quantity_precision` | `string / null` | Number of allowed decimal places for quantity. |
+| `quote_precision` | `string / null` | Number of allowed decimal places for the quote currency amount in market orders. |
+| `price_multiplier` | `string / null` | Price step for derivatives orders (used together with price_precision). |
+| `quantity_multiplier` | `string / null` | Quantity step for derivatives orders (used together with quantity_precision). |
+| `min_order_qty` | `string / null` | Minimum order quantity in base currency (derivatives only). |
+| `max_order_qty` | `string / null` | Maximum quantity for a single limit order in base currency. '0' means unlimited. |
+| `min_order_amount` | `string / null` | Minimum order value in quote currency. |
+| `max_market_order_qty` | `string / null` | Maximum quantity for a single market order in base currency. |
+| `max_symbol_order_num` | `string / null` | Maximum number of outstanding orders per symbol per account. |
+| `max_position_num` | `string / null` | Maximum number of open positions per symbol per account. |
+| `buy_limit_price_ratio` | `string / null` | Buy limit price ratio relative to market price (max buy price cap). |
+| `sell_limit_price_ratio` | `string / null` | Sell limit price ratio relative to market price (min sell price floor). |
+| `maker_fee_rate` | `string / null` | Maker (limit order) fee rate as a decimal (e.g. '0.0002' = 0.02%). |
+| `taker_fee_rate` | `string / null` | Taker (market order) fee rate as a decimal (e.g. '0.0002' = 0.02%). |
+
+Derivatives-only fields (perpetual / futures; `null` for spot):
+
+| Field | Type | Notes |
+|---|---|---|
+| `min_leverage` | `string / null` | Minimum leverage. |
+| `max_leverage` | `string / null` | Maximum leverage. |
+| `max_crossed_leverage` | `string / null` | Maximum leverage in cross-margin mode. |
+| `max_isolated_leverage` | `string / null` | Maximum leverage in isolated-margin mode. |
 
 ---
 
@@ -1748,6 +2667,16 @@ Summary: Market Dominance
 | `symbol` | `no` | `string | null` | `-` | Symbol to get data for. If not provided, returns top cryptocurrencies. |
 | `interval` | `no` | `string | null` | `1d` | Time interval for the data. Default is '1d'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `dominance` | `number` | Market dominance percentage (market cap / total market cap * 100). |
+| `market_cap` | `number` | Market capitalization in USD. |
+| `total_market_cap` | `number` | Total cryptocurrency market capitalization in USD. |
+
 ---
 
 ### `crypto.nft_info`
@@ -1773,6 +2702,24 @@ Summary: Nft Info
 |---|---|---|---|---|
 | `nft_id` | `yes` | `string` | `-` | CoinGecko NFT ID e.g. 'pudgy-penguins'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | CoinGecko NFT collection ID. |
+| `name` | `string` | NFT collection name. |
+| `symbol` | `string` | NFT collection symbol. |
+| `contract_address` | `string` | NFT contract address. |
+| `asset_platform_id` | `string` | Asset platform identifier. |
+| `image` | `string` | Small image URL for the collection. |
+| `description` | `string` | Collection description. |
+| `floor_price_usd` | `number` | Floor price in USD. |
+| `market_cap_usd` | `number` | Market cap in USD. |
+| `volume_24h_usd` | `number` | 24h volume in USD. |
+| `floor_price_change_24h_pct` | `number` | Floor price 24h percentage change in USD. |
+| `number_of_unique_addresses` | `integer` | Number of unique holder addresses. |
+| `total_supply` | `number` | Total supply of the NFT collection. |
+
 ---
 
 ### `crypto.nft_list`
@@ -1799,6 +2746,16 @@ Summary: Nft List
 | `per_page` | `no` | `integer | null` | `-` | Number of results per page. |
 | `page` | `no` | `integer | null` | `-` | Page number for paginated results. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | CoinGecko NFT collection ID. |
+| `contract_address` | `string` | NFT contract address. |
+| `name` | `string` | NFT collection name. |
+| `asset_platform_id` | `string` | Asset platform identifier (e.g. 'ethereum'). |
+| `symbol` | `string` | NFT collection symbol. |
+
 ---
 
 ### `crypto.onchain.active_addresses`
@@ -1825,6 +2782,17 @@ Summary: Active Addresses
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 | `interval` | `no` | `string | null` | `1d` | Time interval for the data. Default is '1d'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `active_addresses` | `integer` | Number of active addresses on the blockchain network. |
+| `new_addresses` | `integer` | Number of new addresses created. |
+| `sending_addresses` | `integer` | Number of addresses sending transactions. |
+| `receiving_addresses` | `integer` | Number of addresses receiving transactions. |
+
 ---
 
 ### `crypto.onchain.dexes`
@@ -1851,6 +2819,13 @@ Summary: Dexes
 | `network` | `yes` | `string` | `-` | Network identifier, e.g. 'eth', 'bsc'. |
 | `page` | `no` | `integer | null` | `-` | Page number for pagination. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | DEX identifier. |
+| `name` | `string` | DEX name. |
+
 ---
 
 ### `crypto.onchain.exchange_flows`
@@ -1878,6 +2853,19 @@ Summary: Exchange Flows
 | `interval` | `no` | `string | null` | `1d` | Time interval for the data. Default is '1d'. |
 | `exchange` | `no` | `string | null` | `-` | Specific exchange to query. If not provided, returns aggregated data. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `exchange` | `string` | Exchange name. None if aggregated across all exchanges. |
+| `inflow` | `number` | Amount flowing into exchanges (in native tokens). |
+| `outflow` | `number` | Amount flowing out of exchanges (in native tokens). |
+| `net_flow` | `number` | Net flow (inflow - outflow). |
+| `inflow_transactions` | `integer` | Number of inflow transactions. |
+| `outflow_transactions` | `integer` | Number of outflow transactions. |
+
 ---
 
 ### `crypto.onchain.fund_flow`
@@ -1903,6 +2891,22 @@ Summary: Fund Flow
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `time` | `string` | Data timestamp. |
+| `sell_amount_24h` | `number` | Total sell amount in token units over 24 hours. |
+| `sell_value_24h` | `number` | Total sell value in USD over 24 hours. |
+| `buy_amount_24h` | `number` | Total buy amount in token units over 24 hours. |
+| `buy_value_24h` | `number` | Total buy value in USD over 24 hours. |
+| `cex_inflow_1h` | `number` | CEX inflow amount over 1 hour. |
+| `cex_outflow_1h` | `number` | CEX outflow amount over 1 hour. |
+| `cex_inflow_6h` | `number` | CEX inflow amount over 6 hours. |
+| `cex_outflow_6h` | `number` | CEX outflow amount over 6 hours. |
+| `cex_inflow_24h` | `number` | CEX inflow amount over 24 hours. |
+| `cex_outflow_24h` | `number` | CEX outflow amount over 24 hours. |
+
 ---
 
 ### `crypto.onchain.holder_statics`
@@ -1928,6 +2932,23 @@ Summary: Holder Statics
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `time` | `string` | Data timestamp. |
+| `chain` | `string` | Blockchain network name. |
+| `token_address` | `string` | Token contract address on the chain. |
+| `holders` | `integer` | Total number of token holders. |
+| `hold_hhi` | `number` | Herfindahl-Hirschman Index for holder concentration. |
+| `total_supply` | `number` | Total token supply. |
+| `circulating_supply` | `number` | Circulating token supply. |
+| `cex_amount` | `number` | Amount held by centralized exchanges. |
+| `dex_pool_amount` | `number` | Amount in DEX liquidity pools. |
+| `staking_amount` | `number` | Amount staked. |
+| `lending_amount` | `number` | Amount in lending protocols. |
+| `top_100_address_hold_percentage` | `number` | Percentage held by top 100 addresses. |
+
 ---
 
 ### `crypto.onchain.hyperliquid_liquidation_map`
@@ -1953,6 +2974,14 @@ Summary: Hyperliquid Liquidation Map
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Symbol to get data for. |
+| `liquidation_price` | `number` | Liquidation price level. |
+| `liquidation_intensity` | `number` | Liquidation intensity at this price level (in USD). |
+
 ---
 
 ### `crypto.onchain.liquidity`
@@ -1979,6 +3008,17 @@ Summary: Liquidity
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 | `chain` | `no` | `string | null` | `-` | Blockchain network (e.g., 'BSC', 'ETH', 'SOL'). If not provided, returns all chains. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `time` | `string` | Data timestamp. |
+| `symbol` | `string` | Symbol to get data for. |
+| `chain` | `string` | Blockchain network name. |
+| `token_address` | `string` | Token contract address on the chain. |
+| `price` | `number` | Token price in USD. |
+| `liquidity` | `number` | Aggregated DEX liquidity amount in USD. |
+
 ---
 
 ### `crypto.onchain.networks`
@@ -2004,6 +3044,14 @@ Summary: Networks
 |---|---|---|---|---|
 | `page` | `no` | `integer | null` | `-` | Page number for pagination. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | Network identifier, e.g. 'eth', 'bsc'. |
+| `name` | `string` | Network name. |
+| `coingecko_asset_platform_id` | `string` | CoinGecko asset platform identifier. |
+
 ---
 
 ### `crypto.onchain.pool_detail`
@@ -2030,6 +3078,24 @@ Summary: Pool Detail
 | `network` | `yes` | `string` | `-` | Network identifier, e.g. 'eth'. |
 | `pool_address` | `yes` | `string` | `-` | Pool address(es). Comma-separated for multi-pool query. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | Pool identifier. |
+| `name` | `string` | Pool name, e.g. 'USDC / WETH'. |
+| `address` | `string` | Pool contract address. |
+| `base_token_price_usd` | `number` | Base token price in USD. |
+| `quote_token_price_usd` | `number` | Quote token price in USD. |
+| `fdv_usd` | `number` | Fully diluted valuation in USD. |
+| `market_cap_usd` | `number` | Market cap in USD. |
+| `reserve_in_usd` | `number` | Total reserve in USD. |
+| `volume_usd_h_24` | `number` | 24-hour trading volume in USD. |
+| `price_change_h_24` | `number` | 24-hour price change percentage. |
+| `buys_h_24` | `integer` | Number of buy transactions in the last 24 hours. |
+| `sells_h_24` | `integer` | Number of sell transactions in the last 24 hours. |
+| `pool_created_at` | `string` | Pool creation timestamp. |
+
 ---
 
 ### `crypto.onchain.pool_ohlcv`
@@ -2062,6 +3128,18 @@ Summary: Pool Ohlcv
 | `limit` | `no` | `integer | null` | `-` | Number of OHLCV data points. |
 | `currency` | `no` | `string | null` | `-` | Price currency: 'usd' or 'token'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `open` | `number` | The open price. |
+| `high` | `number` | The high price. |
+| `low` | `number` | The low price. |
+| `close` | `number` | The close price. |
+| `volume` | `number` | The trading volume. |
+| `vwap` | `number` | Volume Weighted Average Price over the period. |
+
 ---
 
 ### `crypto.onchain.pool_trades`
@@ -2089,6 +3167,21 @@ Summary: Pool Trades
 | `pool_address` | `yes` | `string` | `-` | Pool contract address. |
 | `trade_volume_in_usd_greater_than` | `no` | `number | null` | `-` | Filter by minimum trade volume in USD. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `block_timestamp` | `string` | Block timestamp of the trade. |
+| `tx_hash` | `string` | Transaction hash. |
+| `kind` | `string` | Trade kind: 'buy' or 'sell'. |
+| `from_token_symbol` | `string` | Symbol of the source token. |
+| `from_token_amount` | `string` | Amount of the source token. |
+| `to_token_symbol` | `string` | Symbol of the destination token. |
+| `to_token_amount` | `string` | Amount of the destination token. |
+| `price_from_in_usd` | `string` | Source token price in USD. |
+| `price_to_in_usd` | `string` | Destination token price in USD. |
+| `volume_in_usd` | `string` | Trade volume in USD. |
+
 ---
 
 ### `crypto.onchain.pools`
@@ -2117,6 +3210,24 @@ Summary: Pools
 | `token_address` | `no` | `string | null` | `-` | Token contract address. Required for 'token_pools'. |
 | `page` | `no` | `integer | null` | `-` | Page number for pagination. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | Pool identifier. |
+| `name` | `string` | Pool name, e.g. 'USDC / WETH'. |
+| `address` | `string` | Pool contract address. |
+| `base_token_price_usd` | `number` | Base token price in USD. |
+| `quote_token_price_usd` | `number` | Quote token price in USD. |
+| `fdv_usd` | `number` | Fully diluted valuation in USD. |
+| `market_cap_usd` | `number` | Market cap in USD. |
+| `reserve_in_usd` | `number` | Total reserve in USD. |
+| `volume_usd_h_24` | `number` | 24-hour trading volume in USD. |
+| `price_change_h_24` | `number` | 24-hour price change percentage. |
+| `buys_h_24` | `integer` | Number of buy transactions in the last 24 hours. |
+| `sells_h_24` | `integer` | Number of sell transactions in the last 24 hours. |
+| `pool_created_at` | `string` | Pool creation timestamp. |
+
 ---
 
 ### `crypto.onchain.search_pools`
@@ -2144,6 +3255,24 @@ Summary: Search Pools
 | `network` | `no` | `string | null` | `-` | Network identifier to filter results, e.g. 'eth'. |
 | `page` | `no` | `integer | null` | `-` | Page number for pagination. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | Pool identifier. |
+| `name` | `string` | Pool name, e.g. 'USDC / WETH'. |
+| `address` | `string` | Pool contract address. |
+| `base_token_price_usd` | `number` | Base token price in USD. |
+| `quote_token_price_usd` | `number` | Quote token price in USD. |
+| `fdv_usd` | `number` | Fully diluted valuation in USD. |
+| `market_cap_usd` | `number` | Market cap in USD. |
+| `reserve_in_usd` | `number` | Total reserve in USD. |
+| `volume_usd_h_24` | `number` | 24-hour trading volume in USD. |
+| `price_change_h_24` | `number` | 24-hour price change percentage. |
+| `buys_h_24` | `integer` | Number of buy transactions in the last 24 hours. |
+| `sells_h_24` | `integer` | Number of sell transactions in the last 24 hours. |
+| `pool_created_at` | `string` | Pool creation timestamp. |
+
 ---
 
 ### `crypto.onchain.token_data`
@@ -2170,6 +3299,22 @@ Summary: Token Data
 | `network` | `yes` | `string` | `-` | Network ID e.g. 'eth'. |
 | `address` | `yes` | `string` | `-` | Token contract address. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | Token identifier. |
+| `name` | `string` | Token name. |
+| `symbol` | `string` | Token symbol. |
+| `address` | `string` | Token contract address. |
+| `decimals` | `integer` | Token decimals. |
+| `coingecko_coin_id` | `string` | CoinGecko coin ID. |
+| `price_usd` | `number` | Token price in USD. |
+| `fdv_usd` | `number` | Fully diluted valuation in USD. |
+| `total_reserve_in_usd` | `number` | Total reserve in USD. |
+| `volume_usd_h_24` | `number` | 24-hour trading volume in USD. |
+| `market_cap_usd` | `number` | Market cap in USD. |
+
 ---
 
 ### `crypto.onchain.token_info`
@@ -2196,6 +3341,21 @@ Summary: Token Info
 | `network` | `yes` | `string` | `-` | Network ID e.g. 'eth'. |
 | `address` | `yes` | `string` | `-` | Token contract address. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | `string` | Token identifier. |
+| `name` | `string` | Token name. |
+| `symbol` | `string` | Token symbol. |
+| `coingecko_coin_id` | `string` | CoinGecko coin ID. |
+| `image_url` | `string` | Token image URL. |
+| `description` | `string` | Token description. |
+| `websites` | `array` | Official website URLs. |
+| `discord_url` | `string` | Discord URL. |
+| `telegram_handle` | `string` | Telegram handle. |
+| `twitter_handle` | `string` | Twitter/X handle. |
+
 ---
 
 ### `crypto.onchain.token_price`
@@ -2222,6 +3382,17 @@ Summary: Token Price
 | `network` | `yes` | `string` | `-` | Network ID e.g. 'eth'. |
 | `addresses` | `yes` | `string` | `-` | Token contract address(es), comma-separated. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `contract_address` | `string` | Token contract address. |
+| `price` | `number` | Token price in the target currency. |
+| `market_cap` | `number` | Market capitalization. |
+| `volume_24h` | `number` | 24-hour trading volume. |
+| `change_24h` | `number` | 24-hour price change percentage. |
+| `last_updated_at` | `integer` | Last update timestamp (UNIX). |
+
 ---
 
 ### `crypto.onchain.token_unlock_event`
@@ -2247,6 +3418,17 @@ Summary: Token Unlock Event
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `token_address` | `string` | Token contract address. |
+| `total_supply` | `number` | Total token supply. |
+| `circulate_supply` | `number` | Current circulating token supply. |
+| `unlock_time` | `string` | Scheduled unlock event timestamp. |
+| `unlock_amount` | `number` | Number of tokens to be unlocked. |
+| `unlock_percentage` | `number` | Percentage of total supply to be unlocked. |
+
 ---
 
 ### `crypto.onchain.trading_signal`
@@ -2273,6 +3455,15 @@ Summary: Trading Signal
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 | `signal_types` | `no` | `array | null` | `-` | accepts array values List of signal type IDs to filter. 1=whale large inflow, 2=whale large outflow, 3=net buy signal, 4=net sell signal. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `time` | `string` | Signal timestamp. |
+| `symbol` | `string` | Symbol to get data for. |
+| `signal_type` | `integer` | Signal type ID. 1=whale large inflow, 2=whale large outflow, 3=net buy signal, 4=net sell signal. |
+| `signal_text` | `string` | Human-readable signal description. |
+
 ---
 
 ### `crypto.onchain.whale_transactions`
@@ -2300,6 +3491,17 @@ Summary: Whale Transactions
 | `min_amount` | `no` | `number | null` | `-` | Minimum transaction amount threshold in USD. If not provided, uses API default. |
 | `interval` | `no` | `string | null` | `1h` | Time interval for the data. Default is '1h'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `transaction_count` | `integer` | Number of large transactions (whale transactions). |
+| `total_amount` | `number` | Total amount transacted in USD. |
+| `average_amount` | `number` | Average transaction amount in USD. |
+| `largest_transaction` | `number` | Largest single transaction amount in USD. |
+
 ---
 
 ### `crypto.options.open_interest`
@@ -2326,6 +3528,17 @@ Summary: Open Interest
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 | `interval` | `no` | `string | null` | `1d` | Time interval for the data. Default is '1d'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `call_oi` | `number` | Call option open interest. |
+| `put_oi` | `number` | Put option open interest. |
+| `total_oi` | `number` | Total options open interest (calls + puts). |
+| `put_call_oi_ratio` | `number` | Put/Call open interest ratio. |
+
 ---
 
 ### `crypto.options.volume`
@@ -2353,6 +3566,17 @@ Summary: Volume
 | `interval` | `no` | `string | null` | `1d` | Time interval for the data. Default is '1d'. |
 | `option_type` | `no` | `string | null` | `all` | Option type: 'call', 'put', or 'all'. Default is 'all'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `call_volume` | `number` | Call option trading volume. |
+| `put_volume` | `number` | Put option trading volume. |
+| `total_volume` | `number` | Total options trading volume (calls + puts). |
+| `put_call_ratio` | `number` | Put/Call volume ratio. |
+
 ---
 
 ### `crypto.search`
@@ -2378,6 +3602,20 @@ Summary: Search
 |---|---|---|---|---|
 | `query` | `no` | `string | null` | `-` | Search query. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Symbol representing the entity requested in the data. |
+| `name` | `string` | Name of the crypto. |
+| `exchange` | `string` | The exchange code the crypto trades on. |
+| `ico_date` | `string` | The ICO date of the token. |
+| `circulating_supply` | `number` | The circulating supply of the token. |
+| `total_supply` | `number` | The total supply of the token. |
+| `coin_id` | `string` | CoinGecko coin identifier. |
+| `market_cap_rank` | `integer` | Market cap rank. |
+| `thumb` | `string` | Small icon URL. |
+
 ---
 
 ### `crypto.sentiment.crypto_fear_greed`
@@ -2404,6 +3642,14 @@ Summary: Crypto Fear Greed
 | `limit` | `no` | `integer` | `30` | Number of days of historical data to return. Default 30. Use 0 for all available data. |
 | `interval` | `no` | `string | null` | `-` | Time interval for historical data (e.g. '1d', '1h', '4h'). Provider-specific. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | Datetime of the index reading. |
+| `value` | `integer` | Fear & Greed Index value (0-100). 0 = Extreme Fear, 50 = Neutral, 100 = Extreme Greed. |
+| `classification` | `string` | Human-readable classification: 'Extreme Fear', 'Fear', 'Neutral', 'Greed', 'Extreme Greed'. |
+
 ---
 
 ### `crypto.spot.exchange_volume`
@@ -2430,12 +3676,22 @@ Summary: Exchange Volume
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 | `exchange` | `no` | `string | null` | `-` | Specific exchange to query. If not provided, returns all exchanges. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `exchange` | `string` | Exchange name. |
+| `volume` | `number` | Trading volume in USD. |
+| `volume_percentage` | `number` | Percentage of total volume across all exchanges. |
+
 ---
 
 ### `crypto.spot.kline`
 
 ```python
-data.crypto.spot.kline(symbol=..., start_time=None, end_time=None, interval='1d', exchange='binance', limit=200, vs_currency='usd', data_type='ohlc', days=30, exchanges=None)
+data.crypto.spot.kline(symbol=..., interval='1d', exchange='binance', limit=1000, start_time=None, end_time=None, start_date=None, end_date=None, days=None, vs_currency='usd', data_type='ohlc', exchanges=None)
 ```
 
 Summary: Kline
@@ -2454,16 +3710,35 @@ Summary: Kline
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. Multiple comma separated items allowed |
-| `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
-| `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
-| `interval` | `no` | `string` | `1d` | Candlestick interval.; Data interval. Supported values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 1w.; Time interval of the data to return. |
-| `exchange` | `no` | `string` | `binance` | Exchange identifier (e.g. 'binance', 'okx', 'gate').; Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid.; Exchange name (e.g., Binance, OKX). Use support-exchange-pair API to get supported exchanges. |
-| `limit` | `no` | `integer | null` | `200` | Maximum number of candles to return.; Number of candles per API request. Maximum varies by exchange (typically 500–1500).; Number of data points to return. Default: 1000, Max: 1000. |
+| `interval` | `no` | `string` | `1d` | Candlestick interval. Supported values: 5m, 15m, 1h, 4h, 1d. |
+| `exchange` | `no` | `string` | `binance` | Exchange identifier. Supported: binance, bitget. |
+| `limit` | `no` | `integer | null` | `1000` | Maximum number of candles to return. Capped at 1000. |
+| `start_time` | `no` | `integer | null` | `-` | Start time as Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
+| `end_time` | `no` | `integer | null` | `-` | End time as Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
+| `start_date` | `no` | `string | null` | `-` | Start date in YYYY-MM-DD format. Defaults to 90 days ago when neither start_date nor days is specified. |
+| `end_date` | `no` | `string | null` | `-` | End date in YYYY-MM-DD format. Defaults to today. |
+| `days` | `no` | `integer | null` | `-` | Number of days to look back from end_date (or today). Range: 1–90. Takes precedence over start_date when both are provided. |
 | `vs_currency` | `no` | `string` | `usd` | Target currency for prices. Default is 'usd'. |
 | `data_type` | `no` | `string` | `ohlc` | enum: ohlc, market_chart Data type: 'ohlc' for OHLC candles, 'market_chart' for close-only price history. |
-| `days` | `no` | `integer` | `30` | Number of days of historical data. Used when start_date/end_date are not set. |
 | `exchanges` | `no` | `array | string | null` | `-` | accepts array values To limit the query to a subset of exchanges e.g. ['POLONIEX', 'GDAX'] Multiple comma separated items allowed. |
 
+> **Time range**: Maximum window is **90 days**. The window is automatically clamped if start/end exceeds this limit.
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `open` | `number` | The open price. |
+| `high` | `number` | The high price. |
+| `low` | `number` | The low price. |
+| `close` | `number` | The close price. |
+| `volume` | `number` | The trading volume. |
+| `vwap` | `number` | Volume Weighted Average Price over the period. |
+| `exchange` | `string` | Exchange the data was fetched from. |
+| `symbol` | `string` | Trading pair symbol. |
+| `interval` | `string` | Candlestick interval. |
+
 #### Verified Playbook usage notes
 
 - Use this endpoint for spot OHLCV. For contract / futures Playbooks, use `crypto.futures.kline` instead.
@@ -2521,6 +3796,19 @@ Summary: Price Spread
 | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
 | `interval` | `no` | `string | null` | `1h` | Time interval for the data. Default is '1h'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `date` | `string` | The date of the data. |
+| `symbol` | `string` | Symbol to get data for. |
+| `max_price` | `number` | Highest price across all exchanges. |
+| `min_price` | `number` | Lowest price across all exchanges. |
+| `spread` | `number` | Absolute price difference (max - min). |
+| `spread_percentage` | `number` | Price spread as a percentage of the average price. |
+| `max_exchange` | `string` | Exchange with the highest price. |
+| `min_exchange` | `string` | Exchange with the lowest price. |
+
 ---
 
 ### `crypto.spot.taker_volume`
@@ -2551,6 +3839,15 @@ Summary: Taker Volume
 | `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
 | `exchange` | `no` | `string` | `Binance` | Exchange name (e.g. Binance, OKX, Bybit). Can be obtained from support-exchange-pair endpoint. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `buy_sell_ratio` | `number` | Taker buy to sell volume ratio. |
+| `buy_vol` | `number` | Taker buy volume. |
+| `sell_vol` | `number` | Taker sell volume. |
+| `timestamp` | `integer` | Unix timestamp. |
+
 ---
 
 ### `crypto.spot.ticker`
@@ -2579,6 +3876,35 @@ Summary: Ticker
 | `vs_currency` | `no` | `string` | `usd` | Target currency for prices. Default is 'usd'. |
 | `include_market_data` | `no` | `boolean` | `true` | Use /coins/markets for richer data (market cap, volume, 24h change). Set to False to use /simple/price for a faster, lighter response. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `symbol` | `string` | Symbol representing the entity requested in the data. |
+| `exchange` | `string` | Exchange or venue the data was fetched from. |
+| `timestamp` | `string` | Timestamp of the ticker snapshot (UTC). |
+| `last` | `number` | Last traded price. |
+| `open` | `number` | The open price (24h rolling window). |
+| `high` | `number` | The high price (24h rolling window). |
+| `low` | `number` | The low price (24h rolling window). |
+| `bid` | `number` | Current best bid price. |
+| `ask` | `number` | Current best ask price. |
+| `vwap` | `number` | Volume Weighted Average Price over the period. |
+| `volume` | `number` | The trading volume (base currency, 24h). |
+| `quote_volume` | `number` | 24h trading volume in quote currency. |
+| `prev_close` | `number` | The previous close price. |
+| `change` | `number` | Absolute price change over 24h. |
+| `change_percent` | `number` | Percentage price change over 24h. |
+| `market_cap` | `number` | Market capitalization in quote currency. |
+| `bid_volume` | `number` | Volume at the best bid. |
+| `ask_volume` | `number` | Volume at the best ask. |
+| `average` | `number` | Average of open and last price. |
+| `coin_id` | `string` | CoinGecko coin identifier. |
+| `market_cap_rank` | `integer` | Market cap rank. |
+| `fully_diluted_valuation` | `number` | Fully diluted valuation in quote currency. |
+| `circulating_supply` | `number` | Circulating supply. |
+| `total_supply` | `number` | Total supply. |
+
 ---
 
 ### `crypto.spot.trades`
@@ -2606,6 +3932,19 @@ Summary: Trades
 | `limit` | `no` | `integer` | `100` | Number of most recent trades to return. |
 | `exchange` | `no` | `string` | `binance` | Exchange to fetch data from. Supported: binance, bitget, okx, bybit, coinbase, upbit, gateio, kucoin, mexc, htx, cryptocom, bitfinex, bingx, kraken, bitmart, lbank, bitstamp, bithumb, hyperliquid. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `trade_id` | `string` | Exchange-assigned trade ID. |
+| `symbol` | `string` | Trading pair symbol. |
+| `timestamp` | `string` | Trade execution time (UTC). |
+| `side` | `string` | Taker side: buy or sell. |
+| `price` | `number` | Execution price. |
+| `amount` | `number` | Trade size in base currency. |
+| `cost` | `number` | Trade value in quote currency (price × amount). |
+| `taker_or_maker` | `string` | Whether the trade was executed as taker or maker. |
+
 ---
 
 ### `crypto.supported_currencies`
@@ -2630,6 +3969,12 @@ Summary: Supported Currencies
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `currency` | `string` | Supported currency code (e.g. 'usd', 'btc'). |
+
 ---
 
 ### `crypto.token_price`
@@ -2657,6 +4002,17 @@ Summary: Token Price
 | `contract_addresses` | `yes` | `string` | `-` | Comma-separated token contract addresses. |
 | `vs_currencies` | `no` | `string` | `usd` | Comma-separated target currencies (e.g. 'usd,btc'). Default is 'usd'. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `contract_address` | `string` | Token contract address. |
+| `price` | `number` | Token price in the target currency. |
+| `market_cap` | `number` | Market capitalization. |
+| `volume_24h` | `number` | 24-hour trading volume. |
+| `change_24h` | `number` | 24-hour price change percentage. |
+| `last_updated_at` | `integer` | Last update timestamp (UNIX). |
+
 ---
 
 ### `crypto.treasury`
@@ -2682,6 +4038,18 @@ Summary: Treasury
 |---|---|---|---|---|
 | `symbol` | `yes` | `string` | `-` | Cryptocurrency symbol ('BTC' or 'ETH'). Only Bitcoin and Ethereum are supported. |
 
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `name` | `string` | Company or entity name. |
+| `symbol` | `string` | Stock ticker symbol of the company. |
+| `country` | `string` | Country of the company. |
+| `total_holdings` | `number` | Total crypto holdings. |
+| `total_entry_value_usd` | `number` | Total entry value in USD. |
+| `total_current_value_usd` | `number` | Total current value in USD. |
+| `percentage_of_total_supply` | `number` | Percentage of total coin supply held. |
+
 ---
 
 ### `crypto.trending`
@@ -2705,3 +4073,15 @@ Summary: Trending
 
 | Param | Required | Type | Default | Notes |
 |---|---|---|---|---|
+
+#### Response fields
+
+| Field | Type | Notes |
+|---|---|---|
+| `coin_id` | `string` | CoinGecko coin identifier. |
+| `name` | `string` | Coin name. |
+| `symbol` | `string` | Coin ticker symbol. |
+| `market_cap_rank` | `integer` | Market capitalization rank. |
+| `thumb` | `string` | Small icon URL. |
+| `price_btc` | `number` | Price denominated in BTC. |
+| `score` | `integer` | Trending score (lower is more trending). |