Get TRON Statistics Overview
1. Overview & Typical Use
Returns daily comprehensive statistics for TRON, covering transactions, accounts, resources, blocks, tokens, and their day-over-day change rates.
- Typical use: build a comprehensive data dashboard, retrieve all core metrics in a single request, analyze overall on-chain health.
- When not to use: when only a single dimension is needed, use the corresponding dedicated endpoint (e.g., transaction trend, active accounts) to reduce data transfer.
2. Endpoint & Authentication
GET /api/stats/overview
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
days | integer | No | 15 | Number of days to query |
type | string | No | — | Controls additional return data; pass trxHolder to also return the count of accounts holding TRX |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
success | boolean | Required | Whether the request succeeded | — |
avg_increase_accounts | integer | Required | Average daily new account count | — |
data | array | Required | Daily statistics array; see below | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | integer | Required | Statistics date | Millisecond timestamp |
dateDayStr | string | Required | Date string | yyyy-MM-dd |
totalTransaction | integer | Required | Cumulative total transactions | — |
newTransactionSeen | integer | Required | New transactions on this day | — |
totalAddress | integer | Required | Cumulative total addresses | — |
totalAddressRate | number | Required | Total address day-over-day change rate | decimal |
totalAddressMom | number | Required | Total address month-over-month change rate | decimal |
newAddressSeen | integer | Required | New addresses on this day | — |
active_account_number | integer | Required | Active accounts on this day | — |
accountWithTrx | integer | Required | Number of accounts holding TRX | — |
avgBlockTime | integer | Required | Average block time | seconds |
avgBlockSize | integer | Required | Average block size | bytes |
totalBlockCount | integer | Required | Cumulative total blocks | — |
newBlockSeen | integer | Required | New blocks on this day | — |
blockchainSize | integer | Required | Cumulative blockchain data size | bytes |
triggers | integer | Required | Cumulative contract triggers | — |
newTrigger | integer | Required | Contract triggers on this day | — |
trx_transfer | integer | Required | TRX transfers on this day | — |
trc10_transfer | integer | Required | TRC10 transfers on this day | — |
usdt_transaction | integer | Required | USDT transactions on this day | — |
freeze_transaction | integer | Required | Staking-type transactions on this day | — |
unfreeze_transaction | integer | Required | Unstaking-type transactions on this day | — |
vote_transaction | integer | Required | Vote-type transactions on this day | — |
shielded_transaction | integer | Required | Shielded transactions on this day | — |
other_transaction | integer | Required | Other-type transactions on this day | — |
energy_usage | integer | Required | Energy consumed on this day | — |
net_usage | integer | Required | Bandwidth consumed on this day | — |
energy_usage_change_24h | number | Required | 24h energy consumption change rate | decimal |
net_usage_change_24h | number | Required | 24h bandwidth consumption change rate | decimal |
active_account_number_rate | number | Required | Active account count day-over-day change rate | decimal |
newAddressSeenRate | number | Required | New address count day-over-day change rate | decimal |
totalTrc20 | integer | Required | Total TRC20 token count | — |
newTrc20 | integer | Required | New TRC20 tokens on this day | — |
totalTrc10 | integer | Required | Total TRC10 token count | — |
newTrc10 | integer | Required | New TRC10 tokens on this day | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- Empty result is not an error: no data returns
200+data: []— this is a normal response.
Last updated on: