Get Bandwidth Consumption Data
1. Overview & Typical Use
Returns daily bandwidth consumption data, including the usage and ratio of staking bandwidth versus burned bandwidth.
- Typical use: analyzing bandwidth consumption trends, evaluating changes in the staking vs. burning bandwidth ratio.
- When not to use: to query bandwidth acquisition costs, use “Get Energy and Bandwidth Cost Data”; to query staking rates, use “Get TRX Staking Rate Data”.
2. Endpoint & Authentication
GET /api/netstatistic
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_timestamp | integer | No | — | Start time in milliseconds |
end_timestamp | integer | No | — | End time in milliseconds |
type | string | No | — | Statistics type: day, month, or quarter |
limit | integer | No | — | Maximum number of results, maximum 3000 |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
avg_net_energy | string | Required | Average daily bandwidth consumption | — |
yesterday_net_ratio | string | Required | Yesterday’s staking bandwidth ratio | Decimal string |
data | array | Required | Daily bandwidth data array, see below | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | string | Required | Statistics date, format yyyy-MM-dd | — |
day | integer | Required | Statistics date | Unix timestamp in milliseconds |
net_usage | integer | Required | Staking bandwidth usage | — |
net_fee | integer | Required | Burned bandwidth usage | — |
net_usage_ratio | number | Required | Staking bandwidth ratio | Decimal |
net_fee_ratio | number | Required | Burned bandwidth ratio | Decimal |
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: