GateData.AI

挂牌与 Gate 映射

查看挂牌信息及 Gate 映射。

GET/api/v1/assets/{asset_id}/listings
数据域
资产与实体
解析层级
挂牌
MCP 工具
assets_resolve (task=listings)

可查询数据

返回数据
挂牌信息及 Gate 映射
市场覆盖
Crypto、美股、港股
查询粒度
每次查询一个资产，只返回该资产的挂牌

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

资产定位

必填。

asset_idstringpath示例asset_btc必填

资产标识，标识股票、加密资产等资产对象

挂牌筛选

均为可选。

venue_idstringquery示例venue_gate可选

交易场所标识，标识交易所或交易平台

market_typeMarketTypequery示例spot可选

市场类型。

quote_currencystringquery示例USDT可选

按计价资产过滤。

limitintegerquery示例20可选

返回条数。

响应

dataobject
asset_idstring示例asset_aapl_common_stock

资产标识，标识股票、加密资产等资产对象

underlying_listings[]object[]

原市场 listing（listing_id、ticker、venue_id 等）

listing_idstring示例listing_aapl_xnas

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

instrument_idstring示例instrument_aapl_common_stock

交易工具标识，标识股票、现货交易对或合约等具体交易产品

venue_idstring示例venue_xnas

交易场所标识，标识交易所或交易平台

tickerstring示例AAPL

交易所 ticker

quote_currencystring示例USD

计价货币

listing_statusstring示例unknown

挂牌状态

gate_listings[]object[]

Gate 可交易标的

gate_symbolstring示例AAPL

Gate 可交易代码

gate_quote_currencystring示例USDT

Gate 计价 / 结算货币

gate_listing_idstring | null

Gate listing_id（有则返回）

gate_trading_statusstring | null

Gate 交易状态（有则返回）

gate_mappings[]object[]

Gate ↔ 底层 listing 映射状态

underlying_listing_idstring示例listing_aapl_xnas

底层 listing_id

gate_mapping_statusGateMappingStatus示例mapped

映射状态（如 mapped）

gate_listing_idstring | null

Gate listing_id（有则返回）

mapping_confidencenumber | null

映射置信度（有则返回）

data_statusDataStatus示例ok

ok / no_data / …

empty_reasonstring | null

空结果原因码

errorobject | null

错误对象。

lineage_refs[]object[]

血缘引用（公开体通常为空数组）

metadataobject

响应状态与解析信息容器

actual_taskstring示例listings

listings / profile / resolve / search / …

object_refs_validation_statusstring示例not_provided

客户端未传 object_refs 时为 not_provided

route_reasonstring示例explicit_task

解析路由（如 gate_tradable_mapping、rest_profile、explicit_task）

domain_bindingsobject

提示：market_data / onchain / events_news / fundamentals / news

newsobject

新闻绑定：有映射时为 { asset_id }

asset_idstring示例asset_aapl_common_stock

资产标识，标识股票、加密资产等资产对象

events_newsobject

事件/新闻绑定（有映射时）

entity_idstring示例entity_sec_cik_0000320193

主体标识，标识公司、项目方或协议等主体

fundamentalsobject

基本面绑定（有映射时）

entity_idstring示例entity_sec_cik_0000320193

主体标识，标识公司、项目方或协议等主体

market_dataobject

行情绑定（有映射时）

listing_idstring示例listing_aapl_xnas

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例listing

对象引用类型

idstring示例listing_aapl_xnas

对象标识，标识 type 指定的具体对象

resolution_statusResolutionStatus示例resolved

resolved / ambiguous / …（HTTP 200，不是传输失败）

source_refs[]object[]

数据来源引用

错误与降级

200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。