链活动历史
查询指定公链在时间窗内的日活跃地址和交易笔数。
GET/api/v1/onchain/chains/{chain_id}/activity/history
可查询数据
- 返回数据
- 查询指定公链在时间窗内的日活跃地址和交易笔数。
- 每次返回什么
- 指定链每日一条活动记录
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
链与项目
chain_idstringpath示例chain_ethereum必填链 ID;示例 chain_ethereum
查询时间
按接口要求填写时间格式和边界;缺少日期不等于指标为0
fromstringquery示例2026-11-01T00:00:00Z必填起始 UTC 时间;示例 2026-11-01T00:00:00Z
tostringquery示例2026-11-08T00:00:00Z必填结束 UTC 时间;示例 2026-11-08T00:00:00Z
返回选项
timeframestringquery示例1d可选日粒度,仅支持 1d。 · 1d · 默认: 1d
响应
dataobject[]业务数据,结构见各接口的响应定义
data_statusDataStatusverified / ok:返回业务数据;partial:部分可用;no_data:无数据;not_ready:暂不可用
errornull | string | object错误信息;正常结果为 null
empty_reasonstring无数据或暂不可用的原因
missing_fieldsstring[]未提供的字段列表
coverage_fromstring已返回历史数据的起始日期
coverage_tostring已返回历史数据的结束日期
coverage_notestring数据覆盖范围说明
request_idstring请求追踪标识
operation_idstring接口操作标识
route_codestring请求路由标识
observed_atstring响应观测时间
metadataobject
状态、对象引用和限制等元信息
updated_atstring响应元信息更新时间
object_refsobject[]查询涉及的对象引用
limitationsstring[]数据使用或覆盖限制
data[]array[object]
chain_idstring链 ID
seriesobject[]每日活动记录;没有数据时为空数组
series[]array[object]
chain_idstring链 ID
chainstring链名称
assetstring源侧链代币代码,例如 eth
timestring该日活动数据时间
obs_datestring业务日期
obs_timestring源侧观测时间
addresses_activeinteger日唯一活跃地址数,不等于真实用户数
transaction_countinteger日链交易笔数,不等于代币转账事件数
activity_pair_statusstring活跃地址与交易数的配对状态;paired 表示两项成对返回
错误与降级
200
仅有部分数据可用。
200
查询窗口内没有数据,series 为空数组。
400
缺少 from 或 to。
400
from 不早于 to,或 timeframe 不是 1d。
401
检查 API Key。
403
检查 Key 的数据域权限。