获取能量消耗分布
1. 概述与典型用途
返回指定时间段内合约的能量消耗分布，包括质押、燃烧及合约自身提供能量的占比趋势。
- 典型用途：分析全网能量消耗来源分布趋势、质押 vs 燃烧占比变化。
- 何时不要用：查看各合约能量消耗排名用「获取合约能量消耗数据」。
2. 接口与鉴权
GET /api/energystatistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start_timestamp | integer | 否 | 最早统计起点 | 开始时间戳，精确到毫秒 |
end_timestamp | integer | 否 | 昨日 | 结束时间戳，精确到毫秒 |
size | integer | 否 | 1000 | 返回数量 |
type | integer | 否 | 0 | 统计类型。0：按天，1：按月，2：按季度 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 数据条数 | — |
max | object | 必返 | 能量消耗最大值对应的数据 | — |
min | object | 必返 | 能量消耗最小值对应的数据 | — |
data | array | 必返 | 能量消耗分布列表，见下 | — |
avg_consume_energy | string | 可选 | 平均每日能量消耗 | — |
yesterday_energy_ratio | string | 可选 | 昨日质押能量占比 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 统计日期 | yyyy-MM-dd |
total_energy | integer | 必返 | 当日能量消耗总量 | — |
energy | integer | 必返 | 质押获取的能量消耗 | — |
contract_supplied | integer | 必返 | 合约自身提供的能量消耗 | — |
trx | integer | 必返 | 燃烧 TRX 支付的能量消耗 | — |
energy_ration | string | 必返 | 质押能量占比 | — |
contract_supplied_ration | string | 必返 | 合约提供能量占比 | — |
trx_ration | string | 必返 | 燃烧 TRX 能量占比 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果不是错误：无命中返回
200+data: []，属于正常响应。
最后更新于: