Integrations

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 spec

MCP 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.

/mcp/assets

Tool-invoke prefix for assets, entities, fundamentals, estimates and equity ownership. Body: { tool, arguments }.

assets_resolvefundamentals_queryestimates_earnings_query
/mcp/markets

Tool-invoke prefix for market_data_query (snapshots, klines, top_of_book). Not MCP JSON-RPC — use POST /mcp for initialize/tools/list.

market_data_query
/mcp/onchain

Network & Protocol: six dedicated tools plus onchain_query. Risk uses /mcp/signals or /mcp/all.

ownership_flows_querydefi_overviewdefi_protocolonchain_queryyield_poolsstablecoin_supplybridge_flowsexchange_reserves
/mcp/signals

News, events, sentiment, prediction markets and Risk.

events_news_queryprediction_markets_queryrisk_compliance_query
/mcp/all

Lists all catalogued domain tools (availability varies by tool).

assets_resolvemarket_data_queryfundamentals_queryestimates_earnings_queryownership_flows_querydefi_overviewdefi_protocolonchain_queryyield_poolsstablecoin_supplybridge_flowsexchange_reservesevents_news_queryprediction_markets_queryrisk_compliance_query

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.

no_dataHTTP 200Markets no_data — market_data_query flat shapemarket_data_query · query="Meta", task="snapshot"
{
  "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
  }
}
Client rule: render an empty state from reason / next_action, optionally echo try_params. Never show a system error or invent price fields.
no_dataHTTP 200Assets / signals no_data — envelope shapedata_status=no_data · empty_reason=no_results
{
  "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
}
Client rule: render the empty state and the empty_reason copy. Never render an error, insert a default object, or coerce the empty array to null.
ambiguousHTTP 200Assets name ambiguous — confirm from data[] candidatesresolution_status=ambiguous · data[] candidates
{
  "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
}
Client / agent rule: HTTP 200 success with 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.
ambiguousHTTP 400Market listing ambiguous — add venue / market_typeerror=ambiguous_object_resolution · next_action=retry_with_listing_id
{
  "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
}
Client / agent rule: treat as recoverable. Read 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.

autotask=auto (default)

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" }
  }
}
taskExplicit task

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" }
  }
}
object_refsReuse metadata.object_refs across domains

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.

  1. market_data_query("MU why did it jump yesterday?") → market anomaly facts + metadata.object_refs[]
  2. Pass the same object_refs into events_news_query with task=content_search or event_search
  3. 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.

Try it in MCP Playground — sign in to the console and run domain tools with a real key.

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 & fundamentals

assets_resolve · fundamentals_query · estimates_earnings_query

assets_resolveAsset & Entity
Live

User 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.

Tasksautoresolvesearchprofilelistingsinstrumentsdeploymentscoverage
Example questionsResolve “Alibaba” to the corresponding Hong Kong listing.What is AAPL’s primary listing?
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/resolve
Call Examples
readyResolve AAPL to Apple across the canonical Asset / Entity / Instrument / Listing / Venue objectsHTTP 200 · 770 ms
Trytaskquery / objectHTTPdata_statusLatency
1searchAAPL200ok770 ms
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/assets
{
  "tool": "assets_resolve",
  "arguments": {
    "query": "AAPL",
    "task": "search",
    "context": {
      "market": "us_equity"
    }
  }
}
Real server response

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": []
}
Conclusion:Response carries real business data — safe as a normal example. Time-variant fields must not be hardcoded.
fundamentals_queryFundamentals
Live

User 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).

Tasksautoprofilecompany_profilestatementsfinancial_statementsmetricsfinancial_metricssegmentscorporate_actionstokenomicssupplyseriessentimentpositioningsupply_demandinventorymacromacro_indicatormacro_summaryweatherlogisticssignalssummary
Call Examples
partialQuery the Apple company profile, statements, and financial metricsHTTP 200 · 420 ms
Trytaskquery / objectHTTPdata_statusLatency
1profileAAPL200partial380 ms
2statementsAAPL200ok410 ms
3summaryAAPL200partial520 ms
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/assets
{
  "tool": "fundamentals_query",
  "arguments": {
    "query": "AAPL",
    "task": "summary",
    "ticker": "AAPL",
    "context": {
      "market": "us_equity"
    }
  }
}
Real server response

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": []
}
Conclusion:Honor data_status and empty_reason for each fundamentals task; do not fabricate missing fields on the client.
estimates_earnings_queryEstimates & Earnings
Live

User asks for earnings dates, reported results/surprises, or analyst consensus estimates.

