Get TRX Staking Rate Data
1. Overview & Typical Use
Returns TRX staking rate data, including staking ratio, energy/bandwidth weight, and cost changes.
- Typical use: analyzing TRX staking rate trends and resource cost changes.
- When not to use: to view energy consumption distribution, use “Get Energy Consumption Distribution”.
2. Endpoint & Authentication
GET /api/freezeresource
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_day | string | No | — | Start date, format yyyy-MM-dd |
end_day | string | No | — | End date, format yyyy-MM-dd |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Number of data records | — |
freezing_rate | number | Required | Current staking rate | — |
freeze_rate_diff | number | Required | Staking rate change difference | — |
freeze1Percent | number | Required | Bandwidth staking percentage | — |
freeze2Percent | number | Required | Energy staking percentage | — |
total_freeze_weight_change_24h | number | Required | 24-hour staking weight change rate | — |
total_freeze_weight | integer | Required | Total staking weight | — |
data | array | Required | Daily staking data list, see below | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
day | string | Required | Statistics date | yyyy-MM-dd |
freezing_rate | number | Required | Staking rate for that day | — |
freezing_rate_change_24h | number | Required | 24h staking rate change | — |
freeze1Balance | integer | Required | Bandwidth staking amount | sun |
freeze2Balance | integer | Required | Energy staking amount | sun |
freeze1Percent | number | Required | Bandwidth staking percentage | — |
freeze2Percent | number | Required | Energy staking percentage | — |
total_freeze_weight | integer | Required | Total staking weight | — |
total_freeze_weight_change_24h | number | Required | Total staking weight 24h change rate | — |
energy_rate | number | Required | Energy staking ratio | — |
net_rate | number | Required | Bandwidth staking ratio | — |
total_energy_cost | number | Required | Energy acquisition cost | TRX/Energy |
total_net_cost | number | Required | Bandwidth acquisition cost | TRX/Bandwidth |
net_cost_change_24h | number | Required | Bandwidth cost 24h change | — |
energy_cost_change_24h | number | Required | Energy cost 24h change | — |
total_energy_weight | integer | Required | Total energy weight | — |
total_net_weight | integer | Required | Total bandwidth weight | — |
total_turn_over | string | Required | Total circulating supply (large number as string) | sun |
total_turnover_change_24h | number | Required | Total circulating supply 24h change rate | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- Empty result is not an error: returns
200+data: []as a normal response.
Last updated on: