Gate Info MCP

{'type': 'object', 'required': ['query'], 'properties': {'size': {'type': 'integer', 'default': 3, 'maximum': 20, 'minimum': 1, 'description': 'Max rows; omit for default 3; minimum 1, maximum 20. Over-limit rejected (not truncated).'}, 'chain': {'type': 'string', 'description': 'Chain hint for address disambiguation when query_type=address or auto-detected EVM address; e.g. eth, tron, bsc.'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'Search text: symbol, contract address, localized name, etc. Non-empty.'}, 'scope': {'enum': ['basic', 'detailed', 'full', 'with_project', 'with_tokenomics'], 'type': 'string', 'description': 'Response field scope; default basic when omitted. Allowed: basic|detailed|full|with_project|with_tokenomics.'}, 'fields': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'Field allowlist; empty = all. scope wins when both set.'}, 'query_type': {'enum': ['auto', 'address', 'symbol', 'name', 'project', 'gate_symbol', 'source_id'], 'type': 'string', 'description': 'Lookup mode; default auto when omitted. Allowed: auto|address|symbol|name|project|gate_symbol|source_id.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query', 'query_type', 'total', 'count', 'items', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Display name string (not a JSON blob).'}, 'chain': {'description': 'Chain name or list of chains.'}, 'symbol': {'type': 'string', 'description': 'Ticker symbol e.g. BTC.'}, 'category': {'description': 'Category label(s).'}, 'source_id': {'description': 'Canonical project id; null when empty.'}, 'gate_symbol': {'description': 'Gate trading symbol when available.'}, 'contract_address': {'description': 'Contract address; null when native / unavailable.'}}, 'additionalProperties': True}}, 'query': {'type': 'string'}, 'scope': {'type': 'string'}, 'total': {'type': 'integer'}, 'query_type': {'type': 'string'}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ranking_type'], 'properties': {'limit': {'type': 'integer', 'description': 'Rows; default 20, max 400.'}, 'time_range': {'type': 'string', 'description': 'Only for top_gainers|top_losers: 1h|24h (default)|7d. Omit for other ranking_type or validation fails.'}, 'listing_from': {'type': 'integer', 'description': 'new_listing only: Unix seconds from; 0 = omit.'}, 'ranking_type': {'type': 'string', 'description': 'popular|top_gainers|top_losers|twitter_hot|airdrop|new_listing|market_pulse_hot'}, 'listing_query': {'type': 'string', 'description': 'new_listing only: exchange / keyword for upstream query.'}, 'listing_tickers': {'type': 'string', 'description': 'new_listing only: comma tickers e.g. BTC,ETH.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ranking_type', 'time_range', 'total', 'count', 'items', 'duration_ms'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'total': {'type': 'integer'}, 'time_range': {'type': ['null', 'string']}, 'duration_ms': {'type': 'integer'}, 'ranking_type': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'chain': {'type': 'string', 'description': 'Chain filter: canonical name or alias (ETH→Ethereum, BSC→BNB Chain); contains match on normalized chain list.'}, 'limit': {'type': 'integer', 'description': 'Page size; default 20, max 400.'}, 'offset': {'type': 'integer', 'description': 'Offset; default 0.'}, 'sort_by': {'type': 'string', 'description': 'market_cap (default) | fdv | circulating_supply; all desc'}, 'category': {'type': 'string', 'description': 'Controlled sector tag or group (e.g. Layer 1, DEX); case-insensitive; matches category_type_flat then category_type; unknown values return empty list.'}, 'asset_type': {'type': 'string', 'description': 'crypto (default) | tradefi | all'}, 'market_cap_max': {'type': ['null', 'number'], 'description': 'Max market cap USD.'}, 'market_cap_min': {'type': ['null', 'number'], 'description': 'Min market cap USD; range on market_value / market_cap.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['total_count', 'total', 'count', 'items', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'total': {'type': 'integer'}, 'offset': {'type': 'integer'}, 'sort_by': {'type': 'string'}, 'category': {'type': 'string'}, 'asset_type': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'total_count': {'type': 'integer'}, 'market_cap_max': {'type': ['null', 'number']}, 'market_cap_min': {'type': ['null', 'number']}}, 'additionalProperties': False}

{'type': 'object', 'required': ['chain'], 'properties': {'lang': {'type': 'string', 'description': 'Locale: en|cn|tw|ja|kr; default en.'}, 'chain': {'type': 'string', 'description': 'Chain id e.g. eth, bsc, solana, base, arb.'}, 'scope': {'type': 'string', 'description': 'basic (default)|full.'}, 'token': {'type': 'string', 'description': 'Token symbol e.g. PEPE; xor with address.'}, 'address': {'type': 'string', 'description': 'Contract address; xor with token.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['chain', 'address', 'risk_summary', 'is_honeypot', 'is_open_source', 'total', 'count', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer'}, 'scope': {'type': 'string'}, 'token': {'type': 'string'}, 'total': {'type': 'integer'}, 'address': {'type': 'string'}, 'buy_tax': {'type': 'string'}, 'holders': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['address'], 'properties': {'tag': {'type': 'string'}, 'address': {'type': 'string'}, 'balance': {'type': 'string'}, 'percent': {'type': 'string'}, 'is_locked': {'type': 'boolean'}, 'is_contract': {'type': 'boolean'}}, 'additionalProperties': False}}, 'sell_tax': {'type': 'string'}, 'name_risk': {'type': ['null', 'object'], 'required': ['is_domain_token', 'is_sensitive'], 'properties': {'is_sensitive': {'type': 'boolean'}, 'is_domain_token': {'type': 'boolean'}, 'sensitive_words': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'risk_facts': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer'}, 'is_honeypot': {'type': 'boolean'}, 'holder_count': {'type': 'string'}, 'risk_summary': {'type': 'object', 'required': ['high_risk_num', 'middle_risk_num', 'low_risk_num', 'highest_risk_level'], 'properties': {'low_risk_num': {'type': 'integer'}, 'high_risk_num': {'type': 'integer'}, 'middle_risk_num': {'type': 'integer'}, 'highest_risk_level': {'type': 'integer'}}, 'additionalProperties': False}, 'tax_analysis': {'type': ['null', 'object'], 'required': ['token_tax'], 'properties': {'pool_tax': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['dex_name', 'pool_address', 'buy_tax', 'sell_tax'], 'properties': {'buy_tax': {'type': 'number'}, 'dex_name': {'type': 'string'}, 'sell_tax': {'type': 'number'}, 'pool_address': {'type': 'string'}, 'transfer_tax': {'type': 'number'}}, 'additionalProperties': False}}, 'token_tax': {'type': 'object', 'properties': {'buy_tax': {'type': 'string'}, 'sell_tax': {'type': 'string'}, 'transfer_tax': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'data_analysis': {'type': ['null', 'object'], 'properties': {'holder_count': {'type': 'string'}, 'bonding_curve': {'type': 'string'}, 'top10_percent': {'type': 'string'}, 'top100_percent': {'type': 'string'}, 'creator_address': {'type': 'string'}, 'insider_percent': {'type': 'string'}, 'max_holder_percent': {'type': 'string'}, 'dev_holding_percent': {'type': 'string'}}, 'additionalProperties': False}, 'low_risk_list': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['risk_key', 'risk_name', 'risk_level'], 'properties': {'risk_key': {'type': 'string'}, 'risk_desc': {'type': 'string'}, 'risk_name': {'type': 'string'}, 'risk_level': {'type': 'integer'}, 'risk_value': {'type': 'string'}}, 'additionalProperties': False}}, 'top10_percent': {'type': 'string'}, 'high_risk_list': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['risk_key', 'risk_name', 'risk_level'], 'properties': {'risk_key': {'type': 'string'}, 'risk_desc': {'type': 'string'}, 'risk_name': {'type': 'string'}, 'risk_level': {'type': 'integer'}, 'risk_value': {'type': 'string'}}, 'additionalProperties': False}}, 'is_open_source': {'type': 'boolean'}, 'middle_risk_list': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['risk_key', 'risk_name', 'risk_level'], 'properties': {'risk_key': {'type': 'string'}, 'risk_desc': {'type': 'string'}, 'risk_name': {'type': 'string'}, 'risk_level': {'type': 'integer'}, 'risk_value': {'type': 'string'}}, 'additionalProperties': False}}, 'dev_holding_percent': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'size': {'type': 'integer', 'description': 'Rows; default 20, max 400.'}, 'end_date': {'type': 'string', 'description': 'End YYYY-MM-DD inclusive; default start+30d; sorted by event_date desc.'}, 'event_type': {'type': 'string', 'description': 'FOMC|NFP|CPI|PPI|GDP|PCE|...; empty or all = no filter.'}, 'importance': {'type': 'string', 'description': 'Importance filter; ignored if index lacks field.'}, 'start_date': {'type': 'string', 'description': 'Start YYYY-MM-DD for event_date; default today UTC; if only end_date set, start defaults today.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['total', 'count', 'items', 'duration_ms'], 'properties': {'size': {'type': 'integer'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'total': {'type': 'integer'}, 'end_date': {'type': 'string'}, 'event_type': {'type': 'string'}, 'importance': {'type': 'string'}, 'start_date': {'type': 'string'}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['indicator'], 'properties': {'mode': {'type': 'string', 'description': 'latest (default, snapshot) or timeseries.'}, 'size': {'type': 'integer', 'description': 'Rows; default 20, max 400.'}, 'country': {'type': 'string', 'description': 'Country display name e.g. United States; wins over country_code if both set.'}, 'end_date': {'type': 'string', 'description': 'Same as end_time.'}, 'end_time': {'type': 'string', 'description': 'Range end; alias end_date.'}, 'indicator': {'type': 'string', 'description': 'Exact keyword match on indicator.keyword OR indicator_id.keyword OR slugname.keyword; ASCII case-insensitive via exact variants (original, lower, upper).'}, 'start_date': {'type': 'string', 'description': 'Same as start_time.'}, 'start_time': {'type': 'string', 'description': 'Range start; alias start_date; filters date/part_date.'}, 'country_code': {'type': 'string', 'description': 'ISO code e.g. US when index lacks display name.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['mode', 'indicator', 'total', 'count', 'duration_ms'], 'properties': {'mode': {'type': 'string'}, 'note': {'type': 'string', 'description': 'Optional empty-result or fallback hint.'}, 'size': {'type': 'integer'}, 'count': {'type': 'integer'}, 'total': {'type': 'integer'}, 'latest': {'type': ['null', 'object'], 'required': ['snapshots'], 'properties': {'snapshots': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}}, 'additionalProperties': False}, 'country': {'type': 'string'}, 'end_date': {'type': 'string'}, 'end_time': {'type': 'string'}, 'indicator': {'type': 'string'}, 'start_date': {'type': 'string'}, 'start_time': {'type': 'string'}, 'timeseries': {'type': ['null', 'object'], 'required': ['observations'], 'properties': {'observations': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}}, 'additionalProperties': False}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': False}

{'type': 'object', 'required': ['snapshot_time', 'indicators', 'next_events', 'indicators_total', 'total', 'count', 'duration_ms'], 'properties': {'count': {'type': 'integer'}, 'total': {'type': 'integer'}, 'indicators': {'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'unit': {'type': 'string'}, 'trend': {'type': 'string'}, 'value': True, 'reference': {'type': 'string'}}, 'additionalProperties': False}}, 'duration_ms': {'type': 'integer'}, 'next_events': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'snapshot_time': {'type': 'string'}, 'indicators_total': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'timeframe'], 'properties': {'limit': {'type': 'integer', 'default': 100, 'maximum': 400, 'minimum': 1, 'description': 'Max candles when no time range; omit for default 100; minimum 1, maximum 400. Over-limit rejected. Cannot combine with start_time/end_time.'}, 'settle': {'type': 'string', 'description': 'futures/delivery settlement; default usdt.'}, 'symbol': {'type': 'string', 'minLength': 1, 'description': 'Pair or contract e.g. BTC_USDT.'}, 'end_time': {'type': 'integer', 'description': 'End Unix seconds; must be paired with start_time. Range queries return up to 400 latest candles and may set truncated.'}, 'timeframe': {'enum': ['1s', '10s', '1m', '3m', '5m', '15m', '30m', '1h', '2h', '4h', '6h', '8h', '12h', '1d', '3d', '7d', '30d', '1w'], 'type': 'string', 'description': 'Candle interval. start_time/end_time are Unix seconds.'}, 'start_time': {'type': 'integer', 'description': 'Start Unix seconds; must be paired with end_time. Omit both with limit for latest N candles. Mutually exclusive with explicit limit.'}, 'market_type': {'enum': ['spot', 'futures', 'delivery', 'options'], 'type': 'string', 'description': 'Market venue; default spot when omitted. Allowed: spot|futures|delivery|options.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'market_type', 'timeframe', 'total', 'count', 'items'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['t', 'open', 'high', 'low', 'close'], 'properties': {'t': {'type': 'string', 'description': 'Candle open time as Unix seconds (string). Times are UTC.'}, 'low': {'type': 'string', 'description': 'Low price (quote).'}, 'high': {'type': 'string', 'description': 'High price (quote).'}, 'open': {'type': 'string', 'description': 'Open price (quote).'}, 'close': {'type': 'string', 'description': 'Close price (quote).'}, 't_utc': {'type': 'string', 'description': 'RFC3339 UTC with explicit +00:00.'}, 'volume': {'type': 'string', 'description': 'Base asset or contract volume when upstream provides it (optional; may be absent for some options candles).'}, 'quote_volume': {'type': 'string', 'description': 'Quote-currency volume when upstream provides it (optional).'}, 'is_candle_closed': {'type': ['null', 'boolean'], 'description': 'Whether the candle is closed (spot); boolean when upstream provides it.'}}, 'additionalProperties': False}, 'description': 'Candles with t, open, high, low, close required; volume/quote_volume when upstream provides them; times UTC.'}, 'total': {'type': 'integer'}, 'settle': {'type': 'string'}, 'symbol': {'type': 'string', 'description': 'Echo input. Candle times are UTC (+00:00); convert for local display.'}, 'cex_tool': {'type': 'string', 'description': 'Upstream route label (omitted on open surface).'}, 'end_time': {'type': 'integer', 'description': 'Echoed range end when start_time/end_time were provided.'}, 'timeframe': {'type': 'string'}, 'truncated': {'type': 'boolean', 'description': 'True when a range query returned only the latest MaxKlineLimit candles.'}, 'start_time': {'type': 'integer', 'description': 'Echoed range start when start_time/end_time were provided.'}, 'duration_ms': {'type': 'integer', 'description': 'Server timing (omitted on open surface).'}, 'market_type': {'type': 'string'}, 'actual_end_time': {'type': 'integer', 'description': 'Latest candle t in items (Unix seconds) after truncation.'}, 'actual_start_time': {'type': 'integer', 'description': 'Earliest candle t in items (Unix seconds) after truncation.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol'], 'properties': {'depth': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Order book depth levels; omit for default 20; minimum 1, maximum 100. Values above max are rejected.'}, 'settle': {'type': 'string', 'description': 'Settlement for futures/delivery; default usdt; omit for options.'}, 'symbol': {'type': 'string', 'minLength': 1, 'description': 'Trading pair e.g. BTC_USDT.'}, 'market_type': {'enum': ['spot', 'futures', 'delivery', 'options'], 'type': 'string', 'description': 'Market venue; default spot when omitted. Allowed: spot|futures|delivery|options.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'market_type', 'depth', 'total', 'count', 'items'], 'properties': {'count': {'type': 'integer'}, 'depth': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['bids', 'asks'], 'properties': {'id': {'type': 'string', 'description': 'Order book id when provided by upstream.'}, 'asks': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['price', 'size'], 'properties': {'size': {'type': 'string', 'description': 'Size/quantity, string.'}, 'price': {'type': 'string', 'description': 'Price (quote currency), string.'}}, 'additionalProperties': False}, 'description': 'Ask levels, best first; each level has price then size.'}, 'bids': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['price', 'size'], 'properties': {'size': {'type': 'string', 'description': 'Size/quantity, string.'}, 'price': {'type': 'string', 'description': 'Price (quote currency), string.'}}, 'additionalProperties': False}, 'description': 'Bid levels, best first; each level has price then size.'}, 'update': {'type': 'string', 'description': 'Last book change time from upstream (same unit rules as current). Prefer update_utc.'}, 'current': {'type': 'string', 'description': 'Book response time from upstream. Spot often Unix ms; futures/delivery often Unix seconds (may be fractional). Prefer current_utc.'}, 'update_utc': {'type': 'string', 'description': 'RFC3339 UTC (+00:00).'}, 'current_utc': {'type': 'string', 'description': 'RFC3339 UTC (+00:00).'}}, 'additionalProperties': False}, 'description': 'Usually one OrderBookItem with bids/asks as {price,size} levels.'}, 'total': {'type': 'integer'}, 'settle': {'type': 'string'}, 'symbol': {'type': 'string', 'description': 'Echo input. Item timestamps are UTC (+00:00); convert for local display.'}, 'cex_tool': {'type': 'string', 'description': 'Upstream route label (omitted on open surface).'}, 'duration_ms': {'type': 'integer', 'description': 'Server timing (omitted on open surface).'}, 'market_type': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol'], 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 400, 'minimum': 1, 'description': 'Recent trades count; omit for default 50; minimum 1, maximum 400. Over-limit rejected.'}, 'settle': {'type': 'string', 'description': 'futures/delivery settlement; default usdt.'}, 'symbol': {'type': 'string', 'minLength': 1, 'description': 'Pair or contract id.'}, 'market_type': {'enum': ['spot', 'futures', 'delivery', 'options'], 'type': 'string', 'description': 'Market venue; default spot when omitted. Allowed: spot|futures|delivery|options.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'market_type', 'limit', 'total', 'count', 'items'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Trade id.'}, 'deal': {'type': 'string', 'description': 'Quote notional when provided.'}, 'side': {'type': 'string', 'description': 'buy/sell when provided (typically spot). Derivatives often omit side and use signed size.'}, 'size': {'type': 'string', 'description': 'Contract size when upstream uses size.'}, 'price': {'type': 'string', 'description': 'Trade price.'}, 'amount': {'type': 'string', 'description': 'Base amount (spot).'}, 'contract': {'type': 'string', 'description': 'Derivative contract identifier when applicable.'}, 'create_time': {'type': 'string', 'description': 'Trade time Unix seconds (string).'}, 'currency_pair': {'type': 'string', 'description': 'Spot pair echo when provided (e.g. BTC_USDT).'}, 'create_time_ms': {'type': 'string', 'description': 'Upstream trade time field (name historical). Spot usually Unix ms; futures/delivery often Unix seconds with fraction; options may omit. Do not assume ms from the name alone.'}, 'create_time_utc': {'type': 'string', 'description': 'RFC3339 UTC (+00:00).'}, 'create_time_ms_utc': {'type': 'string', 'description': 'RFC3339 UTC (+00:00) converted with the correct upstream unit.'}}, 'additionalProperties': False}, 'description': 'Public trades: time, price, amount/size; side optional (spot). create_time_ms keeps upstream units.'}, 'limit': {'type': 'integer'}, 'total': {'type': 'integer'}, 'settle': {'type': 'string'}, 'symbol': {'type': 'string', 'description': 'Echo input. Trade times are UTC (+00:00); convert for local display.'}, 'cex_tool': {'type': 'string', 'description': 'Upstream route label (omitted on open surface).'}, 'duration_ms': {'type': 'integer', 'description': 'Server timing (omitted on open surface).'}, 'market_type': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbols'], 'properties': {'quote': {'type': 'string', 'description': 'Quote currency; default USDT; maps to OpenSearch market.'}, 'scope': {'enum': ['basic', 'detailed', 'full'], 'type': 'string', 'description': 'Response field scope; default basic. Allowed: basic|detailed|full.'}, 'source': {'enum': ['alpha', 'spot', 'future', 'futures', 'fx'], 'type': 'string', 'description': 'Market source; default spot. futures is accepted and normalized to future. Allowed: alpha|spot|future|futures|fx.'}, 'symbols': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20, 'minItems': 1, 'description': 'Raw symbol array length 1–20 (checked before trim/dedupe). Then trim, reject blanks, dedupe; missing symbols go to not_found (omitted from items).'}, 'timeframe': {'enum': ['15m', '1h', '4h', '1d'], 'type': 'string', 'description': 'Kline interval; default 1h when omitted. Allowed: 15m|1h|4h|1d.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['total', 'count', 'items', 'not_found', 'unavailable'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'kline': {'type': 'object', 'properties': {'amt': {'description': 'Present when upstream provides it; type may be number or string.'}, 'time': {'description': 'Present when upstream provides it; type may be number or string.'}, 'deal_cnt': {'description': 'Present when upstream provides it; type may be number or string.'}, 'low_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'high_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'open_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'close_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'latest_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'volatility_7d': {'description': 'Present when upstream provides it; type may be number or string.'}, 'volatility_30d': {'description': 'Present when upstream provides it; type may be number or string.'}, 'volatility_90d': {'description': 'Present when upstream provides it; type may be number or string.'}}, 'description': 'Same shape as get_market_snapshot.kline.', 'additionalProperties': True}, 'quote': {'type': 'string'}, 'scope': {'type': 'string'}, 'source': {'type': 'string'}, 'status': {'type': 'string', 'description': 'not_found when empty; omit on success.'}, 'symbol': {'type': 'string'}, 'realtime': {'type': 'object', 'properties': {'low': {'description': 'Session/period low when present.'}, 'high': {'description': 'Session/period high when present.'}, 'last': {'description': 'Last price (canonical; aliases current_price/last_price/price are normalized into last).'}, 'tick': {'description': 'Optional tick object when present.'}, 'spread': {'description': 'Bid-ask spread when present.'}, 'best_ask': {'description': 'Best ask when present.'}, 'best_bid': {'description': 'Best bid when present.'}, 'lowest_ask': {'description': 'Lowest ask alias when present.'}, 'trend_info': {'description': 'Optional trend label when present.'}, 'volume_24h': {'description': '24h volume (canonical).'}, 'highest_bid': {'description': 'Highest bid alias when present.'}, 'update_time': {'description': 'Upstream update time when present.'}, 'bid_ask_spread': {'description': 'Spread alias when present.'}, 'price_change_24h': {'description': '24h change (canonical).'}}, 'description': 'Same shape as get_market_snapshot.realtime.', 'additionalProperties': True}, 'timeframe': {'type': 'string'}, 'project_info': {'type': 'object', 'properties': {'fdv': {'description': 'Present when upstream provides it; type may be number or string.'}, 'ahr999': {'description': 'Present when upstream provides it; type may be number or string.'}, 'dominance': {'description': 'Present when upstream provides it; type may be number or string.'}, 'market_cap': {'description': 'Present when upstream provides it; type may be number or string.'}, 'fear_greed_index': {'description': 'Present when upstream provides it; type may be number or string.'}, 'altcoin_season_index': {'description': 'Present when upstream provides it; type may be number or string.'}}, 'description': 'Same shape as get_market_snapshot.project_info.', 'additionalProperties': True}}, 'additionalProperties': True}}, 'quote': {'type': 'string'}, 'scope': {'type': 'string'}, 'total': {'type': 'integer'}, 'source': {'type': 'string'}, 'symbols': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'not_found': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'timeframe': {'type': 'string'}, 'unavailable': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['symbol', 'reason', 'retryable'], 'properties': {'reason': {'type': 'string'}, 'symbol': {'type': 'string'}, 'retryable': {'type': 'boolean'}}, 'additionalProperties': False}}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'asset': {'type': 'string', 'description': 'BTC|ETH|all; default BTC. all returns BTC and ETH groups.'}, 'limit': {'type': 'integer', 'description': '1-366; default 30.'}, 'channel': {'type': 'string', 'description': 'all|etf|cme|cftc; default all.'}, 'end_date': {'type': 'string', 'description': 'YYYY-MM-DD; default latest part_date available from OpenSearch.'}, 'start_date': {'type': 'string', 'description': 'YYYY-MM-DD; default end_date - 30d.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['asset', 'channel', 'start_date', 'end_date', 'total', 'count', 'assets', 'data_status', 'duration_ms'], 'properties': {'asset': {'type': 'string'}, 'count': {'type': 'integer'}, 'total': {'type': 'integer'}, 'assets': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['asset', 'latest', 'series'], 'properties': {'asset': {'type': 'string'}, 'latest': {'type': ['null', 'object'], 'required': ['part_date', 'etf_net_inflow_usd', 'etf_value_traded_usd', 'etf_total_assets_usd', 'cme_volume', 'cme_oi', 'cme_oi_change', 'cme_volume_underlying_amount', 'cme_oi_underlying_amount', 'cftc_oi_weekly', 'cftc_oi_weekly_underlying_amount', 'cftc_contract_unit_raw', 'institutional_channel_signal', 'data_status'], 'properties': {'cme_oi': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'part_date': {'type': 'string'}, 'cme_volume': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'data_status': {'type': 'string'}, 'cme_oi_change': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'cftc_oi_weekly': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'etf_net_inflow_usd': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'etf_total_assets_usd': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'etf_value_traded_usd': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'cftc_contract_unit_raw': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'string'}}, 'additionalProperties': False}, 'cme_oi_underlying_amount': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'cme_volume_underlying_amount': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'institutional_channel_signal': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'string'}}, 'additionalProperties': False}, 'cftc_oi_weekly_underlying_amount': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'series': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['part_date', 'etf_net_inflow_usd', 'etf_value_traded_usd', 'etf_total_assets_usd', 'cme_volume', 'cme_oi', 'cme_oi_change', 'cme_volume_underlying_amount', 'cme_oi_underlying_amount', 'cftc_oi_weekly', 'cftc_oi_weekly_underlying_amount', 'cftc_contract_unit_raw', 'institutional_channel_signal', 'data_status'], 'properties': {'cme_oi': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'part_date': {'type': 'string'}, 'cme_volume': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'data_status': {'type': 'string'}, 'cme_oi_change': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'cftc_oi_weekly': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'etf_net_inflow_usd': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'etf_total_assets_usd': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'etf_value_traded_usd': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'cftc_contract_unit_raw': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'string'}}, 'additionalProperties': False}, 'cme_oi_underlying_amount': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'cme_volume_underlying_amount': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'institutional_channel_signal': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'string'}}, 'additionalProperties': False}, 'cftc_oi_weekly_underlying_amount': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'additionalProperties': False}}, 'channel': {'type': 'string'}, 'end_date': {'type': 'string'}, 'start_date': {'type': 'string'}, 'data_status': {'type': 'string'}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': False}