Tasksautocalendarresultsconsensus
Example questionsWhen is the next AAPL earnings date?What is the consensus EPS estimate for NVDA?
Related REST (3)
Call Examples
readyApple earnings calendar; fall back to reported results and consensusHTTP 200 · 210 ms
Trytaskquery / objectHTTPdata_statusLatency
1calendarAAPL200ok210 ms
2resultsAAPL200ok240 ms
3consensusAAPL200ok180 ms
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/assets
{
  "tool": "estimates_earnings_query",
  "arguments": {
    "query": "AAPL",
    "task": "calendar",
    "context": {
      "market": "us_equity"
    }
  }
}
Real server response

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": []
}
Conclusion:calendar / results / consensus return live earnings data. Honor data_status and empty_reason; do not hardcode dates or surprise figures.
/mcp/marketsMarkets & kline

market_data_query

market_data_queryMarket & Liquidity
Live

User 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.

Tasksautosnapshotklineanomalymovesummaryorderbooktradesliquiditydepthderivativescex_derivativesdex_derivativesliquidation_heatmapliquidationsliquidation_aggregatesderivatives_volume_historyopen_interest_historymarket_overviewcrypto_global_marketcapquote_headerfear_greed_historyrankingsoptions_chaindex_overviewdex_tradesdex_liquidity_eventstechnical_indicatorsrsi_heatmaptrend_klinetechnical_analysis
Call Examples
readyMulti-venue live snapshot for BTCHTTP 200 · 344 ms
Trytaskquery / objectHTTPdata_statusLatency
1snapshotBTC200ready344 ms
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/markets
{
  "tool": "market_data_query",
  "arguments": {
    "query": "BTC",
    "task": "snapshot",
    "context": {
      "market": "crypto"
    }
  }
}
Real server response

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>"
}
Conclusion:Real multi-venue snapshot is live. Pages MUST call in real time or stamp the timestamp — never hardcode the number.
/mcp/onchainOn-chain & wallets

defi_overview · defi_protocol · onchain_query · yield_pools · stablecoin_supply · bridge_flows · exchange_reserves

defi_overviewNetwork & Protocol
Live

Query DeFi TVL, USD-pegged stablecoin supply, DEX volumes, categories and top chains.

Tasksrange=latestrange=window
Example questionsShow DeFi TVL, stablecoin supply and top chains.Show DeFi overview history from November 1 to 8, 2026.
Related REST (2)
Call Examples
readyHTTP 200
Trytaskquery / objectHTTPdata_statusLatency
1latest—200verified—
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "defi_overview",
  "arguments": {
    "top_chains": 2,
    "range": "latest"
  }
}
Example response

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"
}
Conclusion:Real data returned
defi_protocolNetwork & Protocol
Live

Query a protocol profile, latest TVL and per-chain TVL.

Tasksrange=latestrange=window
Example questionsShow the Lido profile and per-chain TVL.Show Lido TVL history from October 1 to 15, 2026.
Related REST (2)
Call Examples
readyHTTP 200
Trytaskquery / objectHTTPdata_statusLatency
1latestprotocol_lido200verified—
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "defi_protocol",
  "arguments": {
    "protocol_id": "protocol_lido",
    "range": "latest"
  }
}
Example response

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"
}
Conclusion:Real data returned
onchain_queryNetwork & Protocol
Live

Query daily active addresses and transaction counts for a chain.

Tasksautodefi_overviewstablecoinsbridgesyield_poolsprotocol_profileprotocolprotocol_historychain_activityexchange_reservesprofilerankingsoverview
Call Examples
readyHTTP 200
Trytaskquery / objectHTTPdata_statusLatency
1chain_activitychain_ethereum200verified—
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "onchain_query",
  "arguments": {
    "chain_id": "chain_ethereum",
    "range": "latest",
    "task": "chain_activity"
  }
}
Example response

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"
}
Conclusion:Real data returned
yield_poolsNetwork & Protocol
Live

Query DeFi pool TVL, annual percentage yields and pool attributes.

Example questionsShow TVL and APY for Lido yield pools.
Related REST (1)
Call Examples
readyHTTP 200
Trytaskquery / objectHTTPdata_statusLatency
1—protocol_lido200verified—
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "yield_pools",
  "arguments": {
    "protocol_id": "protocol_lido"
  }
}
Example response

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"
}
Conclusion:Real data returned
stablecoin_supplyNetwork & Protocol
Live

Query circulating stablecoin supply and its per-chain distribution.

