获取工具即将上线
获取交易工具详情与标识。
GET/api/v1/instruments/{instrument_id}
可查询数据
- 返回数据
- 交易工具详情与标识
- 市场覆盖
- Crypto、美股、港股
- 查询粒度
- 每次查询一个交易品种，同一资产下的其他合约需另行查询
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
工具定位
必填。
instrument_idstringpath示例instrument_aapl_common_stock必填交易工具标识，标识股票、现货交易对或合约等具体交易产品
响应
metadataobject
响应状态与解析信息容器
ready / ok / partial / no_data / not_ready（按接口形态）
limitations[]string[]示例data_not_ready已知数据限制数组
object_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。