GateData MCP 服务：让 AI 助手调用实时金融数据

Overview

GateData.ai 提供完整的 MCP Server，让 AI 助手能够直接接入实时行情、资产解析、基本面、财报预期、事件新闻与预测市场。覆盖 Crypto 与上市公司，统一于一套对象模型。

Getting Started

使用地址快速上手。地址前缀： https://mcp.gatedata.ai/mcp

Codex CLI

打开 codex 自然语言输入

帮我自动安装 GateData MCP: https://github.com/gate/gate-data-ai-agent

在 Team / Enterprise 套餐下，需由工作区管理员先在后台添加该 Connector。

需要 REST / OpenAPI 接入？查看完整 OpenAPI Spec

MCP Server 工具

存在两套 HTTP 面：(1) **Streamable HTTP** POST/GET /mcp — 标准 MCP JSON-RPC（initialize / tools/list / tools/call）。(2) **Tool 直调** POST /mcp/{endpoint}（如 /mcp/markets）— 仅接受 body { "tool", "arguments" }，**不是** JSON-RPC，也不支持 initialize。同一域级 tool 的名称与 schema 在各直调前缀上保持一致，没有按 endpoint 拆开的别名。

/mcp/assets

工具直调前缀：资产、主体、基本面、预期与持仓。Body：{ tool, arguments }。

assets_resolvefundamentals_queryestimates_earnings_queryownership_flows_query · 即将上线

/mcp/markets

工具直调前缀：market_data_query（快照、K 线、盘口）。非 MCP JSON-RPC；握手请用 POST /mcp。

market_data_query

/mcp/onchain

钱包、持有人、资金流、地址与合约风险。

ownership_flows_query · 即将上线risk_compliance_query · 即将上线暂未开放

/mcp/signals

新闻、事件、情绪与预测市场。

events_news_queryprediction_markets_queryrisk_compliance_query · 即将上线

/mcp/all

列出目录中全部域级 Tool（各 Tool 可用性不同）。

assets_resolvemarket_data_queryfundamentals_queryestimates_earnings_queryevents_news_queryprediction_markets_queryownership_flows_query · 即将上线risk_compliance_query · 即将上线

响应状态说明

除了 ok/ready/partial/not_ready，域级 Tool 还共用 no_data 与 ambiguous 形态。no_data 一律 HTTP 200（对象可解析但本域无行）。**歧义：** assets / fundamentals / earnings / prediction 名称多命中返回 HTTP **200** + resolution_status=ambiguous + candidates 或 data[]（让用户确认，不是传输层失败）。**行情 listing** 钉定点位不足仍返回 HTTP **400** ambiguous_object_resolution（含 candidates + required_params）。新闻/信号歧义候选只钉 **ticker + market**（勿编造 us_equity:TICKER 作为公开 id）。Crypto 的 fundamentals profile 返回 empty_reason=market_not_served 并引导 tokenomics/assets。flat 与 object_refs 身份冲突返回 param_conflict；已关闭的预测盘口返回 market_closed。

no_dataHTTP 200行情类 no_data — market_data_query flat 形态market_data_query · query="Meta", task="snapshot"

{
  "metadata": {  // 响应元数据（data_status、limitations、object_refs）
    "data_status": "<string>",  // 数据状态；no_data 表示资产已解析但无快照行
    "limitations": [  // 覆盖/能力限制标记（如 ["no_data"]）
      "<string>"
    ],
    "object_refs": [  // 统一对象模型解析信息（轻量 F0 引用）
      {
        "type": "<string>",  // 对象类型（asset / listing / …）
        "id": "<string>",  // 对象标识，标识 type 指定的具体对象
        "asset_id": "<string>",  // 资产标识，标识股票、加密资产等资产对象
        "resolved_from": "<string>",  // 解析来源（如 asset、query）
        "resolution_confidence": "<string>"  // 解析置信度（如 default）
      }
    ]
  },
  "next_action": "<string>",  // 下一步重试的可读指引
  "reason": "<string>",  // 本域无行数据的原因说明
  "request_id": "<string>",  // 请求追踪 ID（排障 / 日志）
  "try_params": {  // 本次尝试已解析的参数回显
    "asset_id": "<string>",  // 资产标识，标识股票、加密资产等资产对象
    "query": "<string>"  // 原始自然语言 / ticker 查询
  }
}

