获取合约每日调用次数列表
1. 概述与典型用途
查询合约在指定时间段内每日的调用次数统计,用于分析合约使用频率趋势。
- 典型用途:合约调用量趋势图、DApp 日交易量统计、合约热度监控。
- 何时不要用:查看每日独立调用地址数用「获取合约每日独立调用地址数量」;查看 Top 调用方法用「获取合约调用统计数据」。
2. 接口与鉴权
GET /api/onecontracttriggerstatistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 合约地址(Base58,T 开头) |
start_timestamp | integer | 否 | — | 开始时间,毫秒时间戳 |
end_timestamp | integer | 否 | — | 结束时间,毫秒时间戳 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 数据条数(天数) | — |
totalAmount | integer | 必返 | 时间段内调用总次数 | — |
data | array | 必返 | 每日统计数组 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | integer | 必返 | 日期 | 毫秒时间戳 |
amount | integer | 必返 | 当日调用次数 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 时间范围无数据:返回
200+data: [],total: 0。 - 空结果 ≠ 错误:合约不存在或时间段内无调用时返回空数组,属于正常响应。
最后更新于: