Markets Open Interest History

查询 Crypto 未平仓量(OI)历史序列。

GET/api/v1/markets/open-interest-history
数据域
行情与流动性
解析层级
asset-level
MCP 工具
market_data_query (task=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

响应状态与解析信息容器

data_statusDataStatus示例not_ready

ready / ok / partial / no_data / not_ready(按接口形态)

limitations[]string[]示例data_not_ready

已知数据限制数组

updated_atdatetime | string

对象或响应最近更新时间

partialboolean

响应是否仅含部分字段

resolution_reasonstring

对象解析结果的原因码

object_refs[]object[]

统一对象引用数组

对象引用类型

idstring

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

entity_idstring

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

asset_idstring

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

listing_idstring

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

instrument_idstring

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

venue_idstring

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

event_refstring

关联事件标识,标识与当前对象关联的事件

market_idstring

预测市场标识,标识预测事件下的具体市场

venuestring

对象关联的平台代码

resolved_fromstring

对象解析所用输入来源

resolution_confidencestring

对象解析置信度

dataobject | array

assets / 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。