{'type': 'object', 'required': ['total_market_cap', 'market_cap_change_24h', 'total_volume_24h', 'btc_dominance', 'eth_dominance', 'btc_price', 'fear_greed_index', 'fear_greed_label', 'ahr999', 'altcoin_season_index', 'active_coins_count', 'updated_at', 'duration_ms'], 'properties': {'ahr999': {'type': ['null', 'number']}, 'btc_price': {'type': ['null', 'number']}, 'updated_at': {'type': ['null', 'string']}, 'duration_ms': {'type': 'integer'}, 'btc_dominance': {'type': ['null', 'number']}, 'eth_dominance': {'type': ['null', 'number']}, 'fear_greed_index': {'type': ['null', 'integer']}, 'fear_greed_label': {'type': ['null', 'string']}, 'total_market_cap': {'type': ['null', 'number'], 'description': 'USD total market cap; null when that upstream slice fails. Each field may be null independently.'}, 'total_volume_24h': {'type': ['null', 'number']}, 'active_coins_count': {'type': ['null', 'integer']}, 'altcoin_season_index': {'type': ['null', 'integer']}, 'market_cap_change_24h': {'type': ['null', 'number']}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol'], 'properties': {'quote': {'type': 'string', 'description': 'Quote currency mapped to OpenSearch market; default USDT.'}, 'scope': {'enum': ['basic', 'detailed', 'full'], 'type': 'string', 'description': 'Response field scope; default basic (trimmed). Allowed: basic|detailed|full.'}, 'source': {'enum': ['alpha', 'spot', 'future', 'futures', 'fx'], 'type': 'string', 'description': 'Market source; default spot. futures is accepted and normalized to future. Allowed: alpha|spot|future|futures|fx.'}, 'symbol': {'type': 'string', 'minLength': 1, 'description': 'Symbol e.g. BTC, ETH, USDC.'}, 'timeframe': {'enum': ['15m', '1h', '4h', '1d'], 'type': 'string', 'description': 'Kline interval; wins over indicator_timeframe when both set; default 1h if both empty. Allowed: 15m|1h|4h|1d.'}, 'indicator_timeframe': {'enum': ['15m', '1h', '4h', '1d'], 'type': 'string', 'description': 'Alias of timeframe when timeframe omitted. Allowed: 15m|1h|4h|1d.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'timeframe', 'source', 'realtime', 'kline', 'project_info', 'duration_ms'], 'properties': {'kline': {'type': 'object', 'properties': {'amt': {'description': 'Present when upstream provides it; type may be number or string.'}, 'time': {'description': 'Present when upstream provides it; type may be number or string.'}, 'deal_cnt': {'description': 'Present when upstream provides it; type may be number or string.'}, 'low_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'high_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'open_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'close_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'latest_price': {'description': 'Present when upstream provides it; type may be number or string.'}, 'volatility_7d': {'description': 'Present when upstream provides it; type may be number or string.'}, 'volatility_30d': {'description': 'Present when upstream provides it; type may be number or string.'}, 'volatility_90d': {'description': 'Present when upstream provides it; type may be number or string.'}}, 'additionalProperties': True}, 'quote': {'type': 'string'}, 'scope': {'type': 'string'}, 'source': {'type': 'string'}, 'status': {'type': 'string', 'description': 'not_found when no market/project data; not_available when symbol known but data temporarily missing; partial when some sections present; omit on full success.'}, 'symbol': {'type': 'string'}, 'realtime': {'type': 'object', 'properties': {'low': {'description': 'Session/period low when present.'}, 'high': {'description': 'Session/period high when present.'}, 'last': {'description': 'Last price (canonical; aliases current_price/last_price/price are normalized into last).'}, 'tick': {'description': 'Optional tick object when present.'}, 'spread': {'description': 'Bid-ask spread when present.'}, 'best_ask': {'description': 'Best ask when present.'}, 'best_bid': {'description': 'Best bid when present.'}, 'lowest_ask': {'description': 'Lowest ask alias when present.'}, 'trend_info': {'description': 'Optional trend label when present.'}, 'volume_24h': {'description': '24h volume (canonical).'}, 'highest_bid': {'description': 'Highest bid alias when present.'}, 'update_time': {'description': 'Upstream update time when present.'}, 'bid_ask_spread': {'description': 'Spread alias when present.'}, 'price_change_24h': {'description': '24h change (canonical).'}}, 'additionalProperties': True}, 'timeframe': {'type': 'string'}, 'derivatives': {'type': ['null', 'object'], 'additionalProperties': True}, 'duration_ms': {'type': 'integer'}, 'market_pulse': {'type': ['null', 'object'], 'additionalProperties': True}, 'project_info': {'type': 'object', 'properties': {'fdv': {'description': 'Present when upstream provides it; type may be number or string.'}, 'ahr999': {'description': 'Present when upstream provides it; type may be number or string.'}, 'dominance': {'description': 'Present when upstream provides it; type may be number or string.'}, 'market_cap': {'description': 'Present when upstream provides it; type may be number or string.'}, 'fear_greed_index': {'description': 'Present when upstream provides it; type may be number or string.'}, 'altcoin_season_index': {'description': 'Present when upstream provides it; type may be number or string.'}}, 'additionalProperties': True}, 'institutional_channel_summary': {'type': ['null', 'object'], 'additionalProperties': True}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'indicators', 'timeframe'], 'properties': {'limit': {'type': 'integer', 'description': 'Points; default 50, max 400.'}, 'symbol': {'type': 'string', 'description': 'Symbol.'}, 'end_time': {'type': 'string', 'description': 'Range end.'}, 'timeframe': {'type': 'string', 'description': '15m|1h|4h|1d.'}, 'indicators': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'ES field names e.g. rsi, macd, macd_dea, ma7, ema7, ma30, boll_upper_band, signal_value_k, profit_rate_stddev_7d.'}, 'start_time': {'type': 'string', 'description': 'Range start: ms or ISO8601.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'timeframe', 'indicators', 'total', 'count', 'items', 'duration_ms'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'total': {'type': 'integer'}, 'symbol': {'type': 'string'}, 'timeframe': {'type': 'string'}, 'indicators': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'timeframe'], 'properties': {'size': {'type': 'integer', 'description': 'Row count; alias of limit; default 100, max 400.'}, 'limit': {'type': 'integer', 'description': 'Row count; default 100, max 400; alternative to size.'}, 'period': {'type': 'string', 'description': 'Window: 1h|4h|24h|7d|3d|5d|10d; default 24h. Ignored when start/end set.'}, 'symbol': {'type': 'string', 'description': 'Symbol e.g. BTC, ETH.'}, 'end_time': {'type': 'string', 'description': 'Absolute end.'}, 'timeframe': {'type': 'string', 'description': 'Candle interval: 1m|5m|15m|1h|4h|1d.'}, 'start_time': {'type': 'string', 'description': 'Absolute start: ms timestamp or ISO8601; wins over period when paired with end.'}, 'with_indicators': {'type': ['null', 'boolean'], 'description': 'If true, include technical columns in _source; default OHLCV only.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'timeframe', 'period', 'size', 'total', 'count', 'items', 'duration_ms'], 'properties': {'size': {'type': 'integer'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'total': {'type': 'integer'}, 'period': {'type': 'string'}, 'symbol': {'type': 'string'}, 'timeframe': {'type': 'string'}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol'], 'properties': {'period': {'type': 'string', 'description': 'Window: 1h|4h|24h|7d|3d|5d|10d|all; default 3d. Absolute start/end win when parseable.'}, 'symbol': {'type': 'string', 'description': 'Symbol.'}, 'end_time': {'type': 'string', 'description': 'Absolute end: ms or RFC3339.'}, 'start_time': {'type': 'string', 'description': 'Absolute start: ms or RFC3339.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'signal', 'timeframes', 'duration_ms'], 'properties': {'period': {'type': 'string', 'description': 'Echo relative window; empty when start/end used.'}, 'signal': {'type': 'string', 'description': 'Aggregate: bullish|bearish|neutral.'}, 'symbol': {'type': 'string'}, 'end_time': {'type': 'string'}, 'start_time': {'type': 'string'}, 'timeframes': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['rsi_zone', 'macd_signal', 'ma_alignment', 'adx', 'cci', 'wr', 'sar'], 'properties': {'wr': {'type': 'number', 'description': 'Williams %R.'}, 'adx': {'type': 'number', 'description': 'ADX trend strength (>25 stronger trend).'}, 'cci': {'type': 'number', 'description': 'CCI oscillator.'}, 'sar': {'type': 'number', 'description': 'Parabolic SAR.'}, 'close': {'type': 'number'}, 'support': {'type': 'number'}, 'rsi_zone': {'type': 'string', 'description': 'RSI: overbought|oversold|neutral'}, 'resistance': {'type': 'number'}, 'macd_signal': {'type': 'string', 'description': 'MACD: golden_cross|death_cross|none'}, 'ma_alignment': {'type': 'string', 'description': 'MA bias: bullish|bearish|neutral'}}, 'additionalProperties': False}}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['address'], 'properties': {'chain': {'type': 'string', 'description': 'Chain id e.g. eth, trx, bsc, btc, sol, base, arb. Omit to auto-detect from labels; default eth if unknown.'}, 'scope': {'type': 'string', 'description': 'basic (default) | with_defi | with_counterparties | with_pnl | full. full merges all extensions; empty sections may be [] or null. detailed maps to full.'}, 'address': {'type': 'string', 'description': 'On-chain address.'}, 'min_value_usd': {'type': ['null', 'number'], 'description': 'Min token balance USD; keep rows with parsed value_usd >= threshold. 0 keeps non-negative; unset/unparseable value_usd dropped.'}, 'upstream_raw_mode': {'type': 'string', 'description': 'off (default) | lite | full. Prefer off for public MCP. include_upstream_raw=true forces full.'}, 'include_upstream_raw': {'type': 'boolean', 'description': 'Prefer false (default). If true, include New Explorer ApiResponse.data as new_explorer_*_raw; large payload, not for public clients.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['address'], 'properties': {'chain': {'type': 'string', 'description': 'Chain id (eth, trx, bsc, btc, sol, base, arb, ...); default eth.'}, 'limit': {'type': 'integer', 'description': 'Max rows; default 20, max 400; maps to explorer page_size. Some filters apply only to GET list paths.'}, 'address': {'type': 'string', 'description': 'On-chain address.'}, 'tx_type': {'type': 'string', 'description': 'transfer | contract_call | token_transfer | all (default).'}, 'end_time': {'type': 'integer', 'description': 'End Unix seconds.'}, 'start_time': {'type': 'integer', 'description': 'Start Unix seconds; pair with end_time; absolute wins over time_range.'}, 'time_range': {'type': 'string', 'description': 'Relative window vs start/end: 1h|24h|1d|7d|30d|90d as [now-Δ, now]. Ignored if start_time or end_time set.'}, 'to_address': {'type': 'string', 'description': 'Filter recipient; maps to explorer GET to or POST body to. BlockInfo path ignores.'}, 'from_address': {'type': 'string', 'description': 'Filter sender; maps to explorer GET from or POST transfers from. BlockInfo path ignores.'}, 'min_value_usd': {'type': 'number', 'description': 'If >0, keep rows with value_usd >= threshold (same semantics as get_address_info min_value_usd). May map to explorer query when supported.'}, 'nonzero_value': {'type': 'boolean', 'description': 'If true, drop zero-amount token_transfer rows; passes nonzero_value to explorer POST when used.'}, 'upstream_raw_mode': {'type': 'string', 'description': 'off (default) | lite | full. Prefer off for public MCP. include_upstream_raw=true forces full.'}, 'include_upstream_raw': {'type': 'boolean', 'description': 'Prefer false (default). If true, include new_explorer_address_*_raw and per-item source_raw; large payload, not for public clients.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['address', 'chain', 'tx_type', 'total', 'count', 'items', 'transactions', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['tx_type'], 'properties': {'to': {'type': 'string'}, 'fee': {'type': 'string'}, 'from': {'type': 'string'}, 'hash': {'type': 'string'}, 'slot': {'type': 'integer'}, 'token': {'type': ['null', 'object'], 'properties': {'name': {'type': 'string'}, 'symbol': {'type': 'string'}, 'address': {'type': 'string'}, 'decimals': {'type': 'integer'}, 'token_type': {'type': 'string'}}, 'additionalProperties': False}, 'value': {'type': 'string'}, 'inputs': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'value': {'type': 'string'}, 'addresses': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'value_usd': {'type': 'string'}}, 'additionalProperties': False}}, 'method': {'type': 'string'}, 'status': {'type': 'integer'}, 'outputs': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'value': {'type': 'string'}, 'addresses': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'value_usd': {'type': 'string'}}, 'additionalProperties': False}}, 'tx_time': {'type': 'integer'}, 'tx_type': {'type': 'string'}, 'decimals': {'type': 'integer'}, 'lamports': {'type': 'string'}, 'signature': {'type': 'string'}, 'tx_status': {'type': 'string'}, 'ui_amount': {'type': 'string'}, 'value_usd': {'type': 'string'}, 'block_hash': {'type': 'string'}, 'real_value': {'type': 'string'}, 'source_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'token_type': {'type': 'string'}, 'block_height': {'type': 'integer'}, 'transfer_type': {'type': 'string'}}, 'additionalProperties': False}}, 'limit': {'type': 'integer'}, 'total': {'type': 'integer'}, 'address': {'type': 'string'}, 'sources': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['source', 'used', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'code': {'type': ['null', 'integer']}, 'used': {'type': 'boolean'}, 'detail': {'type': 'string'}, 'source': {'type': 'string'}}, 'additionalProperties': False}}, 'tx_type': {'type': 'string'}, 'end_time': {'type': 'integer'}, 'start_time': {'type': 'integer'}, 'time_range': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'data_quality': {'type': 'string'}, 'transactions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['tx_type'], 'properties': {'to': {'type': 'string'}, 'fee': {'type': 'string'}, 'from': {'type': 'string'}, 'hash': {'type': 'string'}, 'slot': {'type': 'integer'}, 'token': {'type': ['null', 'object'], 'properties': {'name': {'type': 'string'}, 'symbol': {'type': 'string'}, 'address': {'type': 'string'}, 'decimals': {'type': 'integer'}, 'token_type': {'type': 'string'}}, 'additionalProperties': False}, 'value': {'type': 'string'}, 'inputs': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'value': {'type': 'string'}, 'addresses': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'value_usd': {'type': 'string'}}, 'additionalProperties': False}}, 'method': {'type': 'string'}, 'status': {'type': 'integer'}, 'outputs': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'value': {'type': 'string'}, 'addresses': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'value_usd': {'type': 'string'}}, 'additionalProperties': False}}, 'tx_time': {'type': 'integer'}, 'tx_type': {'type': 'string'}, 'decimals': {'type': 'integer'}, 'lamports': {'type': 'string'}, 'signature': {'type': 'string'}, 'tx_status': {'type': 'string'}, 'ui_amount': {'type': 'string'}, 'value_usd': {'type': 'string'}, 'block_hash': {'type': 'string'}, 'real_value': {'type': 'string'}, 'source_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'token_type': {'type': 'string'}, 'block_height': {'type': 'integer'}, 'transfer_type': {'type': 'string'}}, 'additionalProperties': False}}, 'min_value_usd': {'type': 'number'}, 'nonzero_value': {'type': 'boolean'}, 'quality_reasons': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'new_explorer_address_transfers_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'new_explorer_address_transactions_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'new_explorer_address_token_transfers_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'new_explorer_address_sol_transactions_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'new_explorer_address_internal_transactions_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}}, 'additionalProperties': False}

