加密资产储备

查询公司和政府的加密资产储备总额与持仓实体明细。

GET/api/v1/treasury
数据域
持仓与资金流
解析层级
asset-level
MCP 工具
ownership_flows_query (task=treasuries)

可查询数据

查询层级:asset-level。

  • 至少提供 asset_id、symbol、ticker、base、query 中一项;多个条件取交集。

    认证

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

    请求参数

    资产定位与筛选

    至少提供 asset_id、symbol、ticker、base、query 中一项;多个条件取交集。

    asset_idstringquery示例asset_btc条件必须

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

    symbolstringquery示例BTC条件必须

    资产符号,精确匹配且不区分大小写。

    tickerstringquery示例BTC条件必须

    加密资产代码,不是 ETF 代码。

    basestringquery示例BTC条件必须

    标准 Base 资产标识,精确匹配且不区分大小写。

    querystringquery示例BTC条件必须

    资产名称、符号或别名。

    响应

    data[]object[]

    资产储备列表;未匹配时为空数组。

    asset_idstring示例asset_btc

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

    symbolstring示例BTC

    资产符号。

    asset_namestring示例Bitcoin

    资产名称。

    total_holdingsnumber示例1924573

    所有公司和政府实体持有的资产总数量。

    total_value_usdnumber示例160510000000

    公司和政府实体持仓的当前美元总价值。

    holders[]object[]

    持仓实体,按当前美元价值降序排列。

    namestring示例Strategy

    公司或政府实体名称。

    entity_typestring示例company

    实体类型:company 或 government。

    symbolstring | null示例MSTR.US

    上市公司股票代码;政府实体为空。

    countrystring | null示例US

    国家或地区代码,可为空。

    total_holdingsnumber示例848250

    该实体持有的资产数量。

    total_current_value_usdnumber示例70552429000

    该实体持仓的当前美元价值。

    data_statusDataStatus示例ok

    数据状态:ok 或 no_data。

    empty_reasonstring | null

    无数据原因;有数据时为 null。

    errorobject | null

    错误对象;成功时为 null。

    lineage_refsobject[]

    数据血缘引用;公开响应通常为空数组。

    resolution_statusResolutionStatus示例resolved

    资产解析状态,例如 resolved、ambiguous。

    source_refsobject[]

    数据源引用;无公开引用时为空数组。

    metadataobject

    请求路由、领域绑定和对象引用。

    actual_taskstring示例treasury

    实际任务,固定 treasury。

    route_reasonstring示例explicit_task

    直接调用时为 explicit_task。

    domain_bindingsobject

    数据领域绑定;无额外绑定时为空对象。

    object_refs[]object[]

    统一对象引用列表。

    typeObjectRefType示例asset

    对象类型,例如 asset、entity。

    idstring示例asset_btc

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

    错误与降级

    200
    无匹配资产或无储备数据,返回 data=[]、data_status=no_data。
    400
    缺少资产定位条件、参数无效或资产解析有歧义。
    401
    API Key 缺失或无效。
    403
    API Key 无访问权限。
    429
    请求频率超限。