获取合约能量消耗数据
1. 概述与典型用途
返回合约的能量统计数据，包括能量消耗总量、来源分布及合约排名。
- 典型用途：分析各合约能量消耗情况、查看能量消耗排行榜。
- 何时不要用：查看按天汇总的全网能量消耗趋势用「获取能量消耗分布」。
2. 接口与鉴权
GET /api/energydailystatistic
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 | 必返 | 合约地址 | — |
total_energy | integer | 必返 | 该合约能量消耗总量 | — |
energy | integer | 必返 | 质押获取的能量消耗 | — |
contract_supplied | integer | 必返 | 合约自身提供的能量消耗 | — |
trx | integer | 必返 | 燃烧 TRX 支付的能量消耗 | — |
name | string | 必返 | 合约名称 | — |
total_energy_percent | number | 必返 | 该合约能量占比 | — |
tag1 | string | 可选 | 合约标签 | — |
tag1Url | string | 可选 | 合约标签对应链接 | — |
blueTagUrl | string | 可选 | 合约官网链接 | — |
isToken | boolean | 必返 | 是否为代币合约 | — |
publicTagDesc | string | 可选 | 公开标签描述 | — |
risk | boolean | 必返 | 风险标记 | — |
vip | boolean | 必返 | 是否为 VIP 合约 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果 ≠ 错误：无命中返回
200+data: []，属于正常响应。
最后更新于: