GateData.AI

Tokenomics

查询代币经济与解锁数据。

GET/api/v1/fundamentals/tokenomics
数据域
公司基本面
解析层级
代币
MCP 工具
fundamentals_query (task=tokenomics)

可查询数据

返回数据
代币经济与解锁数据
市场覆盖
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
tokenomicsobject

日批嵌套对象（严格 5 组）：asset / supply / allocation_summary / unlock_summary / risk_summary。

assetobject
asset_idstring示例asset_btc

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

namestring | null示例Bitcoin

展示名称

symbolstring | null示例BTC

交易代码 / 代币符号

primary_chainstring | null示例bitcoin

主链（始终返回键。

contract_addressstring | null

合约地址（始终返回键。

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

待定锁仓量（TBD residual。

untracked_supplynumber | string | null示例0

未跟踪供应量（residual。

circulating_percentagenumber | null示例95.57373

流通量占比（%）

unlocked_percentagenumber | null示例95.5722

已解锁占比（%）

allocation_summaryobject
team_and_founders_percentagenumber | null示例0

团队与创始人分配占比（%）

investors_percentagenumber | null示例0

投资人分配占比（%）

community_and_ecosystem_percentagenumber | null示例100

社区与生态分配占比（%）

treasury_and_reserve_percentagenumber | null示例0

金库与储备分配占比（%）

others_percentagenumber | null示例0

其它分配占比（%）

unlock_summaryobject
next_unlock_datestring | null

下次解锁时间（RFC3339 / ISO8601）

next_unlock_amountnumber | string | null

下次解锁数量

next_unlock_percentage_of_circulatingnumber | null

下次解锁量占当前流通供应的百分比

next_unlock_categorystring | null

下次解锁类别（如 team_and_founders）

risk_summaryobject
supply_pressure_levelstring | null示例low

供应压力等级（low / medium / high 等）

supply_pressure_scorenumber | null示例4

供应压力分数

main_factorstring | null示例剩余锁仓占 Tokenomics 总供应量 4.426281%

压力主因说明（自然语言）

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示例tokenomics

实际路由任务：profile / statements / metrics / …

data_statusDataStatus示例ok

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:08Z

响应更新时间（UTC）

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例asset

对象引用类型

idstring示例asset_btc

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

asset_idstring示例asset_btc

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

data_statusDataStatus示例ok

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。