链活动指标
查询质押和二层网络的历史指标。
GET/api/v1/onchain/chain-metrics
可查询数据
- 返回数据
- 查询质押和二层网络的历史指标
- 每次返回什么
- 支持以太坊质押、L2 和 BTC L2 日度指标。
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
查询示例
指标类型
质押、L2与BTC L2的指标及响应分支不同;选择查询示例可查看对应请求与响应
metric_groupstringquery示例staking必填指标组 · staking / l2 / btc_l2
链与项目
project仅用于BTC L2;其他分支使用chain或chain_id定位链
chainstringquery示例ethereum可选所属链
兼容定位字段
chain_idstringquery可选链标识
projectstringquery可选仅当 metric_group=btc_l2 时生效。可填 stacks、rootstock、merlin、bob 或 bitlayer;填写其他值会返回 not_in_scope
查询时间
按接口要求填写时间格式和边界;缺少日期不等于指标为0
start_datedatequery示例2026-10-19可选起始日期(YYYY-MM-DD)
end_datedatequery示例2026-10-21可选结束日期(YYYY-MM-DD)
lookbackstringquery可选回溯范围,如 30d
返回选项
granularitystringquery可选时间粒度 · day · 默认: day
limitintegerquery可选最多返回条数 · ≥ 0, ≤ 1000
响应
dataobject
业务数据
chainstring所属链
countnumber本次返回条数
data_statusDataStatus数据状态
duration_msnumberduration_ms
end_datedatetime结束日期(YYYY-MM-DD)
lookbackstring回溯范围,如 30d
metric_groupstring指标组
normalized_chainstringnormalized_chain
staking_metricsobject
质押指标序列
series[]object[]
指标时间序列
data_statusDataStatus数据状态
datedatetime统计日期
entry_queue_ethnumber排队进入质押的 ETH 数量
entry_queue_validator_estimatenumber等待进入的验证者估计数
entry_wait_daysnumber进入队列等待天数
eth_supplynumberETH 供应量
exit_queue_ethnumber排队退出质押的 ETH 数量
exit_queue_validator_estimatenumber等待退出的验证者估计数
exit_wait_daysnumber退出队列等待天数
staking_apr_7dnumber近 7 天质押年化收益率
staking_ratenumber质押比例
total_value_staked_ethnumber质押 ETH 总量
validator_activenumber活跃验证者数量
start_datedatetime起始日期(YYYY-MM-DD)
totalnumber匹配记录总数
data_statusDataStatus数据状态
empty_reasonunknown | null空结果原因
errorunknown | null结构化错误,无错误时为null
external_refs[]unknown[]external_refs
lineage_refs[]unknown[]lineage_refs
metadataobject
响应元数据
actual_taskstringactual_task
data_statusDataStatus数据状态
limitations[]unknown[]补充说明
object_refs[]unknown[]object_refs
updated_atdatetime数据更新时间
request_idstring请求标识
source_refs[]unknown[]source_refs
错误与降级
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。