GateData.AI

搜索资产

搜索资产、实体及合约信息。

GET/api/v1/assets/search
数据域
资产与实体
解析层级
资产
MCP 工具
assets_resolve (task=search)

可查询数据

返回数据
资产、实体及合约信息
市场覆盖
Crypto、美股、港股
查询粒度
每次返回匹配结果；名称有多条命中时全部列出

认证

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

请求参数

搜索条件

query 必填。

querystringquery示例AAPL必填

查询关键词、代码或名称。

筛选与返回

均为可选。

marketMarketquery示例us_equity可选

标准市场代码。

limitintegerquery示例5可选

返回条数。

响应

data[]object[]

匹配结果：asset_id、display_symbol、listing_id、market、match_confidence 等

asset_idstring示例asset_aapl_common_stock

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

display_namestring示例Apple Inc.

展示名称

display_symbolstring示例AAPL

展示代码

entity_idstring示例entity_sec_cik_0000320193

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

instrument_idstring示例instrument_aapl_common_stock

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

listing_idstring示例listing_aapl_xnas

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

venue_idstring示例venue_xnas

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

marketMarket示例us_equity

标准市场

match_confidencenumber示例1

匹配置信度（0–1）

matched_fieldstring示例ticker

命中字段（如 ticker）

matched_valuestring示例AAPL

命中值

disambiguation_hintstring | null

近邻歧义提示。

data_statusDataStatus示例ok

ok / no_data / …

empty_reasonstring | null

空结果原因码

errorobject | null

错误对象。

lineage_refs[]object[]

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

metadataobject

响应状态与解析信息容器

actual_taskstring示例search

listings / profile / resolve / search / …

route_reasonstring示例explicit_task

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

domain_bindingsobject

提示：market_data / onchain / events_news / fundamentals / news 为 map（{ listing_id | entity_id | asset_id | deployment_id }）

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。