接入方：按空状态展示 reason / next_action，可回显 try_params；不显示系统错误、不补造价格字段。

no_dataHTTP 200资产/信号类 no_data — envelope 形态data_status=no_data · empty_reason=no_results

{
  "data": [],  // 域级业务载荷；无数据时为空数组 [] 或空对象 {}
  "data_status": "<string>",  // 数据状态；no_data 表示对象可解析但本域无行数据
  "empty_reason": "<string>",  // 空结果原因码（如 no_results）
  "error": null,  // 错误对象；HTTP 200 空数据/成功时为 null
  "lineage_refs": [],  // 快照血缘；未附带时为 []。source 为稳定角色（estimates / calendar / results / consensus），不含内部服务名
  "metadata": {  // 响应元数据（路由、限制说明、object_refs）
    "actual_task": "<string>",  // 路由后的 task。Market 体仅 MCP 返回（钉死 REST market 路径省略）。Estimates/Fundamentals 信封在 REST 捕获样例中也可能出现。
    "limitations": null,  // 能力/覆盖限制说明；无额外限制时可为 null
    "object_refs": [],  // 统一对象模型解析信息（轻量 F0 引用）
    "object_refs_validation_status": "<string>",  // 入参 object_refs 校验状态（如 not_provided）
    "route_reason": "<string>",  // 选择该 task/路由的原因
    "updated_at": "<date>"  // 元数据时间戳（ISO-8601）
  },
  "request_id": "<string>"  // 请求追踪 ID（排障 / 日志）
}

接入方：显示空状态与 empty_reason 对应文案；不显示系统错误、不补默认对象、不把空数组改成 null。

ambiguousHTTP 200资产名称歧义 — 从 data[] 候选确认resolution_status=ambiguous · data[] candidates

{
  "data": [  // 候选列表（数组），供用户 / Agent 选择
    {
      "asset_id": "<string>",  // 资产标识，标识股票、加密资产等资产对象
      "listing_id": "<string>",  // 交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录
      "entity_id": "<string>",
      "display_name": "<string>",  // 可读的公司 / 资产名称
      "display_symbol": "<string>",
      "market": "<string>",
      "match_confidence": "<number>",
      "matched_field": "<string>",
      "matched_value": "<string>",
      "disambiguation_hint": "<string>"  // 建议补充的消歧参数提示
    }
  ],
  "data_status": "<string>",  // 返回候选时为 ok
  "empty_reason": null,
  "error": null,  // 成功路径恒为 null
  "resolution_status": "<string>",  // ambiguous — 多资产命中，需让用户确认（不是 tool 失败）
  "lineage_refs": [],
  "source_refs": [],
  "metadata": {
    "actual_task": "<string>",
    "object_refs": [],  // ambiguous 时为空，禁止静默绑定主键
    "object_refs_validation_status": "<string>",
    "route_reason": "<string>"  // 服务端路由原因（如 ambiguous_candidates）
  },
  "request_id": "<string>"  // 请求追踪 ID（排障 / 日志）
}

接入方 / Agent：HTTP 200 成功体中 resolution_status=ambiguous（或 ambiguous: true）。向用户展示 data[] / candidates；用 ticker+market 或 listing_id / asset_id 重试。fundamentals、earnings、prediction 已解析场景同理。勿编造或复用遗留 us_equity:TICKER id。

ambiguousHTTP 400行情 listing 歧义 — 需补充 venue / market_typeerror=ambiguous_object_resolution · next_action=retry_with_listing_id