Example questionsShow USDT circulating supply and its chain distribution.
Related REST (1)
Call Examples
readyHTTP 200
Trytaskquery / objectHTTPdata_statusLatency
1—asset_token_tether200verified—
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "stablecoin_supply",
  "arguments": {
    "asset_id": "asset_token_tether"
  }
}
Example response

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"
}
Conclusion:Real data returned
bridge_flowsNetwork & Protocol
Live

Query bridge-volume rankings, covered chains and snapshot times.

Example questionsShow cross-chain bridge volume rankings.
Related REST (1)
Call Examples
partialHTTP 200
Trytaskquery / objectHTTPdata_statusLatency
1——200partial—
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "bridge_flows",
  "arguments": {
    "scope": "bridge_rankings",
    "limit": 2
  }
}
Example response

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"
}
Conclusion:Real data, but partial
exchange_reservesNetwork & Protocol
Live

Query the all-exchange BTC reserve total or reserves for one exchange and asset.

Example questionsShow aggregate exchange BTC reserves and their snapshot time.
Related REST (1)
Call Examples
readyHTTP 200
Trytaskquery / objectHTTPdata_statusLatency
1—asset_btc200verified—
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "exchange_reserves",
  "arguments": {
    "exchange_id": "exchange_aggregated",
    "asset_id": "asset_btc"
  }
}
Example response

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"
}
Conclusion:Real data returned
ownership_flows_queryFlows & Wallets
Live

User 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).

Tasksautoexchange_flowsholderswallet_profilewallet_transactionstreasuriescrypto_etfinstitutional_metricsinstitutionalinsidersshort_interestshort_flowfund_holdingsmoney_flow
Call Examples
readyQuery institutional holders of AAPLHTTP 200
Trytaskquery / objectHTTPdata_statusLatency
1institutionalAAPL200ok—
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "ownership_flows_query",
  "arguments": {
    "task": "institutional",
    "query": "AAPL",
    "market": "us_equity",
    "view": "holders",
    "page_size": 2
  }
}
Real server response

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
}
Conclusion:Verified task=institutional on /mcp/onchain; response data is available. Coverage varies by market and object.
/mcp/signalsSignals & news

events_news_query · prediction_markets_query

events_news_queryEvents, News, Sentiment & Signals
Live

User 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.

Taskscontent_searchevent_searchsocial_searchsentimenttopic_candidateseconomic_calendartrading_calendarsearchdriver
Example questionsWhy did SOL move today? Give evidence.What’s happening in crypto markets today?
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/search
Call Examples
partialBTC news; on aggregate limits, fall back to event_search with detail=trueHTTP 200 · 280 ms
Trytaskquery / objectHTTPdata_statusLatency
1content_searchBTC200no_data322 ms
2event_searchBitcoin ETF200partial280 ms
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/signals
{
  "tool": "events_news_query",
  "arguments": {
    "task": "event_search",
    "query": "Bitcoin ETF",
    "market": "crypto",
    "limit": 5,
    "detail": true
  }
}
Real server response

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": []
}
Conclusion:Real event_search may be partial with limitations — the UI MUST render limitations and source_refs alongside, not as a full success.
prediction_markets_queryPrediction
Live

User asks about prediction market events, rankings, signals, probabilities, or order books.

Tasksautosearchrankingsevent_signalorder_bookevent_detailmarketsummary
Call Examples
readyPolymarket 24h volume rankingsHTTP 200 · 361 ms
Trytaskquery / objectHTTPdata_statusLatency
1rankings—(榜单)200ready361 ms
Selected request (Bearer redacted)
POST https://mcp.gatedata.ai/mcp/signals
{
  "tool": "prediction_markets_query",
  "arguments": {
    "task": "rankings",
    "ranking_type": "volume_24h",
    "venue": "polymarket",
    "limit": 5
  }
}
Real server response

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>"
    }
  ]
}
Conclusion:Rankings are real; stamp the call time or refresh live — never hardcode amounts or titles.
risk_compliance_queryRisk & Compliance
Live

Query covered open-interest observations, as-of snapshots and token security. Risk events are coming soon.

Tasksobservationssnapshottoken_securityevents · Coming soon
Example questionsShow historical open interest for Gate BTC/USDT perpetual.Check the Ethereum USDC token contract.
Related REST (4)
Call Examples
readyQuery historical open interest for Gate BTC/USDT perpetual and token contract security.HTTP 200
Trytaskquery / objectHTTPdata_statusLatency
1observationslisting_gate_BTC_USDT_perp200ok—
Selected request (Bearer redacted)
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
  }
}
Example response

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
}
Conclusion:History and token checks are verified; risk events are coming soon. Use /mcp/signals or /mcp/all for Risk.

Troubleshooting

Hitting an error during setup? Filter by client to find the cause and the fix.