{'type': 'object', 'required': ['token'], 'properties': {'chain': {'type': 'string', 'description': 'Chain; omit for service default.'}, 'scope': {'type': 'string', 'description': 'holders|activity|transfers|smart_money|full; default full.'}, 'token': {'type': 'string', 'description': 'Token symbol e.g. ETH, USDT, or contract address.'}, 'upstream_raw_mode': {'type': 'string', 'description': 'off (default) | lite | full. Prefer off for public MCP. include_upstream_raw=true forces full.'}, 'include_upstream_raw': {'type': 'boolean', 'description': 'Prefer false (default). If true, include explorer_*_page raw and transfer source_raw; large payload, not for public clients.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['token', 'chain', 'scope', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'scope': {'type': 'string'}, 'token': {'type': 'string'}, 'holders': {'type': ['null', 'object'], 'required': ['top_holders', 'holder_concentration', 'holder_count'], 'properties': {'top_holders': {'type': ['null', 'array'], 'items': True}, 'holder_count': {'type': 'integer'}, 'holder_concentration': True}, 'additionalProperties': False}, 'sources': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['source', 'used', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'code': {'type': ['null', 'integer']}, 'used': {'type': 'boolean'}, 'detail': {'type': 'string'}, 'source': {'type': 'string'}}, 'additionalProperties': False}}, 'activity': {'type': ['null', 'object'], 'required': ['daily_active_addresses', 'daily_transfer_volume', 'new_address_count_7d'], 'properties': {'new_address_count_7d': {'type': 'integer'}, 'daily_transfer_volume': True, 'daily_active_addresses': True}, 'additionalProperties': False}, 'transfers': {'type': ['null', 'object'], 'required': ['large_transfers', 'supply_history'], 'properties': {'supply_history': {'type': ['null', 'array'], 'items': True}, 'large_transfers': {'type': ['null', 'array'], 'items': True}}, 'additionalProperties': False}, 'token_info': {'type': ['null', 'object'], 'properties': {'icon': {'type': 'string'}, 'links': True, 'decimals': {'type': 'integer'}, 'tx_count': {'type': 'integer'}, 'certified': {'type': 'integer'}, 'market_cap': {'type': 'string'}, 'token_name': {'type': 'string'}, 'token_type': {'type': 'string'}, 'updated_at': {'type': 'string'}, 'native_coin': {'type': 'boolean'}, 'holder_count': {'type': 'integer'}, 'social_media': True, 'token_symbol': {'type': 'string'}, 'total_supply': {'type': 'string'}, 'current_price': {'type': 'string'}, 'current_price_str': {'type': 'string'}, 'circulating_supply': {'type': 'string'}}, 'additionalProperties': False}, 'duration_ms': {'type': 'integer', 'description': 'required'}, 'smart_money': {'type': ['null', 'object'], 'required': ['smart_money_netflow', 'who_bought_sold'], 'properties': {'who_bought_sold': True, 'smart_money_netflow': True}, 'additionalProperties': False}, 'data_quality': {'type': 'string'}, 'quality_reasons': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'explorer_token_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'explorer_holders_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'explorer_transfers_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}}, 'additionalProperties': False}

