获取合约调用分布
1. 概述与典型用途
返回指定日期的合约调用分布情况,包括各合约的触发次数和调用者数量。
- 典型用途:分析合约调用热度分布、查看调用者与触发次数排行。
- 何时不要用:查看按时间段汇总的合约调用趋势用「获取合约调用统计数据」。
2. 接口与鉴权
GET /api/triggeramountstatistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
day | integer | 否 | 最近统计周期 | 数据时间,精确到毫秒 |
limit | integer | 否 | 10 | 返回数量,最大 50 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
totalTrigger | integer | 必返 | 当日触发交易总数 | — |
totalCallerAmount | integer | 必返 | 当日调用者总数 | — |
totalEnergy | integer | 必返 | 当日能量消耗总量 | — |
total | integer | 必返 | 命中合约总数 | — |
lastUpdateSeconds | integer | 必返 | 数据更新时间 | 秒级 Unix 时间戳 |
data | array | 必返 | 合约调用分布列表,见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
contract_address | string | 必返 | 合约地址 | — |
trigger_amount | integer | 必返 | 触发次数 | — |
caller_amount | integer | 必返 | 调用者数量 | — |
call_value | integer | 必返 | 调用金额 | — |
name | string | 必返 | 合约名称 | — |
trigger_amount_percent | number | 必返 | 触发次数占比 | — |
caller_amount_percent | number | 必返 | 调用者数量占比 | — |
tag1 | string | 可选 | 合约标签 | — |
tag1Url | string | 可选 | 合约标签链接 | — |
blueTagUrl | string | 可选 | 合约官网链接 | — |
isToken | boolean | 必返 | 是否为代币合约 | — |
publicTagDesc | string | 可选 | 公开标签描述 | — |
risk | boolean | 必返 | 风险标记 | — |
vip | boolean | 必返 | 是否为 VIP 合约 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 空结果不是错误:无命中返回
200+data: [],属于正常响应。
最后更新于: