获取带宽消耗数据
1. 概述与典型用途
返回每天的带宽消耗数据，包括质押带宽和燃烧带宽的使用量及占比。
- 典型用途：分析带宽消耗趋势、评估质押带宽与燃烧带宽的比例变化。
- 何时不要用：查带宽获取成本用「获取能量和带宽成本数据」；查质押率用「获取 TRX 质押率数据」。
2. 接口与鉴权
GET /api/netstatistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start_timestamp | integer | 否 | — | 开始时间，精确到毫秒 |
end_timestamp | integer | 否 | — | 结束时间，精确到毫秒 |
type | string | 否 | — | 统计类型：day、month 或 quarter |
limit | integer | 否 | — | 最大数据量，最大 3000 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
avg_net_energy | string | 必返 | 平均每日带宽消耗 | — |
yesterday_net_ratio | string | 必返 | 昨日质押带宽占比 | 小数字符串 |
data | array | 必返 | 每日带宽数据数组，见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | string | 必返 | 统计日期，格式 yyyy-MM-dd | — |
day | integer | 必返 | 统计日期 | 毫秒时间戳 |
net_usage | integer | 必返 | 质押带宽使用量 | — |
net_fee | integer | 必返 | 燃烧带宽使用量 | — |
net_usage_ratio | number | 必返 | 质押带宽占比 | 小数 |
net_fee_ratio | number | 必返 | 燃烧带宽占比 | 小数 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果不是错误：无数据返回
200+data: []，属于正常响应。
最后更新于: