获取合约调用统计数据
1. 概述与典型用途
返回指定时间段内合约调用的统计数据，包括调用者数量和触发次数的每日趋势。
- 典型用途：分析合约调用者数量与触发次数的时间趋势、查看极值。
- 何时不要用：查看单日各合约的调用分布用「获取合约调用分布」（
/api/triggeramountstatistic）。
2. 接口与鉴权
GET /api/contract_caller_statistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start_timestamp | integer | 否 | 最早统计起点 | 开始时间，精确到毫秒 |
end_timestamp | integer | 否 | 当前时间 | 结束时间，精确到毫秒 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 数据条数 | — |
caller_amount_max | object | 必返 | 调用者数量最大值对应的数据 | — |
caller_amount_min | object | 必返 | 调用者数量最小值对应的数据 | — |
triggers_amount_max | object | 必返 | 触发次数最大值对应的数据 | — |
triggers_amount_min | object | 必返 | 触发次数最小值对应的数据 | — |
data | array | 必返 | 每日统计列表，见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | integer | 必返 | 统计日期 | 毫秒时间戳 |
caller_amount | integer | 必返 | 当日调用者数量 | — |
caller_amount_rate | number | 必返 | 调用者数量环比变化率 | — |
triggers_amount | integer | 必返 | 当日触发次数 | — |
triggers_amount_rate | number | 必返 | 触发次数环比变化率 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果不是错误：无命中返回
200+data: []，属于正常响应。
最后更新于: