获取 TRX 质押率数据
1. 概述与典型用途
返回 TRX 质押率数据，包括质押比例、能量/带宽权重及各项成本变化。
- 典型用途：分析 TRX 质押率变化趋势、资源成本变化。
- 何时不要用：查看能量消耗分布用「获取能量消耗分布」。
2. 接口与鉴权
GET /api/freezeresource
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start_day | string | 否 | — | 开始时间，格式 yyyy-MM-dd |
end_day | string | 否 | — | 结束时间，格式 yyyy-MM-dd |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 数据条数 | — |
freezing_rate | number | 必返 | 当前质押率 | — |
freeze_rate_diff | number | 必返 | 质押率变化差值 | — |
freeze1Percent | number | 必返 | 带宽质押占比 | — |
freeze2Percent | number | 必返 | 能量质押占比 | — |
total_freeze_weight_change_24h | number | 必返 | 24 小时质押权重变化率 | — |
total_freeze_weight | integer | 必返 | 总质押权重 | — |
data | array | 必返 | 每日质押数据列表，见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 统计日期 | yyyy-MM-dd |
freezing_rate | number | 必返 | 当日质押率 | — |
freezing_rate_change_24h | number | 必返 | 质押率 24h 变化 | — |
freeze1Balance | integer | 必返 | 带宽质押量 | sun |
freeze2Balance | integer | 必返 | 能量质押量 | sun |
freeze1Percent | number | 必返 | 带宽质押占比 | — |
freeze2Percent | number | 必返 | 能量质押占比 | — |
total_freeze_weight | integer | 必返 | 总质押权重 | — |
total_freeze_weight_change_24h | number | 必返 | 总质押权重 24h 变化率 | — |
energy_rate | number | 必返 | 能量质押比例 | — |
net_rate | number | 必返 | 带宽质押比例 | — |
total_energy_cost | number | 必返 | 能量获取成本 | TRX/Energy |
total_net_cost | number | 必返 | 带宽获取成本 | TRX/Bandwidth |
net_cost_change_24h | number | 必返 | 带宽成本 24h 变化 | — |
energy_cost_change_24h | number | 必返 | 能量成本 24h 变化 | — |
total_energy_weight | integer | 必返 | 总能量权重 | — |
total_net_weight | integer | 必返 | 总带宽权重 | — |
total_turn_over | string | 必返 | 总流通量（大数用 string） | sun |
total_turnover_change_24h | number | 必返 | 总流通量 24h 变化率 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果不是错误：无命中返回
200+data: []，属于正常响应。
最后更新于: