链活动指标

查询质押和二层网络的历史指标。

GET/api/v1/onchain/chain-metrics
数据域
网络与协议
解析层级
汇总
MCP 工具
onchain_query (task=chain_activity)

可查询数据

返回数据
查询质押和二层网络的历史指标
每次返回什么
支持以太坊质押、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_msnumber

duration_ms

end_datedatetime

结束日期(YYYY-MM-DD)

lookbackstring

回溯范围,如 30d

metric_groupstring

指标组

normalized_chainstring

normalized_chain

staking_metricsobject

质押指标序列

series[]object[]

指标时间序列

data_statusDataStatus

数据状态

datedatetime

统计日期

entry_queue_ethnumber

排队进入质押的 ETH 数量

entry_queue_validator_estimatenumber

等待进入的验证者估计数

entry_wait_daysnumber

进入队列等待天数

eth_supplynumber

ETH 供应量

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_taskstring

actual_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。