Token 供给
查询代币供应数据。
GET/api/v1/fundamentals/supply
可查询数据
- 返回数据
- 代币供应数据
- 市场覆盖
- Crypto
- 查询粒度
- 每次查询一个代币，只返回供给，不含分配与解锁明细
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
资产定位
建议填写 query、asset_id 或 symbol；留空时接口可能返回 no_data。
querystringquery示例BTC可选查询关键词、代码或名称。
asset_idstringquery示例asset_btc可选资产标识，标识股票、加密资产等资产对象
symbolstringquery示例BTC可选资产代码。
解析选项
均为可选。
chain_idstringquery示例ethereum可选用于同名资产消歧。
响应
dataobject
supplyobject
供给子集：仅 asset + supply（无 allocation/unlock/risk，无外层 extras）
assetobject
asset_idstring示例asset_btc资产标识，标识股票、加密资产等资产对象
namestring | null示例Bitcoin展示名称
symbolstring | null示例BTC代币符号
primary_chainstring | null示例bitcoin主链
contract_addressstring | null合约地址（规则同 tokenomics）
supplyobject
max_supplynumber | string | null示例21000000最大供应量。
total_supplynumber | string | null示例21000000总供应量。
circulating_supplynumber | string | null示例20070484流通供应量
unlocked_supplynumber | string | null示例20070162已解锁供应量
locked_supplynumber | string | null示例929518.94锁仓供应量
tbd_locked_amountnumber | string | null示例0待定锁仓量（始终返回键）
untracked_supplynumber | string | null示例0未跟踪供应量（始终返回键）
circulating_percentagenumber | null示例95.57373流通量占比（%）
unlocked_percentagenumber | null示例95.5722已解锁占比（%）
metadataobject
as_ofstring示例2026-08-16批处理快照日（YYYY-MM-DD）
snapshot_kindstring示例batch_daily固定 batch_daily
schema_versionstring示例1.0响应嵌套 schema 版本
currencystring示例USD货币。
generated_atstring | null示例2026-08-15T17:05:00.000+0000快照生成时间（若有）
actual_taskstring示例supply实际路由任务：profile / statements / metrics / …
ok / partial / no_data / not_ready / stale
limitations[]string[]示例serving_mvp覆盖 / MVP 限制标记
route_reasonstring示例explicit_task路由原因（如 explicit_task）
updated_atdatetime | string示例2026-08-17T08:25:11Z响应更新时间（UTC）
object_refs[]object[]
统一对象引用数组
对象引用类型
idstring示例asset_btc对象标识，标识 type 指定的具体对象
asset_idstring示例asset_btc资产标识，标识股票、加密资产等资产对象
ok / partial / no_data / not_ready / stale
empty_reasonstring | null空结果或部分缺失原因码
errorobject | null错误对象（code / message）。
external_refs[]object[]外部引用（如 SEC EDGAR filings）
lineage_refs[]object[]血缘引用（公开体通常为空数组）
source_refs[]object[]数据来源引用（公开体通常为空数组）
错误与降级
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。