{
  "error": "<string>",  // 错误类型标识（ambiguous_object_resolution）
  "error_code": "<string>",  // 业务错误码（同名字符串；旧客户端可映射为 40001）
  "message": "<string>",  // 人类可读的错误摘要
  "required_params": [  // 消歧重试所需补充的参数名列表
    "<string>",
    "<string>"
  ],
  "candidates": [  // 命中的候选对象列表，从中选取 listing_id / venue / market_type
    {
      "listing_id": "<string>",  // 交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录
      "asset_id": "<string>",  // 资产标识，标识股票、加密资产等资产对象
      "venue": "<string>",  // 交易所 / 市场代码（如 gate、binance）
      "market_type": "<string>"  // 市场类型（如 spot、perp）
    }
  ],
  "next_action": "<string>",  // 建议的下一步动作（如 retry_with_listing_id）
  "request_id": "<string>"  // 请求追踪 ID（排障 / 日志）
}

接入方 / Agent：按可恢复错误处理。读取 candidates 与 required_params，用 listing_id 或 venue+market_type 重试；禁止静默选第一个候选。

调用模式

域级 tool 默认接收自然语言 query。日常传 task=auto，由服务端在本域内自动选 task；已明确用途时可直接传具体 task。只有跨域串联时，再带上上一 tool 返回的 metadata.object_refs[]。日常业务查询不必先调用 assets_resolve。

autotask=auto（默认）

服务端会在当前数据域内选择合适的 task（例如问最新价时走 snapshot）。context.market 只用于模糊名称排序，不会覆盖精确 ticker 或显式 listing。

{
  "tool": "market_data_query",
  "arguments": {
    "query": "AAPL 最新价",
    "task": "auto",
    "context": { "market": "us_equity" }
  }
}

task显式 task

已清楚要查什么时，直接传入支持的 task（如 snapshot / kline / content_search）。同一 tool 在各安装入口的名称与 schema 保持一致。

{
  "tool": "market_data_query",
  "arguments": {
    "query": "AAPL",
    "task": "snapshot",
    "context": { "market": "us_equity" }
  }
}

object_refs跨域复用 metadata.object_refs

每个 tool 只返回本域主数据与轻量 metadata.object_refs[]。需要另一数据域的证据时，把这些引用传给下一 tool。

market_data_query("MU 昨天为什么大涨") → 行情/异动事实 + metadata.object_refs[]
将同一批 object_refs 传给 events_news_query，task=content_search 或 event_search
Events 返回新闻 / 事件证据——不代替 Market Data 的价格事实

助手不一定总会自动跑第二步。若需要稳定的跨域归因，请用后续的复合 tool 或 workflow，不要把多域逻辑塞进单个域级 tool。

在 MCP Playground 试一试 — 登录控制台，用真实 Key 跑域级 tool。

Tool Catalog

连接任一 MCP Server 后，助手可调用生产 tools/list 暴露的 6 个 live Tool：assets_resolve、market_data_query、fundamentals_query、estimates_earnings_query、events_news_query、prediction_markets_query。多数域默认 task=auto；events_news_query 公开 task 仅为 content_search / event_search / social_search / sentiment。ownership_flows_query 与 risk_compliance_query 为 planned（not_ready），不能当作可用案例。

context.market 标准码：us_equity / hk_equity / kr_equity / uk_equity / jp_equity / crypto（禁止 ks_equity）。标准市场枚举与数据覆盖说明 →

/mcp/assets资产 & 基本面

assets_resolve · fundamentals_query · estimates_earnings_query

assets_resolve资产与实体

已上线

User asks to resolve, search, profile (assets object metadata only), listings, or deployments (ticker, contract address, Gate symbol, asset_id).

Tasksautoresolvesearchprofilelistingsdeploymentscoverage

示例问题把 “阿里巴巴” 解析成对应的港股 listingAAPL 的 primary listing 是哪个

对应 REST (7)

POST /v1/assets/resolvePOST /v1/assets/resolveGET /v1/assets/searchGET /v1/assets/{id}GET /v1/assets/{id}/listingsGET /v1/assets/{asset_id}/deploymentsPOST /v1/assets/resolve

调用示例

ready把 AAPL 解析为 Apple 的标准 Asset / Entity / Instrument / Listing / VenueHTTP 200 · 770 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	search	AAPL	200	ok	770 ms

选定请求（Bearer 已脱敏）

