获取资产
获取单个资产的完整资料。
GET/api/v1/assets/{asset_id}
可查询数据
- 返回数据
- 单个资产的完整资料
- 市场覆盖
- Crypto、美股、港股
- 查询粒度
- 每次查询一个资产
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
资产定位
必填。
asset_idstringpath示例asset_btc必填资产标识，标识股票、加密资产等资产对象
响应
dataobject
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交易工具标识，标识股票、现货交易对或合约等具体交易产品
primary_listing_idstring示例listing_aapl_xnas主要交易场所挂牌标识
industrystring示例Telecommunications Equipment行业与板块（已分类时返回）
sectorstring示例Electronic Technology行业与板块（已分类时返回）
asset_typestring示例equity分类与资料字段（有则返回）
countrystring示例United States分类与资料字段（有则返回）
legal_namestring示例Apple Inc.分类与资料字段（有则返回）
websitestring示例https://www.apple.com分类与资料字段（有则返回）
primary_venue_idstring示例venue_xnas主市场 venue_id（有则返回）
gate_mappings_summary[]object[]
Gate 符号映射摘要
gate_symbolstring示例AAPLGate 可交易代码
标准市场
underlying_listing_idstring示例listing_aapl_xnas底层 listing_id
映射状态
ok / no_data / …
empty_reasonstring | null空结果原因码
errorobject | null错误对象。
lineage_refs[]object[]血缘引用（公开体通常为空数组）
metadataobject
响应状态与解析信息容器
actual_taskstring示例profilelistings / profile / resolve / search / …
route_reasonstring示例rest_profile解析路由（如 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[]
统一对象引用数组
对象引用类型
idstring示例listing_aapl_xnas对象标识，标识 type 指定的具体对象
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。