加密机构指标即将上线

查询 BTC、ETH 的 ETF、CME 和 CFTC 指标。

该接口即将上线。 文档可供预览,正式开放前REST与MCP暂不可调用。
GET/api/v1/crypto-institutional-metrics
数据域
持仓与资金流
解析层级
汇总
MCP 工具
ownership_flows_query

可查询数据

返回数据
查询 BTC、ETH 的 ETF、CME 和 CFTC 指标
每次返回什么
按接口参数查询对应数据。

认证

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

请求参数

assetstringquery示例all可选

资产代码或范围 · BTC / ETH / all

channelstringquery示例all可选

指标类别 · all / etf / cme / cftc

start_datedatequery可选

起始日期(YYYY-MM-DD)

end_datedatequery可选

结束日期(YYYY-MM-DD)

limitintegerquery示例2可选

最多返回条数 · 默认: 30 · ≥ 1, ≤ 366

响应

assetstring

资产代码或范围

channelstring

指标类别

countnumber

本次返回条数

data_statusDataStatus

数据状态

totalnumber

匹配记录总数

assets[]object[]

各资产的机构指标

assetstring

资产代码或范围

latestobject

最新一期指标

cftc_oi_weekly_underlying_amountnumber

CFTC 周度未平仓名义金额

cme_oiunknown | null

CME 未平仓量

cme_volumeunknown | null

CME 成交量

data_statusDataStatus

数据状态

etf_net_inflow_usdnumber

ETF 净流入(USD)

etf_total_assets_usdnumber

ETF 总资产(USD)

part_datedatetime

统计日期

错误与降级

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。