POST https://mcp.gatedata.ai/mcp/assets
{
  "tool": "assets_resolve",
  "arguments": {
    "query": "AAPL",
    "task": "search",
    "context": {
      "market": "us_equity"
    }
  }
}

服务端真实响应

{
  "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": []
}

结论：响应包含真实业务数据，可作为产品正常示例；价格、榜单等时变数据不得固化本次数字。

在 MCP Playground 打开 →

fundamentals_query公司基本面

已上线

User asks for company profiles, financial statements, segments, corporate actions, summaries, fundamentals metrics, signals, or crypto tokenomics. Equity profiling language belongs here (not assets_resolve).

Tasksautoprofilestatementsmetricssegmentscorporate_actionstokenomicssignalssummary

示例问题AAPL 的市盈率和市值是多少？对比 NVDA 和 AAPL 的基本面。

对应 REST (9)

GET /v1/fundamentals/queryGET /v1/fundamentals/profileGET /v1/fundamentals/statementsGET /v1/fundamentals/metricsGET /v1/fundamentals/business-segmentsGET /v1/fundamentals/corporate-actionsGET /v1/fundamentals/tokenomicsGET /v1/fundamentals/queryGET /v1/fundamentals/query

调用示例

partial查询 Apple 公司资料、财务报表与财务指标HTTP 200 · 420 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	profile	AAPL	200	partial	380 ms
2	statements	AAPL	200	ok	410 ms
3	summary	AAPL	200	partial	520 ms

选定请求（Bearer 已脱敏）

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

{
  "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": []
}

结论：每个基本面任务都必须遵循 data_status 与 empty_reason；前端不得补造缺失字段。

在 MCP Playground 打开 →

estimates_earnings_query财报与预期

已上线

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

Tasksautocalendarresultsconsensus

示例问题AAPL 下一次财报日是什么时候？NVDA 的一致预期 EPS 是多少？

对应 REST (3)

GET /v1/earnings/calendarGET /v1/earnings/resultsGET /v1/estimates/consensus

调用示例

ready查询 Apple 财报日历；不可用时验证已公布业绩与一致预期HTTP 200 · 210 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	calendar	AAPL	200	ok	210 ms
2	results	AAPL	200	ok	240 ms
3	consensus	AAPL	200	ok	180 ms

选定请求（Bearer 已脱敏）

POST https://mcp.gatedata.ai/mcp/assets
{
  "tool": "estimates_earnings_query",
  "arguments": {
    "query": "AAPL",
    "task": "calendar",
    "context": {
      "market": "us_equity"
    }
  }
}

服务端真实响应

limitations: source_refs_unavailable

{
  "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": []
}

结论：calendar / results / consensus 返回真实财报数据。须遵循 data_status 与 empty_reason，不得固化日期或 surprise 数字。

在 MCP Playground 打开 →

ownership_flows_query持仓与资金流

即将上线

Catalog operation wallets.ownership_flows_query

Tasksautoexchange_flowsinstitutionalinsidersshort_interestmoney_flowfund_holdingsshort_flow

示例问题这个 ETH 地址近 7 天的资金流向？USDT 的主要 holder 有哪些？

对应 REST (7)

GET /v1/flows/exchangeGET /v1/ownership/institutionalGET /v1/ownership/insidersGET /v1/ownership/short-interestGET /v1/flows/moneyGET /v1/funds/holdingsGET /v1/ownership/short-flow

调用示例 · 即将上线

该 Tool 返回 not_ready；下方示例不作为可用案例。

not_ready通过资产入口查询 Apple 机构持仓HTTP 200 · 159 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	institutional	AAPL	200	not_ready	159 ms
2	fund_holdings	AAPL	200	not_ready	159 ms

选定请求（Bearer 已脱敏）

POST https://mcp.gatedata.ai/mcp/assets
{
  "tool": "ownership_flows_query",
  "arguments": {
    "query": "AAPL",
    "task": "institutional",
    "context": {
      "market": "us_equity"
    }
  }
}

服务端真实响应

limitations: data_not_ready

{
  "metadata": {
    "data_status": "<string>",
    "limitations": [
      "<string>"
    ],
    "object_refs": []
  }
}

