Markets Open Interest History
查询 Crypto 未平仓量(OI)历史序列。
GET/api/v1/markets/open-interest-history
可查询数据
查询层级:asset-level。
- 输入需解析到唯一 asset(ticker / name)。
- 名称多命中 → HTTP 200 + resolution_status=ambiguous + data[] 候选(禁止静默绑定)。
- 解析优先级:对象 ID > ticker/名称;独立 ticker 须带 market 或 venue_id。
- context.market 仅模糊消歧,不覆盖精确 ticker 或 listing_id。
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
asset_idstringquery示例asset_btc必填资产标识,标识股票、加密资产等资产对象
limitintegerquery示例20可选返回条数,最大 1000。
响应
metadataobject
响应状态与解析信息容器
ready / ok / partial / no_data / not_ready(按接口形态)
limitations[]string[]示例data_not_ready已知数据限制数组
updated_atdatetime | string对象或响应最近更新时间
partialboolean响应是否仅含部分字段
resolution_reasonstring对象解析结果的原因码
object_refs[]object[]
统一对象引用数组
typeObjectRefType对象引用类型
idstring对象标识,标识 type 指定的具体对象
entity_idstring主体标识,标识公司、项目方或协议等主体
asset_idstring资产标识,标识股票、加密资产等资产对象
listing_idstring交易场所挂牌标识,标识某个交易品种在特定交易场所的挂牌记录
instrument_idstring交易工具标识,标识股票、现货交易对或合约等具体交易产品
venue_idstring交易场所标识,标识交易所或交易平台
event_refstring关联事件标识,标识与当前对象关联的事件
market_idstring预测市场标识,标识预测事件下的具体市场
venuestring对象关联的平台代码
resolved_fromstring对象解析所用输入来源
resolution_confidencestring对象解析置信度
dataobject | arrayassets / signals 类 envelope 才有
错误与降级
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。