{'type': 'object', 'required': ['tx_hash'], 'properties': {'chain': {'type': 'string', 'description': 'Chain e.g. eth, bsc, btc; default eth.'}, 'tx_hash': {'type': 'string', 'description': 'Transaction hash. Response may omit fields when upstream data is incomplete.'}, 'upstream_raw_mode': {'type': 'string', 'description': 'off (default) | lite | full. Prefer off for public MCP; only full adds detail raw. include_upstream_raw=true forces full.'}, 'include_upstream_raw': {'type': 'boolean', 'description': 'Prefer false (default). If true, include explorer_detail_raw and blockinfo_detail_raw; large payload, not for public clients.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['tx_hash', 'chain', 'duration_ms'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'chain': {'type': 'string'}, 'value': {'type': 'string'}, 'tx_fee': {'type': 'string'}, 'sources': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['source', 'used', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'code': {'type': ['null', 'integer']}, 'used': {'type': 'boolean'}, 'detail': {'type': 'string'}, 'source': {'type': 'string'}}, 'additionalProperties': False}}, 'to_tags': {'type': ['null', 'array'], 'items': True}, 'tx_hash': {'type': 'string'}, 'tx_tags': {'type': ['null', 'array'], 'items': True}, 'gas_used': {'type': 'string'}, 'from_tags': {'type': ['null', 'array'], 'items': True}, 'value_usd': {'type': 'string'}, 'block_time': {'type': 'integer'}, 'tx_fee_usd': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'method_name': {'type': 'string'}, 'block_height': {'type': 'integer'}, 'contract_ret': {'type': 'string'}, 'data_quality': {'type': 'string'}, 'instructions': {'type': ['null', 'array'], 'items': True}, 'program_logs': {'type': ['null', 'array'], 'items': True}, 'quality_reasons': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'token_transfers': {'type': ['null', 'array'], 'items': True}, 'sol_balance_change': {'type': ['null', 'array'], 'items': True}, 'explorer_detail_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'blockinfo_detail_raw': {'type': ['null', 'array'], 'items': {'type': 'integer', 'maximum': 255, 'minimum': 0}}, 'token_balance_change': {'type': ['null', 'array'], 'items': True}, 'internal_transactions': {'type': ['null', 'array'], 'items': True}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'chain': {'type': 'string', 'description': 'Chain; normalized e.g. eth→Ethereum; filters chain_breakdown.'}, 'limit': {'type': 'integer', 'description': 'Rows; default 10, max 400.'}, 'sort_by': {'type': 'string', 'description': 'volume_24h (default)|volume_7d|deposit_txs_24h.'}, 'bridge_name': {'type': 'string', 'description': 'Bridge name (ASCII case-insensitive after trim/space normalize); omit for ranked list without chain_breakdown.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['bridge_name', 'chain', 'sort_by', 'limit', 'total', 'count', 'items', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'total': {'type': 'integer'}, 'sort_by': {'type': 'string'}, 'bridge_name': {'type': 'string'}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol'], 'properties': {'limit': {'type': 'integer', 'description': 'Max rows; default 20, max 100.'}, 'symbol': {'type': 'string', 'description': 'Base asset e.g. BTC, ETH.'}, 'exchange': {'type': 'string', 'description': 'Venue e.g. BINANCE; when set with exchange index, filters exchange dimension.'}, 'data_scope': {'type': 'string', 'description': 'exchange|market; default market if only market index configured, else exchange when exchange set.'}, 'market_type': {'type': 'string', 'description': 'spot|perp (maps to SPOT|PERP); default perp.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'market_type', 'exchange', 'data_scope', 'limit', 'total', 'count', 'items', 'duration_ms'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'total': {'type': 'integer'}, 'symbol': {'type': 'string'}, 'exchange': {'type': 'string'}, 'data_scope': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'market_type': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['metric_group'], 'properties': {'chain': {'type': 'string', 'description': 'Chain; staking defaults empty to ethereum; l2 supports base/arbitrum/optimism/linea/zksync_era/blast or empty for all chains; btc_l2 defaults empty to btc (required).'}, 'limit': {'type': 'integer', 'description': 'l2 only: max series rows returned; 0 means no extra cap beyond date window.'}, 'project': {'type': 'string', 'description': 'btc_l2 only: filter by project_key; empty returns whitelist (stacks|rootstock|merlin|bob|bitlayer). Non-whitelist project returns data_status=not_in_scope.'}, 'end_date': {'type': 'string', 'description': 'YYYY-MM-DD; default latest part_date in index.'}, 'lookback': {'type': 'string', 'description': '30d|90d|1y when start_date empty; default 30d.'}, 'start_date': {'type': 'string', 'description': 'YYYY-MM-DD; default derived from lookback or 30d.'}, 'granularity': {'type': 'string', 'description': 'l2 only: day (default); hour or minute returns unsupported_granularity.'}, 'metric_group': {'type': 'string', 'description': 'Metric group: staking (Ethereum beacon daily) | l2 (L2 ops daily from growthepie+L2Beat) | btc_l2 (BTC L2 protocol ecosystem tvl/protocol_count/tx_count_1d/active_addresses_1d/bridge_volume_24h_usd from dwd_external_btc_protocol_di).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['chain', 'metric_group', 'normalized_chain', 'start_date', 'end_date', 'total', 'count', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer'}, 'total': {'type': 'integer'}, 'end_date': {'type': 'string'}, 'lookback': {'type': 'string'}, 'l2_metrics': {'type': ['null', 'object'], 'required': ['series'], 'properties': {'series': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['date', 'chain', 'data_status'], 'properties': {'date': {'type': 'string'}, 'chain': {'type': 'string'}, 'tvl_usd': {'type': ['null', 'number']}, 'tps_avg_1d': {'type': ['null', 'number']}, 'data_source': {'type': 'string'}, 'data_status': {'type': 'string'}, 'stage_label': {'type': 'string'}, 'missing_fields': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'blob_cost_usd_1d': {'type': ['null', 'number']}, 'active_addresses_1d': {'type': ['null', 'number']}, 'sequencer_revenue_usd_1d': {'type': ['null', 'number']}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'start_date': {'type': 'string'}, 'data_status': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'granularity': {'type': 'string'}, 'metric_group': {'type': 'string'}, 'btc_l2_metrics': {'type': ['null', 'object'], 'required': ['items'], 'properties': {'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['date', 'project_key', 'project_name', 'category', 'main_chain', 'data_status'], 'properties': {'date': {'type': 'string'}, 'tvl_usd': {'type': ['null', 'number']}, 'category': {'type': 'string'}, 'main_chain': {'type': 'string'}, 'data_status': {'type': 'string'}, 'project_key': {'type': 'string'}, 'source_refs': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'tx_count_1d': {'type': ['null', 'integer']}, 'project_name': {'type': 'string'}, 'protocol_count': {'type': ['null', 'integer']}, 'active_addresses_1d': {'type': ['null', 'integer']}, 'bridge_volume_24h_usd': {'type': ['null', 'number']}, 'missing_optional_fields': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'missing_required_fields': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'end_date_capped': {'type': 'boolean'}, 'range_truncated': {'type': 'boolean'}, 'staking_metrics': {'type': ['null', 'object'], 'required': ['series'], 'properties': {'series': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['date', 'data_status'], 'properties': {'date': {'type': 'string'}, 'eth_supply': {'type': ['null', 'number']}, 'data_status': {'type': 'string'}, 'quality_note': {'type': 'string'}, 'staking_rate': {'type': ['null', 'number']}, 'exit_queue_eth': {'type': ['null', 'number']}, 'exit_wait_days': {'type': ['null', 'number']}, 'missing_fields': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'staking_apr_7d': {'type': ['null', 'number']}, 'entry_queue_eth': {'type': ['null', 'number']}, 'entry_wait_days': {'type': ['null', 'number']}, 'validator_active': {'type': ['null', 'number']}, 'total_value_staked_eth': {'type': ['null', 'number']}, 'exit_queue_validator_estimate': {'type': ['null', 'number']}, 'entry_queue_validator_estimate': {'type': ['null', 'number']}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'normalized_chain': {'type': 'string'}, 'start_date_capped': {'type': 'boolean'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'category': {'type': 'string', 'description': 'all|defi|spot|perp|stablecoin|bridge or platform type; unknown values passed through; empty if no match.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['category', 'total', 'count', 'items', 'duration_ms'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'total': {'type': 'integer'}, 'category': {'type': 'string'}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'asset': {'type': 'string', 'description': 'Asset filter: BTC|ETH|USDT|USDC; default BTC.'}, 'limit': {'type': 'integer', 'description': 'Max flow rows; default 100, max 400.'}, 'scope': {'type': 'string', 'description': 'basic (default)|full; full adds por + optionally flows/events.'}, 'end_date': {'type': 'string', 'description': 'YYYY-MM-DD; default today. Filter flows by part_date.'}, 'exchange': {'type': 'string', 'description': 'Exchange name; empty returns all exchanges. Supports okx→okx, gate.io→gate via normalized mapping.'}, 'event_type': {'type': 'string', 'description': 'all|large_flow; filter events. Effective only when include_events=true.'}, 'start_date': {'type': 'string', 'description': 'YYYY-MM-DD; default end_date - 30d. Filter flows by part_date.'}, 'include_flows': {'type': 'boolean', 'description': 'scope=full only. true returns flows.series[].'}, 'history_window': {'type': 'string', 'description': 'Only effective when include_history=true; currently only quarter is supported.'}, 'include_events': {'type': 'boolean', 'description': 'scope=full only. true returns events[].'}, 'include_history': {'type': 'boolean', 'description': 'Default false. true returns precomputed comparison fields only, not raw historical snapshots.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['exchange', 'asset', 'scope', 'include_history', 'history_window', 'total', 'count', 'items', 'duration_ms'], 'properties': {'asset': {'type': 'string'}, 'count': {'type': 'integer'}, 'flows': {'type': ['null', 'object'], 'required': ['series'], 'properties': {'series': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['exchange_name', 'asset', 'metric_date'], 'properties': {'asset': {'type': 'string'}, 'price_usd': {'type': ['null', 'number']}, 'metric_date': {'type': 'string'}, 'reserve_usd': {'type': ['null', 'number']}, 'exchange_name': {'type': 'string'}, 'inflow_native': {'type': ['null', 'number']}, 'outflow_native': {'type': ['null', 'number']}, 'reserve_native': {'type': ['null', 'number']}, 'daily_netflow_usd': {'type': ['null', 'number']}, 'daily_netflow_native': {'type': ['null', 'number']}, 'reserve_change_1d_usd': {'type': ['null', 'number']}, 'reserve_change_7d_usd': {'type': ['null', 'number']}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'scope': {'type': 'string'}, 'total': {'type': 'integer'}, 'events': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['event_type', 'exchange_name', 'asset', 'metric_date'], 'properties': {'asset': {'type': 'string'}, 'event_type': {'type': 'string'}, 'metric_date': {'type': 'string'}, 'exchange_name': {'type': 'string'}, 'threshold_usd': {'type': ['null', 'number']}, 'large_flow_event': {'type': ['null', 'boolean']}, 'daily_netflow_usd': {'type': ['null', 'number']}, 'rolling_30d_std_usd': {'type': ['null', 'number']}}, 'additionalProperties': False}}, 'end_date': {'type': 'string'}, 'exchange': {'type': 'string'}, 'event_type': {'type': 'string'}, 'start_date': {'type': 'string'}, 'data_status': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'include_flows': {'type': 'boolean'}, 'status_reason': {'type': 'string'}, 'history_window': {'type': 'string'}, 'include_events': {'type': 'boolean'}, 'include_history': {'type': 'boolean'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol'], 'properties': {'range': {'type': 'string', 'description': 'Price range or bucket spec.'}, 'symbol': {'type': 'string', 'description': 'Symbol e.g. BTC, ETH.'}, 'exchange': {'type': 'string', 'description': 'Exchange; empty = all venues.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'exchange', 'range', 'total', 'count', 'items', 'duration_ms'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'range': {'type': 'string'}, 'total': {'type': 'integer'}, 'symbol': {'type': 'string'}, 'exchange': {'type': 'string'}, 'duration_ms': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'metrics': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'tvl|volume|fees|revenue|volume_perps; default [tvl] when empty. volume_perps returns series when present in platform_history (GAP-001).'}, 'end_date': {'type': 'string', 'description': 'End YYYY-MM-DD.'}, 'start_date': {'type': 'string', 'description': 'Start YYYY-MM-DD.'}, 'granularity': {'type': 'string', 'description': 'day|week|month|quarter; used for volume_perps field mapping in derivatives history index; default day.'}, 'exchange_slug': {'type': 'string', 'description': 'DWS exchange_slug (e.g. gate); optional if platform_name is set.'}, 'platform_name': {'type': 'string', 'description': 'Protocol or platform display name; optional if exchange_slug is set. For volume_perps, expanded to DWS exchange_slug-style keys (e.g. Gate.io→gate) like merge path.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['platform_name', 'metrics', 'start_date', 'end_date', 'total', 'count', 'items', 'duration_ms'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'total': {'type': 'integer'}, 'metrics': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'end_date': {'type': 'string'}, 'start_date': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'platform_name': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['platform_name'], 'properties': {'scope': {'type': 'string', 'description': 'basic (default)|with_chain_breakdown (adds tvl_by_chain, volume_by_chain)|full (adds history_30d, top_pools, competition_metrics).'}, 'platform_name': {'type': 'string', 'description': 'Protocol or platform name.'}, 'oi_symbol_limit': {'type': 'integer', 'description': 'Effective only when include_oi_symbol_detail=true. Default 20, range 1-100; >100 returns invalid_param.'}, 'include_oi_symbol_detail': {'type': 'boolean', 'description': 'scope=full only. true returns competition_metrics.oi_symbol_detail[] sorted by OI USD desc; default false.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['platform_name', 'scope', 'total', 'count', 'items', 'duration_ms'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'scope': {'type': 'string'}, 'total': {'type': 'integer'}, 'duration_ms': {'type': 'integer'}, 'platform_name': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'chain': {'type': 'string', 'description': 'Chain filter; list mode restricts to stables with presence on chain. Extensions: all (default) or normalized chain e.g. ethereum/tron/solana/polygon.'}, 'limit': {'type': 'integer', 'description': 'List size; default 10, max 400; single row when symbol set.'}, 'scope': {'type': 'string', 'description': 'basic (default)|full; full required for sections.'}, 'symbol': {'type': 'string', 'description': 'Stablecoin symbol USDT/USDC/DAI/FDUSD/PYUSD; omit for ranked list or extension defaults.'}, 'end_date': {'type': 'string', 'description': 'UTC YYYY-MM-DD; extension window end, default latest data date for usage_structure or today for issuance_flow/depeg_events.'}, 'sections': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': 'Comma-separated string or array; supported values: issuance_flow, usage_structure, depeg_events when scope=full.'}, 'start_date': {'type': 'string', 'description': 'UTC YYYY-MM-DD; extension window start, default last 30 days. depeg_events: default 2020-01-01.'}, 'min_deviation': {'type': 'number', 'description': 'depeg_events only: filter events with max_deviation >= this value. Range 0.001-0.2, default 0.005.'}, 'review_status': {'type': 'string', 'description': 'depeg_events only: candidate|approved|rejected; default approved (only returns reviewed events).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['symbol', 'chain', 'limit', 'total', 'count', 'items', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'scope': {'type': 'string'}, 'total': {'type': 'integer'}, 'symbol': {'type': 'string'}, 'end_date': {'type': 'string'}, 'start_date': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'depeg_events': {'type': ['null', 'object'], 'required': ['data_status', 'status_reason', 'items'], 'properties': {'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['depeg_asset', 'event_start_time', 'event_end_time', 'depeg_direction', 'price_source', 'latest_price_time'], 'properties': {'min_price': {'type': ['null', 'number']}, 'depeg_asset': {'type': 'string'}, 'price_source': {'type': 'string'}, 'max_deviation': {'type': ['null', 'number']}, 'trigger_price': {'type': ['null', 'number']}, 'event_end_time': {'type': ['null', 'string']}, 'depeg_direction': {'type': 'string'}, 'depeg_threshold': {'type': ['null', 'number']}, 'duration_minutes': {'type': ['null', 'integer']}, 'event_start_time': {'type': 'string'}, 'latest_price_time': {'type': ['null', 'string']}, 'observation_count': {'type': ['null', 'integer']}, 'trigger_deviation': {'type': ['null', 'number']}, 'max_deviation_price': {'type': ['null', 'number']}, 'max_observation_gap_minutes': {'type': ['null', 'integer']}}, 'additionalProperties': False}}, 'data_status': {'type': 'string'}, 'status_reason': {'type': ['null', 'string']}}, 'additionalProperties': False}, 'min_deviation': {'type': 'number'}, 'issuance_flows': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['symbol', 'chain', 'window_start', 'window_end', 'summary', 'series'], 'properties': {'chain': {'type': 'string'}, 'series': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['date', 'chain'], 'properties': {'date': {'type': 'string'}, 'chain': {'type': 'string'}, 'net_issuance': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'supply_issued': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'supply_redeemed': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'symbol': {'type': 'string'}, 'summary': {'type': 'object', 'properties': {'net_issuance': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'mint_burn_net': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'supply_burned': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'supply_issued': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'supply_minted': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'supply_redeemed': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'window_end': {'type': 'string'}, 'quality_note': {'type': 'string'}, 'window_start': {'type': 'string'}, 'chain_breakdown': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['chain'], 'properties': {'chain': {'type': 'string'}, 'net_issuance': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'supply_issued': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'supply_redeemed': {'type': ['null', 'object'], 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'additionalProperties': False}}, 'range_truncated': {'type': 'boolean'}, 'usage_structure': {'type': ['null', 'object'], 'required': ['window_start', 'window_end', 'items'], 'properties': {'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['symbol', 'chain', 'adjusted_transfer_volume', 'bot_share', 'retail_transfer_change', 'stablecoin_trade_volume', 'reference_metrics', 'research_reference', 'missing_fields', 'data_status', 'row_count'], 'properties': {'chain': {'type': 'string'}, 'symbol': {'type': 'string'}, 'bot_share': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'row_count': {'type': 'integer'}, 'data_status': {'type': 'string'}, 'missing_fields': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'reference_metrics': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'research_reference': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'retail_transfer_change': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'stablecoin_trade_volume': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}, 'adjusted_transfer_volume': {'type': 'object', 'required': ['Value', 'Valid'], 'properties': {'Valid': {'type': 'boolean'}, 'Value': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'window_end': {'type': 'string'}, 'window_start': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'chain': {'type': 'string', 'description': 'Chain filter.'}, 'limit': {'type': 'integer', 'description': 'Rows; default 20, max 400.'}, 'scope': {'type': 'string', 'description': 'basic (default)|full. full adds apy_base_30d, apy_reward_30d, reward_tokens, market_share.'}, 'symbol': {'type': 'string', 'description': 'Asset e.g. USDC, ETH-USDC.'}, 'project': {'type': 'string', 'description': 'Protocol e.g. aave-v3.'}, 'sort_by': {'type': 'string', 'description': 'apy|tvl_usd; default apy.'}, 'pool_type': {'type': 'string', 'description': 'Exposure single|multi or Lending|LP|Staking; maps to ES exposure.'}, 'min_tvl_usd': {'type': ['null', 'number'], 'description': 'Min TVL USD; default 100000 when omitted; 0 = no floor.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['project', 'chain', 'symbol', 'pool_type', 'sort_by', 'min_tvl_usd', 'limit', 'scope', 'total', 'count', 'items', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'scope': {'type': 'string'}, 'total': {'type': 'integer'}, 'symbol': {'type': 'string'}, 'project': {'type': 'string'}, 'sort_by': {'type': 'string'}, 'pool_type': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'min_tvl_usd': {'type': 'number'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'chain': {'type': 'string', 'description': 'Chain filter.'}, 'limit': {'type': 'integer', 'description': 'Rows; default 20, max 400.'}, 'sort_by': {'type': 'string', 'description': 'tvl|volume_24h|volume_spot_24h|volume_perps_24h|volume_perps_7d|volume_perps_30d|volume_perps_qtd|fees_24h; default tvl.'}, 'sort_order': {'type': 'string', 'description': 'asc|desc; default desc. When CEX + sort_by volume_perps_* uses the HF derivatives sub-index only, ranking follows this order; response echoes the normalized value.'}, 'platform_type': {'type': 'string', 'description': 'Optional filter on platform_info.platform_type. Empty or all = no filter. dex|dexs|dexes map to DEX+Dexs; derivatives|cex as labeled; defi expands to DeFi TVL group; any other value is passed through to the index (e.g. Lending, CDP, Yield).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['platform_type', 'chain', 'sort_by', 'limit', 'total', 'count', 'items', 'duration_ms'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer'}, 'items': {'type': ['null', 'array'], 'items': {'type': 'object', 'additionalProperties': True}}, 'limit': {'type': 'integer'}, 'total': {'type': 'integer'}, 'sort_by': {'type': 'string'}, 'sort_order': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'platform_type': {'type': 'string'}}, 'additionalProperties': False}