链活动历史

查询指定公链在时间窗内的日活跃地址和交易笔数。

GET/api/v1/onchain/chains/{chain_id}/activity/history
数据域
网络与协议
解析层级
指定链每日一条活动记录
MCP 工具
onchain_query (task=chain_activity, range=window)

可查询数据

返回数据
查询指定公链在时间窗内的日活跃地址和交易笔数。
每次返回什么
指定链每日一条活动记录

认证

所有请求需携带 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_statusDataStatus

verified / 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 的数据域权限。