MCP Server
Connect any AI assistant to GateData.ai's real-time financial data through our official remote MCP server.
Overview
GateData.ai ships a complete MCP server so your AI assistant can pull live market data, asset identity, fundamentals, estimates, events & news, and prediction markets — across crypto and public equities, under one object model.
Getting Started
Get started with the base URL: https://mcp.gatedata.ai/mcp
Codex CLI
Open Codex and paste in natural language
Help me auto install GateData MCP: https://github.com/gate/gate-data-ai-agent
On Team and Enterprise plans, a workspace owner must add the connector in admin settings first.
Need REST / OpenAPI instead?View the full OpenAPI specMCP Server Tools
Two HTTP surfaces exist: (1) **Streamable HTTP** POST/GET /mcp — standard MCP JSON-RPC (initialize, tools/list, tools/call). (2) **Tool invoke** POST /mcp/{endpoint} (e.g. /mcp/markets) — body { "tool", "arguments" } only; **not** JSON-RPC and does not speak initialize. Domain tool names and schemas stay identical across invoke prefixes; there are no per-endpoint aliases.
Tool-invoke prefix for assets, entities, fundamentals, estimates and equity ownership. Body: { tool, arguments }.
Tool-invoke prefix for market_data_query (snapshots, klines, top_of_book). Not MCP JSON-RPC — use POST /mcp for initialize/tools/list.
Network & Protocol: six dedicated tools plus onchain_query. Risk uses /mcp/signals or /mcp/all.
News, events, sentiment, prediction markets and Risk.
Lists all catalogued domain tools (availability varies by tool).
Response status description
Beyond ok/ready/partial/not_ready, domain tools share no_data and ambiguous shapes. no_data is always HTTP 200 (object resolved, no rows). **Ambiguous:** assets / fundamentals / earnings / prediction name multi-matches return HTTP **200** with resolution_status=ambiguous and candidates or data[] (ask the user — not a hard transport failure). **Market listing** pin gaps still return HTTP **400** ambiguous_object_resolution with candidates + required_params. News/query disambiguation candidates pin with **ticker + market** (never invent us_equity:TICKER as a public id). Crypto fundamentals profile returns empty_reason=market_not_served with guidance to tokenomics/assets. Conflicting flat vs object_refs identity returns param_conflict. Closed prediction books return market_closed.
{ "metadata": { // Response metadata (data_status, limitations, object_refs) "data_status": "<string>", // Data status — no_data means the asset resolved but no snapshot row "limitations": [ // Coverage / capability flags (e.g. ["no_data"]) "<string>" ], "object_refs": [ // Unified object model resolution info (lightweight F0 refs) { "type": "<string>", // Object type (asset / listing / …) "id": "<string>", // Canonical object id for this ref "asset_id": "<string>", // Related asset id (often equals id when type=asset) "resolved_from": "<string>", // How the ref was resolved (e.g. asset, query) "resolution_confidence": "<string>" // Resolver confidence (e.g. default) } ] }, "next_action": "<string>", // Human-readable guidance for the next retry "reason": "<string>", // Why the domain returned no rows "request_id": "<string>", // Request correlation id for support / logs "try_params": { // Echo of resolved params used for this attempt "asset_id": "<string>", // Resolved asset id from the query "query": "<string>" // Original natural-language / ticker query } }
reason / next_action, optionally echo try_params. Never show a system error or invent price fields.{ "data": [], // Domain payload; empty array [] or empty object {} when no rows "data_status": "<string>", // Data status — no_data means the object resolved but this domain has no rows "empty_reason": "<string>", // Empty-result reason code (e.g. no_results) "error": null, // Error object; null for HTTP 200 empty / success envelopes "lineage_refs": [], // Snapshot provenance; [] when none attached. source is a stable role (estimates / calendar / results / consensus), never an internal service name "metadata": { // Response metadata (routing, limitations, object_refs) "actual_task": "<string>", // Task after routing. Market MCP only on market bodies (pinned REST market paths omit). Estimates/fundamentals envelopes may include it on REST captures too. "limitations": null, // Capability / coverage limitations; may be null when none "object_refs": [], // Unified object model resolution info (lightweight F0 refs) "object_refs_validation_status": "<string>", // Validation status of inbound object_refs (e.g. not_provided) "route_reason": "<string>", // Why this task/route was selected "updated_at": "<date>" // Metadata timestamp (ISO-8601) }, "request_id": "<string>" // Request correlation id for support / logs }
empty_reason copy. Never render an error, insert a default object, or coerce the empty array to null.{ "data": [ // Candidate list (array) for the user / agent to pick from { "asset_id": "<string>", // Candidate asset id for a follow-up call "listing_id": "<string>", // Candidate listing id when known "entity_id": "<string>", "display_name": "<string>", // Human-readable company / asset name "display_symbol": "<string>", "market": "<string>", "match_confidence": "<number>", "matched_field": "<string>", "matched_value": "<string>", "disambiguation_hint": "<string>" // Suggested params to narrow the next call } ], "data_status": "<string>", // ok when candidates are returned "empty_reason": null, "error": null, // Always null on this success path "resolution_status": "<string>", // ambiguous — multiple assets matched; confirm with the user (not a tool failure) "lineage_refs": [], "source_refs": [], "metadata": { "actual_task": "<string>", "object_refs": [], // Empty on ambiguous — no silent primary binding "object_refs_validation_status": "<string>", "route_reason": "<string>" // Server routing reason (e.g. ambiguous_candidates) }, "request_id": "<string>" // Request correlation id for support / logs }
resolution_status=ambiguous (or ambiguous: true). Show data[] / candidates to the user; retry with ticker+market or listing_id / asset_id. Same pattern for fundamentals, earnings, and prediction where resolved. Do not invent or reuse legacy us_equity:TICKER ids.{ "error": "<string>", // Error type id (ambiguous_object_resolution) "error_code": "<string>", // Business error code (same string; maps to 40001 in legacy clients) "message": "<string>", // Human-readable error summary "required_params": [ // Parameters required to disambiguate the next call "<string>", "<string>" ], "candidates": [ // Matched candidate objects — pick listing_id / venue / market_type { "listing_id": "<string>", // Canonical listing id for an exact retry "asset_id": "<string>", // Resolved asset id for the candidate "venue": "<string>", // Exchange / venue code (e.g. gate, binance) "market_type": "<string>" // Market type (e.g. spot, perp) } ], "next_action": "<string>", // Suggested follow-up (e.g. retry_with_listing_id) "request_id": "<string>" // Request correlation id for support / logs }
candidates and required_params, then retry with listing_id or venue+market_type. Do not silently pick the first candidate.Call patterns
Domain tools take a natural-language query by default. Use task=auto and let the server pick the in-domain task, or pass an explicit task when you already know what you need. Only when chaining across domains should you pass prior metadata.object_refs[]. Everyday business queries do not need a prior assets_resolve call.
The server picks an in-domain task (for example snapshot for a latest-price question). context.market only ranks fuzzy names; it never overrides an exact ticker or listing.
{
"tool": "market_data_query",
"arguments": {
"query": "AAPL latest price",
"task": "auto",
"context": { "market": "us_equity" }
}
}Pass a supported task when you already know the route (snapshot / kline / content_search / …). The same tool name and schema apply on every install endpoint.
{
"tool": "market_data_query",
"arguments": {
"query": "AAPL",
"task": "snapshot",
"context": { "market": "us_equity" }
}
}Each tool returns only its own primary data plus lightweight metadata.object_refs[]. Pass those refs into the next tool when you need evidence in another domain.
- market_data_query("MU why did it jump yesterday?") → market anomaly facts + metadata.object_refs[]
- Pass the same object_refs into events_news_query with task=content_search or event_search
- Events returns news / event evidence — not a substitute for Market Data prices
The assistant may not always run a second step on its own. For reliable cross-domain attribution, use a later composite tool or workflow — do not overload a single domain tool.
Tool Catalog
Use production tools/list on /mcp for discovery. Network & Protocol has six dedicated tools plus onchain_query. Risk supports observations, snapshot and token_security; events is coming soon; auto is not supported.
context.market standard codes: us_equity / hk_equity / kr_equity / uk_equity / jp_equity / crypto (never ks_equity). Standard market enum & serving notes →
/mcp/assetsAssets & fundamentalsassets_resolve · fundamentals_query · estimates_earnings_query
assets_resolveAsset & EntityUser asks to resolve, search, or fetch asset object metadata: listings, deployments, ticker/contract/Gate symbol to asset_id; including commodity CFD (gold -> commodity_gold / listing_gate_cfd_*). task=profile here returns object metadata only - not company fundamentals text.
Related REST (8)
POST /v1/assets/resolvePOST /v1/assets/resolveGET /v1/assets/searchGET /v1/assets/{id}GET /v1/assets/{id}/listingsGET /v1/instruments/{instrument_id}GET /v1/assets/{asset_id}/deploymentsPOST /v1/assets/resolveCall Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | search | AAPL | 200 | ok | 770 ms |
POST https://mcp.gatedata.ai/mcp/assets
{
"tool": "assets_resolve",
"arguments": {
"query": "AAPL",
"task": "search",
"context": {
"market": "us_equity"
}
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"data": [
{
"asset_id": "<string>",
"disambiguation_hint": null,
"display_name": "<string>",
"display_symbol": "<string>",
"entity_id": "<string>",
"instrument_id": "<string>",
"listing_id": "<string>",
"market": "<string>",
"match_confidence": "<number>",
"matched_field": "<string>",
"matched_value": "<string>",
"venue_id": "<string>"
}
],
"data_status": "<string>",
"empty_reason": null,
"error": null,
"lineage_refs": [],
"metadata": {
"actual_task": "<string>",
"domain_bindings": {
"events_news": {
"entity_id": "<string>"
},
"fundamentals": {
"entity_id": "<string>"
},
"market_data": {
"listing_id": "<string>"
},
"news": {
"asset_id": "<string>"
}
},
"object_refs": [
{
"id": "<string>",
"type": "<string>"
}
],
"object_refs_validation_status": "<string>",
"route_reason": "<string>"
},
"resolution_status": "<string>",
"source_refs": []
}fundamentals_queryFundamentalsUser asks for company fundamentals (profile/background, statements, segments, corporate actions, metrics/summary), crypto tokenomics/supply, or commodity CFD facts: price series, official fear/greed sentiment, CFTC positioning, supply/demand, inventory, macro (FRED/H.10 incl. FX series), weather by location_key, or logistics disruptions. Use task=profile for company fundamentals text - not assets_resolve. Commodity official scores use task=sentiment (not events_news_query sentiment).
Related REST (23)
GET /v1/fundamentals/queryGET /v1/fundamentals/profileGET /v1/fundamentals/profileGET /v1/fundamentals/statementsGET /v1/fundamentals/statementsGET /v1/fundamentals/metricsGET /v1/fundamentals/metricsGET /v1/fundamentals/business-segmentsGET /v1/fundamentals/corporate-actionsGET /v1/fundamentals/tokenomicsGET /v1/fundamentals/supplyGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryGET /v1/fundamentals/queryCall Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | profile | AAPL | 200 | partial | 380 ms |
| 2 | statements | AAPL | 200 | ok | 410 ms |
| 3 | summary | AAPL | 200 | partial | 520 ms |
POST https://mcp.gatedata.ai/mcp/assets
{
"tool": "fundamentals_query",
"arguments": {
"query": "AAPL",
"task": "summary",
"ticker": "AAPL",
"context": {
"market": "us_equity"
}
}
}limitations: serving_mvp, valuation_current_out_of_scope, summary_aggregates_profile_statements_metrics_actions
This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"data": {
"summary": {
"actions": [
{
"acquiree_rate": null,
"acquiree_symbol": null,
"acquirer_rate": null,
"acquirer_symbol": null,
"action_sub_type": "<string>",
"action_type": "<string>",
"alternate_rate": null,
"alternate_symbol": null,
"amount": null,
"announcement_date": null,
"asset_id": null,
"cash_per_share": null,
"cash_rate": null,
"corporate_action_id": "<string>",
"currency": null,
"data_status": "<string>",
"effective_date": "<date>",
"empty_reason": null,
"entity_id": null,
"ex_date": "<date>",
"expiration_date": null,
"instrument_id": null,
"listing_id": null,
"new_symbol": null,
"old_symbol": null,
"payment_date": "<date>",
"price": null,
"process_date": "<date>",
"ratio": "<string>",
"ratio_from": "<number>",
"ratio_to": "<number>",
"record_date": "<date>",
"source_rate": null,
"source_symbol": null,
"target_rate": null,
"target_symbol": null,
"venue_id": null
}
],
"as_of": "<date>",
"blocks": [
{
"block": "<string>",
"data_status": "<string>",
"empty_reason": "<string>"
}
],
"metrics": [
{
"as_of_utc": "<date>",
"data_status": "<string>",
"empty_reason": null,
"entity_id": "<string>",
"metric_name": "<string>",
"metric_value": "<number>",
"period_key": "<string>",
"unit": null
}
],
"profile": {
"business_scope": null,
"company_name": "<string>",
"data_status": "<string>",
"description": "<string>",
"employee_count": "<number>",
"empty_fields": [
{
"empty_reason": "<string>",
"field": "<string>"
}
],
"empty_reason": "<string>",
"entity_id": "<string>",
"headquarters_country": "<string>",
"industry": null,
"management": [
{
"management_name": "<string>",
"management_position": "<string>"
}
],
"profile_as_of": "<date>",
"profile_items": [
{
"field_type": "<string>",
"profile_key": "<string>",
"profile_name": "<string>",
"profile_value": "<string>"
}
],
"reporting_currency": null,
"sector": null,
"website": "<string>"
},
"statements": [
{
"currency": "<string>",
"data_status": "<string>",
"empty_reason": null,
"entity_id": "<string>",
"line_items": {
"accounts_payable": "<number>",
"accounts_receivable": "<number>",
"accrued_expenses": "<number>",
"accumulated_depreciation": "<number>",
"available_for_sale_securities": "<number>",
"capital_stock": "<number>",
"cash_and_cash_equivalents": "<number>",
"cash_cash_equivalents_and_short_term_investments": "<number>",
"common_stock": "<number>",
"current_assets": "<number>",
"current_deferred_liabilities": "<number>",
"current_liabilities": "<number>",
"gains_losses_not_affecting_retained_earnings": "<number>",
"gross_p_p_e": "<number>",
"inventory": "<number>",
"long_term_debt": "<number>",
"long_term_debt_and_capital_lease_obligation": "<number>",
"net_p_p_e": "<number>",
"non_current_assets": "<number>",
"non_current_deferred_assets": "<number>",
"non_current_liabilities": "<number>",
"other_current_assets": "<number>",
"other_current_liabilities": "<number>",
"other_non_current_assets": "<number>",
"other_non_current_liabilities": "<number>",
"other_receivables": "<number>",
"payables": "<number>",
"receivables": "<number>",
"retained_earnings": "<number>",
"short_term_debt": "<number>",
"short_term_debt_and_capital_lease_obligation": "<number>",
"short_term_investments": "<number>",
"stockholders_equity": "<number>",
"stockholders_equity_attributable_to_parent": "<number>",
"taxes_payable": "<number>",
"total_assets": "<number>",
"total_investments": "<number>",
"total_liabilities": "<number>",
"total_liabilities_net_minority_interest": "<number>"
},
"period_end": "<date>",
"period_key": "<string>",
"period_start": null,
"period_type": "<string>",
"statement_type": "<string>",
"unit": "<string>"
}
],
"window": "<string>"
}
},
"data_status": "<string>",
"empty_reason": "<string>",
"error": null,
"external_refs": [
{
"citation_url": "<string>",
"entity_id": "<string>",
"external_ref_id": "<string>",
"external_ref_type": "<string>",
"external_source_domain": "<string>",
"filing_form": "<string>"
}
],
"lineage_refs": [],
"metadata": {
"actual_task": "<string>",
"data_status": "<string>",
"limitations": [
"<string>",
"<string>",
"<string>"
],
"object_refs": [
{
"asset_id": "<string>",
"entity_id": "<string>",
"id": "<string>",
"instrument_id": "<string>",
"listing_id": "<string>",
"type": "<string>",
"venue_id": "<string>"
}
],
"partial": "<boolean>",
"route_reason": "<string>",
"updated_at": "<date>"
},
"source_refs": []
}estimates_earnings_queryEstimates & EarningsUser asks for earnings dates, reported results/surprises, or analyst consensus estimates.
Call Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | calendar | AAPL | 200 | ok | 210 ms |
| 2 | results | AAPL | 200 | ok | 240 ms |
| 3 | consensus | AAPL | 200 | ok | 180 ms |
POST https://mcp.gatedata.ai/mcp/assets
{
"tool": "estimates_earnings_query",
"arguments": {
"query": "AAPL",
"task": "calendar",
"context": {
"market": "us_equity"
}
}
}limitations: source_refs_unavailable
This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"data": {
"events": [
{
"asset_id": "<string>",
"data_status": "<string>",
"date_confirmed": "<boolean>",
"date_precision": "<string>",
"earnings_event_id": "<string>",
"empty_reason": null,
"entity_id": "<string>",
"event_status": "<string>",
"fiscal_period": "<string>",
"instrument_id": "<string>",
"listing_id": "<string>",
"period_type": "<string>",
"report_date": "<date>",
"report_time_type": "<string>",
"timezone": "<string>",
"venue_id": "<string>"
}
]
},
"data_status": "<string>",
"empty_reason": null,
"error": null,
"external_refs": [
{
"citation_url": "<string>",
"entity_id": "<string>",
"external_ref_id": "<string>",
"external_ref_type": "<string>",
"external_source_domain": "<string>"
}
],
"lineage_refs": [
{
"data_status": "<string>",
"source": "<string>",
"stage": "<string>"
}
],
"metadata": {
"actual_task": "<string>",
"limitations": [
"<string>"
],
"object_refs": [
{
"asset_id": "<string>",
"entity_id": "<string>",
"id": "<string>",
"instrument_id": "<string>",
"listing_id": "<string>",
"resolved_from": "<string>",
"type": "<string>",
"venue_id": "<string>"
}
],
"route_reason": "<string>",
"updated_at": "<date>"
},
"request_id": "<string>",
"source_refs": []
}/mcp/marketsMarkets & klinemarket_data_query
market_data_queryMarket & LiquidityUser asks for price, kline, or order book (crypto, equity, or commodity CFD); TradFi/commodity/metal/crypto AI / technical indicators (task=technical_indicators); US/HK/KR/JP equity quote header (task=quote_header); crypto market overview, global market cap chart, or fear/greed history (task=market_overview|crypto_global_marketcap|fear_greed_history); or crypto-only trades, liquidity, CEX depth, derivatives metrics, perp DEX protocol volume/OI (task=dex_derivatives), Gate perp volume history, or Gate hold/pic open interest history.
Related REST (31)
GET /v1/markets/snapshotGET /v1/markets/snapshotGET /v1/markets/klineGET /v1/markets/order-book/currentGET /v1/markets/trades/recentGET /v1/markets/liquidity/historyGET /v1/markets/cex-depthGET /v1/markets/derivativesGET /v1/markets/cex-derivativesGET /v1/markets/dex-derivativesGET /v1/markets/liquidation-heatmapGET /v1/markets/derivatives/liquidationsGET /v1/markets/derivatives/liquidations/aggregatesGET /v1/markets/derivatives/volume-historyGET /v1/markets/open-interest-historyGET /v1/market-overviewGET /v1/global-market-cap-chartGET /v1/markets/tradfi/quote-header-snapshotGET /v1/markets/indicators/fear-greed-index/historyGET /v1/markets/rankingsGET /v1/markets/options/chainGET /v1/markets/dex-overviewGET /v1/markets/dex/tradesGET /v1/markets/dex/liquidity-eventsGET /v1/markets/tradfi/ai-indicatorsGET /v1/market-data/technical-indicatorsGET /v1/markets/crypto/ai-indicatorsGET /v1/markets/indicator-historyGET /v1/markets/crypto/rsi-heatmapGET /v1/markets/trend-klineGET /v1/markets/technical-analysisCall Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | snapshot | BTC | 200 | ready | 344 ms |
POST https://mcp.gatedata.ai/mcp/markets
{
"tool": "market_data_query",
"arguments": {
"query": "BTC",
"task": "snapshot",
"context": {
"market": "crypto"
}
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"count": "<number>",
"data_status": "<string>",
"items": [
{
"kline": {
"market": "<string>"
},
"realtime": {
"price": "<number>",
"price_change_24h": "<number>",
"price_change_24h_pct": "<number>",
"price_change_24h_percent": "<number>"
},
"symbol": "<string>"
}
],
"listing_id": "<string>",
"metadata": {
"object_refs": [
{
"type": "<string>",
"id": "<string>",
"asset_id": "<string>",
"resolved_from": "<string>",
"resolution_confidence": "<string>"
}
],
"updated_at": "<date>",
"data_status": "<string>",
"limitations": []
},
"not_found": [],
"price": "<number>",
"price_change_24h": "<number>",
"price_change_24h_percent": "<number>",
"request_id": "<string>",
"total": "<number>",
"unavailable": [],
"updated_at": "<date>",
"venue_id": "<string>",
"volume_24h": "<number>",
"volume_24h_unit": "<string>"
}/mcp/onchainOn-chain & walletsdefi_overview · defi_protocol · onchain_query · yield_pools · stablecoin_supply · bridge_flows · exchange_reserves
defi_overviewNetwork & ProtocolQuery DeFi TVL, USD-pegged stablecoin supply, DEX volumes, categories and top chains.
Call Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | latest | — | 200 | verified | — |
POST https://mcp.gatedata.ai/mcp/onchain
{
"tool": "defi_overview",
"arguments": {
"top_chains": 2,
"range": "latest"
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"coverage_note": "Snapshot joins overview + category_distribution + top_chains. Latest and history take tvl_usd, stablecoin_supply_usd, total_dex_spot_volume_24h, and total_dex_perps_volume_24h from the overview day snapshot.",
"data": [
{
"category": [
{
"category": "Bridge",
"category_key": "Bridge",
"protocol_count": 179,
"tvl_usd": "56136803479.76111"
}
],
"category_distribution": [
{
"category": "Bridge",
"category_key": "Bridge",
"protocol_count": 179,
"tvl_usd": "56136803479.76111"
}
],
"chain_count": 423,
"coverage_note": "Snapshot joins overview + category_distribution + top_chains. Latest and history take tvl_usd, stablecoin_supply_usd, total_dex_spot_volume_24h, and total_dex_perps_volume_24h from the overview day snapshot.",
"obs_date": "2026-11-15T00:00:00.000+0000",
"observed_at": "2026-11-16T06:12:36Z",
"protocol_count": 8881,
"range": "latest",
"stablecoin_supply_usd": "287427285772.97",
"time": "2026-11-15T00:00:00Z",
"top_chains": [
{
"chain": "Ethereum",
"chain_id": "chain_ethereum",
"chain_name": "Ethereum",
"gecko_id": "ethereum",
"token_symbol": "ETH",
"tvl_usd": "37056706055.746445"
}
],
"total_dex_perps_volume_24h": "28161665540",
"total_dex_spot_volume_24h": "8108190909.090001",
"tvl_usd": "71656364820"
}
],
"data_status": "verified",
"error": null,
"metadata": {
"data_status": "ok",
"entitlements": {
"endpoint": "onchain.defi_overview",
"evidence_fanout_level": "custom",
"field_level": "custom",
"object_resolution_level": "L3"
},
"limitations": [],
"object_refs": [],
"updated_at": "2026-11-16T06:12:36Z"
},
"observed_at": "2026-11-16T06:12:36Z",
"operation_id": "onchain.defi_overview",
"route_code": "direct"
}defi_protocolNetwork & ProtocolQuery a protocol profile, latest TVL and per-chain TVL.
Related REST (2)
Call Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | latest | protocol_lido | 200 | verified | — |
POST https://mcp.gatedata.ai/mcp/onchain
{
"tool": "defi_protocol",
"arguments": {
"protocol_id": "protocol_lido",
"range": "latest"
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"coverage_note": "Protocol profile, TVL history, and per-chain TVL from DefiLlama warehouse.",
"data": [
{
"category": "Liquid Staking",
"chain_count": 5,
"chain_distribution": [
{
"chain": "Ethereum",
"chain_id": "chain_ethereum",
"chain_name": "Ethereum",
"obs_date": "2026-11-15T00:00:00.000+0000",
"tvl_prev_day": "18717533955.905693",
"tvl_prev_month": "23428412753.891903",
"tvl_prev_week": "21774024378.81859",
"tvl_usd": "17319152553.372875"
}
],
"chains": [
"Ethereum"
],
"coverage_note": "Protocol profile, TVL history, and per-chain TVL from DefiLlama warehouse.",
"defillama_id": "182",
"description": "Liquid staking for Ethereum and Polygon. Daily staking rewards, no lock ups.",
"metrics": {
"tvl_prev_day": "18721539391.879917",
"tvl_prev_month": "23433796549.93987",
"tvl_prev_week": "21778673312.403553",
"tvl_usd": "17322691385.600384"
},
"name": "Lido",
"obs_date": "2026-11-15T00:00:00.000+0000",
"observed_at": "2026-11-16T06:12:38Z",
"protocol_id": "protocol_lido",
"range": "latest",
"snapshot_time": "2026-11-15T08:03:34.000+0000",
"symbol": "LDO",
"tvl_prev_day": "18721539391.879917",
"tvl_prev_month": "23433796549.93987",
"tvl_prev_week": "21778673312.403553",
"tvl_usd": "17322691385.600384",
"url": "https://lido.fi/"
}
],
"data_status": "verified",
"error": null,
"metadata": {
"data_status": "ok",
"entitlements": {
"endpoint": "protocols.profile",
"evidence_fanout_level": "custom",
"field_level": "custom",
"object_resolution_level": "L3"
},
"limitations": [],
"object_refs": [
{
"id": "protocol_lido",
"type": "protocol"
}
],
"updated_at": "2026-11-16T06:12:38Z"
},
"observed_at": "2026-11-16T06:12:38Z",
"operation_id": "protocols.profile",
"protocol_id": "protocol_lido",
"route_code": "direct"
}onchain_queryNetwork & ProtocolQuery daily active addresses and transaction counts for a chain.
Related REST (14)
GET /v1/onchain/defi-overviewGET /v1/onchain/defi-overviewGET /v1/onchain/stablecoinsGET /v1/onchain/bridgesGET /v1/onchain/yield-poolsGET /v1/protocols/{id}GET /v1/protocols/{id}GET /v1/protocols/{id}/historyGET /v1/onchain/chains/{chain_id}/activityGET /v1/onchain/chain-metricsGET /v1/onchain/exchange-reservesGET /v1/platforms/profileGET /v1/platforms/rankingsGET /v1/platforms/overviewCall Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | chain_activity | chain_ethereum | 200 | verified | — |
POST https://mcp.gatedata.ai/mcp/onchain
{
"tool": "onchain_query",
"arguments": {
"chain_id": "chain_ethereum",
"range": "latest",
"task": "chain_activity"
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"chain_id": "chain_ethereum",
"coverage_note": "CoinMetrics asset activity (addresses_active / transaction_count); latest prefers paired rows.",
"data": [
{
"activity_pair_status": "paired",
"addresses_active": 828404,
"asset": "eth",
"chain": "Ethereum",
"chain_id": "chain_ethereum",
"obs_date": "2026-11-13T00:00:00.000+0000",
"obs_time": "2026-11-13T08:00:00.000+0000",
"time": "2026-11-13T00:00:00Z",
"transaction_count": 2099945
}
],
"data_status": "verified",
"error": null,
"metadata": {
"data_status": "ok",
"entitlements": {
"endpoint": "onchain.chain_activity",
"evidence_fanout_level": "custom",
"field_level": "custom",
"object_resolution_level": "L3"
},
"limitations": [],
"object_refs": [],
"updated_at": "2026-11-16T06:12:37Z"
},
"observed_at": "2026-11-16T06:12:37Z",
"operation_id": "onchain.chain_activity",
"range": "latest",
"route_code": "direct"
}yield_poolsNetwork & ProtocolQuery DeFi pool TVL, annual percentage yields and pool attributes.
Related REST (1)
Call Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | — | protocol_lido | 200 | verified | — |
POST https://mcp.gatedata.ai/mcp/onchain
{
"tool": "yield_pools",
"arguments": {
"protocol_id": "protocol_lido"
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"coverage_note": "DefiLlama yield pool catalog (apy/tvl/chain/project).",
"data": [
{
"apy": 2.3807,
"apy_base": 2.3807,
"chain": "Ethereum",
"chain_id": "chain_ethereum",
"exposure": "single",
"il_risk": "no",
"metrics": {
"apy": 2.3807,
"apy_base": 2.3807,
"tvl_usd": "17539982536"
},
"pool_id": "747c1d2a-c668-4682-b9f9-296708a3dd90",
"project": "lido",
"reward_tokens": [],
"stablecoin": false,
"symbol": "STETH",
"tvl_usd": "17539982536",
"underlying_tokens": [
"0x0000000000000000000000000000000000000000"
]
}
],
"data_status": "verified",
"error": null,
"limit": 2,
"metadata": {
"data_status": "ok",
"entitlements": {
"endpoint": "onchain.yield_pools",
"evidence_fanout_level": "custom",
"field_level": "custom",
"object_resolution_level": "L3"
},
"limitations": [],
"object_refs": [],
"updated_at": "2026-11-16T06:12:37Z"
},
"observed_at": "2026-11-16T06:12:37Z",
"operation_id": "onchain.yield_pools",
"query": {
"asset": "",
"chain": "",
"protocol": "lido"
},
"route_code": "direct"
}stablecoin_supplyNetwork & ProtocolQuery circulating stablecoin supply and its per-chain distribution.
Related REST (1)
Call Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | — | asset_token_tether | 200 | verified | — |
POST https://mcp.gatedata.ai/mcp/onchain
{
"tool": "stablecoin_supply",
"arguments": {
"asset_id": "asset_token_tether"
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"coverage_note": "Stablecoin supply joins profile + circulating HF + chain supply DF when available.",
"data": [
{
"asset_id": "asset_token_tether",
"chain_distribution": [
{
"chain": "Tron",
"chain_id": "chain_tron",
"chain_name": "Tron",
"circulating": "91922392500.93524",
"circulating_prev_day": "91922392500.93524",
"circulating_prev_month": "92942807508.72388",
"circulating_prev_week": "92256046444.5963"
}
],
"circulating": "175334195000",
"description": "Launched in 2014, Tether tokens pioneered the stablecoin model. Tether tokens are pegged to real-world currencies on a 1-to-1 basis. This offers traders, merchants and funds a low volatility solution when exiting positions in the market.",
"mint_redeem_description": "Tether customers who have undergone a verification process can exchange USD for USDT and redeem USDT for USD.",
"name": "Tether",
"peg_mechanism": "fiat-backed",
"peg_type": "peggedUSD",
"stablecoin_id": "1",
"supply": {
"circulating": "175334195000",
"mint_redeem_description": "Tether customers who have undergone a verification process can exchange USD for USDT and redeem USDT for USD.",
"peg_type": "peggedUSD"
},
"symbol": "USDT"
}
],
"data_status": "verified",
"error": null,
"metadata": {
"data_status": "ok",
"entitlements": {
"endpoint": "onchain.stablecoins",
"evidence_fanout_level": "custom",
"field_level": "custom",
"object_resolution_level": "L3"
},
"limitations": [],
"object_refs": [],
"updated_at": "2026-11-16T06:12:36Z"
},
"observed_at": "2026-11-16T06:12:36Z",
"operation_id": "onchain.stablecoins",
"query": {
"asset": "USDT",
"asset_id": "asset_token_tether",
"chain": ""
},
"route_code": "direct"
}bridge_flowsNetwork & ProtocolQuery bridge-volume rankings, covered chains and snapshot times.
Related REST (1)
Call Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | — | — | 200 | partial | — |
POST https://mcp.gatedata.ai/mcp/onchain
{
"tool": "bridge_flows",
"arguments": {
"scope": "bridge_rankings",
"limit": 2
}
}limitations: data_partial
This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"coverage_note": "Bridge rankings only this release; chain net-flow rankings omitted when not produced.",
"data": {
"bridge_rankings": [
{
"bridge_id": "51",
"chains": [
"Ethereum"
],
"covered_chain_count": 17,
"display_name": "Circle CCTP",
"last_24h_volume": "725875945.8116333",
"last_daily_volume": "714398004.53638",
"monthly_volume": "17891102968.70557",
"name": "circle",
"slug": "circle",
"snapshot_time": "2026-11-14T08:04:45.000+0000",
"url": "https://www.circle.com/en/cross-chain-transfer-protocol",
"weekly_volume": "3586183534.333864"
}
],
"chain_netflow_rankings": []
},
"data_status": "partial",
"error": null,
"limit": 2,
"metadata": {
"data_status": "partial",
"entitlements": {
"endpoint": "onchain.bridges",
"evidence_fanout_level": "custom",
"field_level": "custom",
"object_resolution_level": "L3"
},
"limitations": [
"data_partial"
],
"missing_fields": [
"chain_netflow_rankings"
],
"object_refs": [],
"updated_at": "2026-11-16T06:12:37Z"
},
"missing_fields": [
"chain_netflow_rankings"
],
"observed_at": "2026-11-16T06:12:37Z",
"operation_id": "onchain.bridges",
"route_code": "direct"
}exchange_reservesNetwork & ProtocolQuery the all-exchange BTC reserve total or reserves for one exchange and asset.
Related REST (1)
Call Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | — | asset_btc | 200 | verified | — |
POST https://mcp.gatedata.ai/mcp/onchain
{
"tool": "exchange_reserves",
"arguments": {
"exchange_id": "exchange_aggregated",
"asset_id": "asset_btc"
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"asset_id": "asset_btc",
"coverage_note": "Network-wide ALL_EXCHANGE snapshot is first when exchange is omitted; per-venue chain rows when exchange_id is set.",
"data": [
{
"amount": "2850123.8",
"amount_usd": "186194330000",
"asset": "BTC",
"asset_id": "asset_btc",
"currency_symbol": "BTC",
"exchange_btc_reserve_total": "2850123.8",
"exchange_id": "exchange_aggregated",
"exchange_name": "ALL_EXCHANGE",
"exchange_reserve_snapshot_time": "2026-11-16T02:09:29.000+0000",
"reserve": {
"amount": "2850123.8",
"amount_usd": "186194330000"
},
"snapshot_time": "2026-11-16T02:09:29.000+0000"
}
],
"data_status": "verified",
"error": null,
"exchange_id": "exchange_aggregated",
"metadata": {
"data_status": "ok",
"entitlements": {
"endpoint": "onchain.exchange_reserves",
"evidence_fanout_level": "custom",
"field_level": "custom",
"object_resolution_level": "L3"
},
"limitations": [],
"object_refs": [],
"updated_at": "2026-11-16T06:12:37Z"
},
"observed_at": "2026-11-16T06:12:37Z",
"operation_id": "onchain.exchange_reserves",
"route_code": "direct"
}ownership_flows_queryFlows & WalletsUser asks for large on-chain transfers of a token, token transfers into or out of centralized-exchange wallets, exchange inflows/outflows, token holder distribution, wallet balances/PnL, a wallet's transaction history, company or government crypto treasury holdings, a crypto ETF overview and net-flow trend, or equity ownership data (institutional holders/summary, insider trades, short interest, short volume/flow, ETF fund holdings, stock-connect money flow).
Related REST (13)
GET /v1/flows/token-transfersGET /v1/onchain/holdersGET /v1/wallets/{address}GET /v1/wallets/transactionsGET /v1/treasuryGET /v1/crypto-etfGET /v1/crypto-institutional-metricsGET /v1/ownership/institutionalGET /v1/ownership/insidersGET /v1/ownership/short-interestGET /v1/ownership/short-flowGET /v1/funds/holdingsGET /v1/flows/moneyCall Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | institutional | AAPL | 200 | ok | — |
POST https://mcp.gatedata.ai/mcp/onchain
{
"tool": "ownership_flows_query",
"arguments": {
"task": "institutional",
"query": "AAPL",
"market": "us_equity",
"view": "holders",
"page_size": 2
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"request_id": "<string>",
"resolution_status": "<string>",
"data_status": "<string>",
"data": {
"history": {
"from": "<date>",
"period_count": "<number>",
"to": "<date>"
},
"items": [
{
"as_of_date": "<date>",
"change_base_date": "<date>",
"holder_name": "<string>",
"market_value": "<number>",
"market_value_unit": "<string>",
"shares_change": "<number>",
"shares_change_pct": "<number>",
"shares_held": "<number>"
}
],
"view": "<string>"
},
"metadata": {
"object_refs": [
{
"type": "<string>",
"id": "<string>"
}
],
"pagination": {
"page": "<number>",
"page_size": "<number>",
"total": "<number>"
},
"source_refs": [
{
"ref_id": "<string>"
}
],
"updated_at": "<date>"
},
"error": null
}/mcp/signalsSignals & newsevents_news_query · prediction_markets_query
events_news_queryEvents, News, Sentiment & SignalsUser asks for news headlines, events calendar feed, social posts, or social/news sentiment for equities or crypto; hot-topic question candidates for a ticker (task=topic_candidates; crypto or US/HK/KR/CN equities); macroeconomic release calendar (task=economic_calendar; from and to required); venue trading calendar (task=trading_calendar; venue_id, from, and to required); or commodity CFD related events / top drivers (task=search|driver). Commodity: pass commodity_id (or listing_id/event_id); omit query by default. To filter by driver tag use business_driver=seasonality|weather|cost|... (exact term filter). query is free-text on title/fact_summary/event_type only - never put driver enums in query.
Related REST (9)
GET /v1/news/searchGET /v1/eventsGET /v1/signals/ugc/searchGET /v1/signals/sentimentPOST /v1/signals/topic-candidatesGET /v1/signals/economic-calendarGET /v1/signals/trading-calendarGET /v1/events/searchGET /v1/events/searchCall Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | content_search | BTC | 200 | no_data | 322 ms |
| 2 | event_search | Bitcoin ETF | 200 | partial | 280 ms |
POST https://mcp.gatedata.ai/mcp/signals
{
"tool": "events_news_query",
"arguments": {
"task": "event_search",
"query": "Bitcoin ETF",
"market": "crypto",
"limit": 5,
"detail": true
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"data": {
"events": [
{
"asset_ids": [
"<string>",
"<string>"
],
"chain": [
"<string>",
"<string>"
],
"entity_ids": [],
"event_category": "<string>",
"event_id": "<string>",
"impact_direction": "<string>",
"importance_level": "<string>",
"industry": [],
"institution_codes": [],
"instrument_ids": [],
"listing_ids": [],
"macro_indicator_codes": [],
"market": "<string>",
"mentions": [
"<string>",
"<string>"
],
"sector": [
"<string>",
"<string>"
],
"summary": "<string>",
"title": "<string>"
}
]
},
"data_status": "<string>",
"empty_reason": null,
"error": null,
"external_refs": [],
"lineage_refs": [],
"metadata": {
"data_status": "<string>",
"entitlements": {
"endpoint": "<string>",
"evidence_fanout_level": "<string>",
"field_level": "<string>",
"object_resolution_level": "<string>"
},
"limitations": [],
"object_refs": [
{
"asset_id": "<string>",
"entity_id": "<string>",
"id": "<string>",
"resolution_confidence": "<string>",
"resolved_from": "<string>",
"type": "<string>"
}
],
"resolution_status": "<string>",
"resolved_market": "<string>",
"resolved_ticker": "<string>",
"updated_at": "<date>"
},
"source_refs": []
}prediction_markets_queryPredictionUser asks about prediction market events, rankings, signals, probabilities, or order books.
Call Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | rankings | —(榜单) | 200 | ready | 361 ms |
POST https://mcp.gatedata.ai/mcp/signals
{
"tool": "prediction_markets_query",
"arguments": {
"task": "rankings",
"ranking_type": "volume_24h",
"venue": "polymarket",
"limit": 5
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"metadata": {
"data_status": "<string>",
"limitations": [],
"object_refs": [
{
"event_ref": "<string>",
"id": "<string>",
"type": "<string>",
"venue": "<string>"
}
],
"pagination": {
"limit": "<number>",
"row_count": "<number>"
},
"updated_at": "<date>"
},
"rankings": [
{
"event_ref": "<string>",
"excluded_reasons": [],
"liquidity_usd": "<number>",
"rank_date_utc": "<date>",
"rank_no": "<number>",
"rank_type": "<string>",
"ranking_value": "<number>",
"title": "<string>",
"venue": "<string>",
"venue_event_id": "<string>",
"volume_24h_usd": "<number>"
}
]
}risk_compliance_queryRisk & ComplianceQuery covered open-interest observations, as-of snapshots and token security. Risk events are coming soon.
Call Examples
| Try | task | query / object | HTTP | data_status | Latency |
|---|---|---|---|---|---|
| 1 | observations | listing_gate_BTC_USDT_perp | 200 | ok | — |
POST https://mcp.gatedata.ai/mcp/signals
{
"tool": "risk_compliance_query",
"arguments": {
"task": "observations",
"object_refs": [
{
"type": "listing",
"id": "listing_gate_BTC_USDT_perp"
}
],
"metric_code": [
"open_interest"
],
"start": "2026-11-04T20:00:00Z",
"end": "2026-11-05T00:00:00Z",
"limit": 5
}
}This is a saved example response; values may change. For current results, Open in MCP Playground →
{
"request_id": "37afc3ba-a9a1-4326-8f97-40362f125c46",
"generated_at": "2026-11-16T06:12:35Z",
"data_status": "ok",
"empty_reason": null,
"data": {
"items": [
{
"metric_code": "open_interest",
"object_resolution_status": "matched",
"observation_end": "2026-11-05T00:00:00Z",
"observation_start": "2026-11-05T00:00:00Z",
"published_at": null,
"record_kind": "disclosed_fact",
"risk_observation_id": "e82152add444b8e0e94ea0474a5be886",
"risk_type": "market",
"source_locator": "close;interval=1h",
"source_record_id": "Gate|BTC_USDT|1h|1793836800000",
"source_task_id": "coinglass_oi_ohlc",
"source_url": null,
"target_ref_key": "listing_gate_BTC_USDT_perp",
"unit": "usd",
"value_bool": null,
"value_json": null,
"value_numeric": 4631449100,
"value_text": null
}
]
},
"metadata": {
"object_refs": [
{
"type": "listing",
"id": "listing_gate_BTC_USDT_perp",
"chain_id": null,
"contract_address": null,
"asset_entity_id": null,
"asset_id": null,
"listing_id": "listing_gate_BTC_USDT_perp",
"instrument_id": null,
"venue_id": null,
"symbol": null,
"quote_currency": null
}
],
"requested_as_of": "2026-11-16T06:12:35Z",
"resolved_as_of": "2026-11-05T00:00:00Z",
"next_cursor": null,
"has_more": false,
"unresolved_object_refs": []
},
"error": null
}Troubleshooting
Hitting an error during setup? Filter by client to find the cause and the fix.