获取合约能量统计数据
1. 概述与典型用途
查询合约的历史每日能量消耗统计数据，包含质押获取的能量、TRX 燃烧消耗的能量以及合约部署方提供的能量。
- 典型用途：合约能量消耗趋势分析、评估合约运营成本、了解合约能量来源分布。
- 何时不要用：查询合约每日分析数据（含能量、带宽、余额等）用「获取合约每日分析数据列表」。
2. 接口与鉴权
GET /api/onecontractenergystatistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 合约地址（Base58，T 开头） |
start_timestamp | integer | 否 | — | 起始时间，毫秒时间戳 |
end_timestamp | integer | 否 | — | 结束时间，毫秒时间戳 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 数据条数 | — |
totalEnergy | integer | 必返 | 历史能量消耗总计 | — |
data | array | 必返 | 每日能量统计数组 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | integer | 必返 | 日期 | 毫秒时间戳 |
total_energy | integer | 必返 | 当日总能量消耗 | — |
energy | integer | 必返 | 来自质押/冻结的能量消耗 | — |
contract_supplied | integer | 必返 | 合约部署方提供的能量 | — |
trx | integer | 必返 | 通过 TRX 燃烧获取的能量消耗 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 地址不是合约：返回
200+data: []，total: 0。 - 空结果 ≠ 错误：合约无能量消耗记录时返回空数组，属于正常响应。
最后更新于: