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