结论：institutional / fund_holdings 均 not_ready；不能作为“真实可用成功案例”。

/mcp/markets行情 & K线

market_data_query

market_data_query行情与流动性

已上线

User asks for price, kline, or order book (crypto or equity); TradFi AI / technical indicators (task=technical_indicators); or crypto-only trades, liquidity, CEX depth, or derivatives metrics.

Tasksautosnapshotklineanomalymovesummaryorderbooktradesliquiditydepthderivativescex_derivativesliquidation_heatmaptechnical_indicators

示例问题BTC 现在的价格和 24 小时成交量是多少？给我 ETH 过去一天的每小时 K 线。

对应 REST (11)

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/liquidation-heatmapGET /v1/markets/tradfi/ai-indicators

调用示例

ready查询 BTC 的多交易所实时行情快照HTTP 200 · 344 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	snapshot	BTC	200	ready	344 ms

选定请求（Bearer 已脱敏）

POST https://mcp.gatedata.ai/mcp/markets
{
  "tool": "market_data_query",
  "arguments": {
    "query": "BTC",
    "task": "snapshot",
    "context": {
      "market": "crypto"
    }
  }
}

服务端真实响应

{
  "data_status": "<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": []
  },
  "price": "<number>",
  "price_change_24h": "<number>",
  "price_change_24h_absolute": "<number>",
  "price_change_24h_percent": "<number>",
  "updated_at": "<date>",
  "venue_id": "<string>",
  "volume_24h": "<number>",
  "volume_24h_unit": "<string>"
}

结论：真实多交易所快照可用；页面必须实时调用或标注调用时间，不得把本次数字固化。

在 MCP Playground 打开 →

/mcp/onchain链上 & 钱包

planned：ownership_flows_query · risk_compliance_query

ownership_flows_query持仓与资金流

即将上线

Catalog operation wallets.ownership_flows_query

Tasksautoexchange_flowsinstitutionalinsidersshort_interestmoney_flowfund_holdingsshort_flow

示例问题这个 ETH 地址近 7 天的资金流向？USDT 的主要 holder 有哪些？

对应 REST (7)

GET /v1/flows/exchangeGET /v1/ownership/institutionalGET /v1/ownership/insidersGET /v1/ownership/short-interestGET /v1/flows/moneyGET /v1/funds/holdingsGET /v1/ownership/short-flow

调用示例 · 即将上线

该 Tool 返回 not_ready；下方示例不作为可用案例。

not_ready通过链上入口查询 BTC 持币者；不可用时验证公开钱包画像HTTP 200 · 155 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	token_holders	BTC	200	not_ready	155 ms
2	wallet	0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045	200	not_ready	160 ms

选定请求（Bearer 已脱敏）

POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "ownership_flows_query",
  "arguments": {
    "query": "BTC",
    "task": "token_holders",
    "context": {
      "market": "crypto"
    }
  }
}

服务端真实响应

limitations: data_not_ready

{
  "metadata": {
    "data_status": "<string>",
    "limitations": [
      "<string>"
    ],
    "object_refs": []
  }
}

结论：token_holders / wallet 均返回 not_ready，不能作为可用案例。

risk_compliance_query风险与合规

即将上线

Catalog operation risk.risk_compliance_query

Tasksautopolitical

示例问题帮我筛查这个代币合约的风险。最近有没有与 Coinbase 相关的 SEC 披露？

对应 REST (1)

GET /v1/disclosures/political

调用示例 · 即将上线

该 Tool 返回 not_ready；下方示例不作为可用案例。

not_ready通过链上入口检查公开 Ethereum 地址的合规风险HTTP 200 · 159 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	compliance	0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045	200	not_ready	159 ms
2	risk_signals	BTC	200	not_ready	150 ms

选定请求（Bearer 已脱敏）

POST https://mcp.gatedata.ai/mcp/onchain
{
  "tool": "risk_compliance_query",
  "arguments": {
    "query": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "task": "compliance",
    "context": {
      "market": "crypto",
      "chain": "ethereum"
    }
  }
}

服务端真实响应

limitations: data_not_ready

{
  "metadata": {
    "data_status": "<string>",
    "limitations": [
      "<string>"
    ],
    "object_refs": []
  }
}

结论：链上合规能力 not_ready；不能包装成成功案例。

/mcp/signals信号 & 舆情

events_news_query · prediction_markets_query

events_news_query事件、新闻、舆情与信号

已上线

User asks for news/content lists, canonical aggregated events, social/UGC posts, or asset sentiment for equities or crypto.

Taskscontent_searchevent_searchsocial_searchsentiment

示例问题SOL 今天为什么波动？给出证据。今天的 Crypto 市场发生了什么？

对应 REST (4)

GET /v1/news/searchGET /v1/eventsGET /v1/signals/ugc/searchGET /v1/signals/sentiment

调用示例

partial查询 BTC 相关新闻；聚合搜索受限时改用 event_search（detail=true）HTTP 200 · 280 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	content_search	BTC	200	no_data	322 ms
2	event_search	Bitcoin ETF	200	partial	280 ms

选定请求（Bearer 已脱敏）

POST https://mcp.gatedata.ai/mcp/signals
{
  "tool": "events_news_query",
  "arguments": {
    "task": "event_search",
    "query": "Bitcoin ETF",
    "market": "crypto",
    "limit": 5,
    "detail": true
  }
}

服务端真实响应

{
  "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": []
}

结论：真实 event_search 可能为 partial 并带 limitations；产品必须同屏展示 limitations 与 source_refs，不能伪装成完整成功。

在 MCP Playground 打开 →

prediction_markets_query预测市场

已上线

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

Tasksautosearchrankingsevent_signalorder_bookevent_detailmarketsummary

示例问题当前热度最高的预测市场事件有哪些？下一次美联储决议的赔率是多少？

对应 REST (8)

GET /v1/prediction/eventsGET /v1/prediction/eventsGET /v1/prediction/rankingsGET /v1/prediction/events/{event_id}/signalGET /v1/prediction/order-book/currentGET /v1/prediction/events/{event_id}GET /v1/prediction/markets/{market_id}GET /v1/prediction/events

调用示例

ready查询 Polymarket 过去 24 小时成交量榜单HTTP 200 · 361 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	rankings	—（榜单）	200	ready	361 ms

选定请求（Bearer 已脱敏）

POST https://mcp.gatedata.ai/mcp/signals
{
  "tool": "prediction_markets_query",
  "arguments": {
    "task": "rankings",
    "ranking_type": "volume_24h",
    "venue": "polymarket",
    "limit": 5
  }
}

服务端真实响应

{
  "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>"
    }
  ]
}

结论：榜单真实可用；页面须标注调用时间或采取实时刷新，不得把本次金额、标题固化。

在 MCP Playground 打开 →

risk_compliance_query风险与合规

即将上线

Catalog operation risk.risk_compliance_query

Tasksautopolitical

示例问题帮我筛查这个代币合约的风险。最近有没有与 Coinbase 相关的 SEC 披露？

对应 REST (1)

GET /v1/disclosures/political

调用示例 · 即将上线

该 Tool 返回 not_ready；下方示例不作为可用案例。

not_ready通过信号入口查询 Apple 披露文件；不可用时验证风险信号HTTP 200 · 143 ms

尝试	task	query / 对象	HTTP	data_status	耗时
1	disclosures	AAPL	200	not_ready	143 ms
2	risk_signals	BTC	200	not_ready	145 ms

选定请求（Bearer 已脱敏）

POST https://mcp.gatedata.ai/mcp/signals
{
  "tool": "risk_compliance_query",
  "arguments": {
    "query": "AAPL",
    "task": "disclosures",
    "context": {
      "market": "us_equity"
    }
  }
}

服务端真实响应

limitations: data_not_ready

{
  "metadata": {
    "data_status": "<string>",
    "limitations": [
      "<string>"
    ],
    "object_refs": []
  }
}

结论：disclosures / risk_signals 均返回 not_ready，不能作为可用案例。

Troubleshooting

配置过程中遇到报错？按客户端筛选，找到对应原因和处理办法。