获取能量和带宽成本数据
1. 概述与典型用途
返回能量和带宽等资源的获取成本，包括质押成本和燃烧成本。
- 典型用途：分析资源获取成本变化趋势，为质押或燃烧决策提供依据。
- 何时不要用：查看能量消耗分布用「获取能量消耗分布」。
2. 接口与鉴权
GET /api/acquisition_cost_statistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start_timestamp | integer | 否 | — | 开始时间，精确到毫秒 |
end_timestamp | integer | 否 | 昨日 | 结束时间，精确到毫秒 |
limit | integer | 否 | 14 | 返回数据数量 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 数据条数 | — |
energy_cost_max | object | 必返 | 能量成本最大值对应的数据 | — |
energy_cost_min | object | 必返 | 能量成本最小值对应的数据 | — |
net_cost_max | object | 必返 | 带宽成本最大值对应的数据 | — |
net_cost_min | object | 必返 | 带宽成本最小值对应的数据 | — |
data | array | 必返 | 每日成本数据列表，见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 统计日期 | yyyy-MM-dd |
total_energy_cost | number | 必返 | 能量质押成本 | TRX/Energy |
energy_cost_rate | number | 必返 | 能量成本环比变化率 | — |
total_net_cost | number | 必返 | 带宽质押成本 | TRX/Bandwidth |
net_cost_rate | number | 必返 | 带宽成本环比变化率 | — |
burn_energy_cost | number | 必返 | 能量燃烧成本 | TRX/Energy |
burn_net_cost | number | 必返 | 带宽燃烧成本 | TRX/Bandwidth |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果不是错误：无命中返回
200+data: []，属于正常响应。
最后更新于: