加密资产储备
查询公司和政府的加密资产储备总额与持仓实体明细。
GET/api/v1/treasury
可查询数据
查询层级: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该实体持仓的当前美元价值。
数据状态:ok 或 no_data。
empty_reasonstring | null无数据原因;有数据时为 null。
errorobject | null错误对象;成功时为 null。
lineage_refsobject[]数据血缘引用;公开响应通常为空数组。
资产解析状态,例如 resolved、ambiguous。
source_refsobject[]数据源引用;无公开引用时为空数组。
metadataobject
请求路由、领域绑定和对象引用。
actual_taskstring示例treasury实际任务,固定 treasury。
route_reasonstring示例explicit_task直接调用时为 explicit_task。
domain_bindingsobject数据领域绑定;无额外绑定时为空对象。
object_refs[]object[]
统一对象引用列表。
对象类型,例如 asset、entity。
idstring示例asset_btc对象标识,标识 type 指定的具体对象
错误与降级
200
无匹配资产或无储备数据,返回 data=[]、data_status=no_data。
400
缺少资产定位条件、参数无效或资产解析有歧义。
401
API Key 缺失或无效。
403
API Key 无访问权限。
429
请求频率超限。