Get Top 10 Statistics

1. Overview & Typical Use

Returns top statistics data across multiple dimensions including overview, accounts, tokens, contracts, and resources.

Typical use: display leaderboard data across dimensions, render Top N components on a homepage.
When not to use: for single contract call details use “Get Contract Call Statistics”.

2. Endpoint & Authentication

GET /api/top10

For Base URL and authentication, see Common Network & Authentication.

3. Request

Fields

Parameter	Type	Required	Default	Description
`time`	integer	No	`1`	Time type. `0`: real-time, `1`: last hour, `2`: last 24 hours, `3`: last week, `4`: last 3 days
`type`	string	No	`0`	Statistics type, values `0`–`20`; multiple nonzero types may be comma-separated (for example, `1,2,17`). `0`: overview; `1`: accounts by TRX sent; `2`: accounts by TRX send count; `3`: accounts by TRX received; `4`: accounts by TRX receive count; `5`: accounts by TRX frozen; `6`: accounts by votes; `7`: tokens by holder count; `8`: tokens by active accounts; `9`: tokens by total transaction count; `10`: tokens by total transaction amount; `11`: contracts by TRX balance; `12`: contracts by caller count; `13`: contracts by call count; `14`: accounts by energy consumption; `15`: accounts by bandwidth consumption; `16`: contracts by energy consumption; `17`: contracts by fee consumption; `18`: hot tokens; `19`: hot contracts; `20`: account fee usage

4. Response

Fields

When type=0 (overview)

Top-level fields (all string type except start_time / end_time which are integer):

Field	Type	Required	Description	Unit/Precision
`token_record`	string	Required	Total tokens ever issued (including inactive)	—
`trc20_record`	string	Required	Total TRC20 tokens ever issued	—
`trc10_record`	string	Required	Total TRC10 tokens ever issued	—
`token_all`	string	Required	Current active token count	—
`trc20_all`	string	Required	Current active TRC20 token count	—
`trc10_all`	string	Required	Current active TRC10 token count	—
`whole_vote`	string	Required	Total votes on the network	—
`whole_freeze`	string	Required	Total TRX frozen on the network	TRX
`contract_whole_balance`	string	Required	Total TRX balance across all contracts	TRX
`start_time`	integer	Required	Statistics start time	Millisecond timestamp
`end_time`	integer	Required	Statistics end time	Millisecond timestamp
`last_hour_contract_active_address`	string	Required	Active contract addresses in the last hour	—
`last_hour_contract_triggers`	string	Required	Contract trigger count in the last hour	—
`last_hour_energy_usage`	string	Required	Energy usage in the last hour	—
`last_hour_net_usage`	string	Required	Bandwidth usage in the last hour	—
`last_hour_token10_active_address`	string	Required	Active TRC10 addresses in the last hour	—
`last_hour_token10_sum_transaction`	string	Required	TRC10 transaction count in the last hour	—
`last_hour_token10_sum_transaction_amount`	string	Required	TRC10 total transaction amount in the last hour	—
`last_hour_token20_active_address`	string	Required	Active TRC20 addresses in the last hour	—
`last_hour_token20_sum_transaction`	string	Required	TRC20 transaction count in the last hour	—
`last_hour_token20_sum_transaction_amount`	string	Required	TRC20 total transaction amount in the last hour	—
`last_hour_trx_transaction_number`	string	Required	TRX transaction count in the last hour	—
`last_hour_trx_transfer_amount`	string	Required	TRX transfer amount in the last hour	TRX
`last_hour_whole_contract_use`	string	Required	Contract resource usage in the last hour	—
`last_hour_whole_energy_burn`	string	Required	Energy burned in the last hour	—
`last_hour_whole_energy_use`	string	Required	Network-wide energy usage in the last hour	—
`last_hour_whole_fee_burn`	string	Required	Fee burned in the last hour	sun
`last_hour_whole_net_burn`	string	Required	Bandwidth burned in the last hour	—
`last_hour_whole_net_use`	string	Required	Network-wide bandwidth usage in the last hour	—
`last_day_contract_active_address`	string	Required	Active contract addresses in the last 24 hours	—
`last_day_contract_triggers`	string	Required	Contract trigger count in the last 24 hours	—
`last_day_energy_usage`	string	Required	Energy usage in the last 24 hours	—
`last_day_net_usage`	string	Required	Bandwidth usage in the last 24 hours	—
`last_day_token10_active_address`	string	Required	Active TRC10 addresses in the last 24 hours	—
`last_day_token10_sum_transaction`	string	Required	TRC10 transaction count in the last 24 hours	—
`last_day_token10_sum_transaction_amount`	string	Required	TRC10 total transaction amount in the last 24 hours	—
`last_day_token20_active_address`	string	Required	Active TRC20 addresses in the last 24 hours	—
`last_day_token20_sum_transaction`	string	Required	TRC20 transaction count in the last 24 hours	—
`last_day_token20_sum_transaction_amount`	string	Required	TRC20 total transaction amount in the last 24 hours	—
`last_day_trx_transaction_number`	string	Required	TRX transaction count in the last 24 hours	—
`last_day_trx_transfer_amount`	string	Required	TRX transfer amount in the last 24 hours	TRX
`last_day_whole_contract_use`	string	Required	Contract resource usage in the last 24 hours	—
`last_day_whole_energy_burn`	string	Required	Energy burned in the last 24 hours	—
`last_day_whole_energy_use`	string	Required	Network-wide energy usage in the last 24 hours	—
`last_day_whole_fee_burn`	string	Required	Fee burned in the last 24 hours	sun
`last_day_whole_net_burn`	string	Required	Bandwidth burned in the last 24 hours	—
`last_day_whole_net_use`	string	Required	Network-wide bandwidth usage in the last 24 hours	—
`last_three_day_contract_active_address`	string	Required	Active contract addresses in the last 3 days	—
`last_three_day_contract_triggers`	string	Required	Contract trigger count in the last 3 days	—
`last_three_day_energy_usage`	string	Required	Energy usage in the last 3 days	—
`last_three_day_net_usage`	string	Required	Bandwidth usage in the last 3 days	—
`last_three_day_token10_active_address`	string	Required	Active TRC10 addresses in the last 3 days	—
`last_three_day_token10_sum_transaction`	string	Required	TRC10 transaction count in the last 3 days	—
`last_three_day_token10_sum_transaction_amount`	string	Required	TRC10 total transaction amount in the last 3 days	—
`last_three_day_token20_active_address`	string	Required	Active TRC20 addresses in the last 3 days	—
`last_three_day_token20_sum_transaction`	string	Required	TRC20 transaction count in the last 3 days	—
`last_three_day_token20_sum_transaction_amount`	string	Required	TRC20 total transaction amount in the last 3 days	—
`last_three_day_trx_transaction_number`	string	Required	TRX transaction count in the last 3 days	—
`last_three_day_trx_transfer_amount`	string	Required	TRX transfer amount in the last 3 days	TRX
`last_three_day_whole_contract_use`	string	Required	Contract resource usage in the last 3 days	—
`last_three_day_whole_energy_burn`	string	Required	Energy burned in the last 3 days	—
`last_three_day_whole_energy_use`	string	Required	Network-wide energy usage in the last 3 days	—
`last_three_day_whole_fee_burn`	string	Required	Fee burned in the last 3 days	sun
`last_three_day_whole_net_burn`	string	Required	Bandwidth burned in the last 3 days	—
`last_three_day_whole_net_use`	string	Required	Network-wide bandwidth usage in the last 3 days	—
`last_week_contract_active_address`	string	Required	Active contract addresses in the last week	—
`last_week_contract_triggers`	string	Required	Contract trigger count in the last week	—
`last_week_energy_usage`	string	Required	Energy usage in the last week	—
`last_week_net_usage`	string	Required	Bandwidth usage in the last week	—
`last_week_token10_active_address`	string	Required	Active TRC10 addresses in the last week	—
`last_week_token10_sum_transaction`	string	Required	TRC10 transaction count in the last week	—
`last_week_token10_sum_transaction_amount`	string	Required	TRC10 total transaction amount in the last week	—
`last_week_token20_active_address`	string	Required	Active TRC20 addresses in the last week	—
`last_week_token20_sum_transaction`	string	Required	TRC20 transaction count in the last week	—
`last_week_token20_sum_transaction_amount`	string	Required	TRC20 total transaction amount in the last week	—
`last_week_trx_transaction_number`	string	Required	TRX transaction count in the last week	—
`last_week_trx_transfer_amount`	string	Required	TRX transfer amount in the last week	TRX
`last_week_whole_contract_use`	string	Required	Contract resource usage in the last week	—
`last_week_whole_energy_burn`	string	Required	Energy burned in the last week	—
`last_week_whole_energy_use`	string	Required	Network-wide energy usage in the last week	—
`last_week_whole_fee_burn`	string	Required	Fee burned in the last week	sun
`last_week_whole_net_burn`	string	Required	Bandwidth burned in the last week	—
`last_week_whole_net_use`	string	Required	Network-wide bandwidth usage in the last week	—

When type is not 0

Response is an array; each element contains start_time, end_time, type, and data fields.

Field	Type	Presence	Description	Unit
`type`	integer	Required	Ranking identifier (`1`–`20`).	—
`start_time`	integer	Required	Start of this ranking snapshot; use the returned window.	ms
`end_time`	integer	Required	End of this ranking snapshot; cached snapshots may be older than the request.	ms
`update_time`	integer	Optional	Source update timestamp, when available. Observed `type=5/6` rows use seconds; other observed modes use milliseconds. Do not apply one unit to every mode.	s / ms
`data`	array	Required	Ranking entries described below; an unavailable snapshot returns `[]` inside this envelope.	—
`wholeFeeBurn`	string	Optional	`type=17` only, when `total_contract_fee_usage` is available; the same aggregate serialized as a string.	TRX

type=5/6/7/11 always reads the latest stored snapshot, regardless of time. The returned time fields describe available source metadata or a fallback window; they do not guarantee fresh data.

Shared data[] fields

Accounts (type=1–6,14,15,20)

Field	Type	Presence	Description	Unit
`address`	string	Required	Ranked account address.	—
`addressTag`	string	Optional	Address label; may be absent or empty.	—
`percentage`	number	Required	Share of the ranked metric in the snapshot population, not a share recalculated from only the returned top ten.	ratio

Tokens (type=7–10)

Field	Type	Presence	Description	Unit
`token_id`	string	Required	Token identifier: TRC10 ID, TRC20 contract, or `_` / `0` for native TRX depending on the snapshot.	—
`type`	integer	Required	Token standard: `10` = TRC10/native TRX, `20` = TRC20. Distinct from the outer ranking `type`.	—
`name`	string	Optional	Token name.	—
`abbr`	string	Optional	Token abbreviation.	—
`logo`	string	Optional	Token logo URL.	—
`vip`	boolean	Required	Whether the token is VIP-tagged.	—

Contracts (type=11,12,13,16,17)

Field	Type	Presence	Description	Unit
`contract`	string	Required	Ranked contract address.	—
`percentage`	number	Required	Share of the ranked metric in the snapshot population, not just the returned top ten.	ratio
`name`	string	Optional	Contract name.	—
`isToken`	boolean	Optional	Whether contract metadata identifies a token contract.	—
`risk`	boolean	Optional	Contract risk flag.	—
`vip`	boolean	Optional	VIP flag.	—
`tag1`	string	Optional	Public address label; may be empty.	—
`tag1Url`	string	Optional	Link associated with the public label.	—
`tag1Url_level`	integer	Optional	Classification of `tag1Url`, when supplied.	—
`blueTagUrl`	string	Optional	Project URL.	—
`blueTagUrl_level`	integer	Optional	Classification of `blueTagUrl`, when supplied.	—
`publicTagDesc`	string	Optional	Public label description.	—

Ranking metrics in data[]

The following fields occur in nonempty entries only for the listed outer ranking type and snapshot variant. Snapshot-specific fields are conditional; do not require both the current and legacy variants on one entry.

Ranking `type` / snapshot	Field	Type	Meaning	Unit
`1/3`	`amount`	number	TRX sent (`1`) or received (`3`) during the statistics window, already converted from SUN.	TRX
`1–4`	`type`	integer	Token-standard marker `10` for TRX; distinct from the outer ranking type.	—
`2/4/9`	`transaction_number`	number	TRX outgoing (`2`), TRX incoming (`4`), or token (`9`) transfer count; may be serialized with a decimal point.	Count
`5`	`freeze`	number	Staked TRX balance, truncated to whole TRX in this snapshot.	TRX
`5/6`	`vote` / `votes`	number	Votes cast by the account: `vote` in mode `5`, `votes` in mode `6`.	Votes
`5`	`votePercentage`	number	Account votes / total votes in the snapshot; `percentage` on the same record is the staking share.	0–1
`7`	`holders`	number	Number of token-holding addresses.	Addresses
`7`	`percentage`	number	Holder count / summed holder counts across tokens in the statistics; an address can hold multiple tokens.	0–1
`8`	`address_number`	number	Active transfer address count; day/week/three-day snapshots count senders and receivers, while legacy hourly snapshots count senders.	Addresses
`8–10`	`percentage`	number \| string	Metric share in the USD/current snapshot, or growth ratio in the legacy hourly snapshot; see snapshot variants below.	Ratio
`10` (USD snapshot)	`priceInUsd`	number	Total transferred value in USD; not a unit token price.	USD
`10` (legacy hourly)	`amount`	number	Transferred token quantity, already adjusted for token decimals.	Token units
`10` (legacy hourly)	`tokenPrice`	number	TRX price per whole token.	TRX/token
`10` (legacy hourly)	`priceInTrx`	number	Total transferred value in TRX: `amount * tokenPrice`.	TRX
`11`	`holders`	number	Contract TRX balance, despite the field name; not a holder count.	TRX
`12`	`active_address`	number	Number of distinct addresses calling the contract.	Addresses
`13`	`triggers`	number	Contract trigger count during the statistics window.	Count
`14/16`	`energy_use`	number	Energy supplied by the sender/caller’s resources.	Energy
`14/16`	`energy_burn`	number	Energy obtained by burning TRX; a resource quantity.	Energy
`14/16`	`contract_use`	number	Energy supplied by the contract deployer.	Energy
`14/16`	`whole_energy_use`	number	Total Energy: `energy_use + energy_burn + contract_use`; attributed to an account (`14`) or contract (`16`).	Energy
`15`	`net_use`	number	Bandwidth supplied by staked or free resources.	Bandwidth
`15`	`net_burn`	number	Bandwidth obtained by burning TRX; a resource quantity.	Bandwidth
`15`	`whole_net_use`	number	Total Bandwidth: `net_use + net_burn`.	Bandwidth
`17/20`	`totalBurn`	number	TRX burned for Energy plus Bandwidth; attributed to contract calls (`17`) or an account (`20`).	TRX
`17` (day/week/three-day)	`energy_burn`	number	TRX burned for Energy; unlike the same field in modes `14/16`, this is a currency amount.	TRX
`17` (legacy hourly), `20`	`energyBurn`	number	TRX burned for Energy.	TRX
`17/20`	`netBurn`	number	TRX burned for Bandwidth.	TRX
`17` (day/week/three-day)	`total_contract_fee_usage`	number	Resource-fee burn across all contract calls in the snapshot; denominator of `percentage`, not another fee to add to this row.	TRX

Snapshot variants and empty results

For type=8/9/10, the observed day/week/three-day snapshots return a numeric percentage: the token metric divided by the corresponding total across all tokens included in the statistics, before truncation to ten entries. The legacy hourly snapshots return a string growth ratio (current - base) / base, where base = max(previous snapshot value, 1) (missing history also uses 1). This growth ratio can be negative or greater than 1; it is not a share of the total. Multiply either ratio by 100 only when displaying a percentage.

For type=10, the observed legacy hourly shape uses amount, tokenPrice, and priceInTrx; the USD-valued shape uses priceInUsd. For type=17, select energy_burn or legacy energyBurn; both are TRX amounts in this mode. Treat these as snapshot variants rather than requiring every field together.

All 20 modes retain the array envelope when data is empty. A zero-length data array means no ranking entries are available for that snapshot, not that every metric is zero. type=18/19 returned data: [] for every tested time=0–4; their nonempty field contracts remain unconfirmed.

Example

Example is a representative excerpt; the full field contract (including all ‘Always’ fields) is in §5 above.


{
  "token_record": "194724",
  "trc20_record": "189645",
  "trc10_record": "5079",
  "token_all": "193784",
  "trc20_all": "188705",
  "trc10_all": "5079",
  "whole_vote": "41378685077",
  "whole_freeze": "35138801492.878769",
  "contract_whole_balance": "19311993488.954099",
  "start_time": 1792641600000,
  "end_time": 1792645200000,
  "last_hour_trx_transaction_number": "79618",
  "last_hour_trx_transfer_amount": "17713264.139398",
  "last_hour_token20_sum_transaction": "154857",
  "last_hour_token20_sum_transaction_amount": "3999022027.6862312039836702323020360380151171747689413238730277480000",
  "last_hour_whole_fee_burn": "294889013220",
  "last_hour_whole_energy_use": "5955709675",
  "last_hour_whole_net_use": "84357307",
  "last_day_trx_transaction_number": "3925288",
  "last_day_trx_transfer_amount": "1396944472.668470",
  "last_day_token20_sum_transaction": "2108756",
  "last_day_whole_fee_burn": "9044446899120",
  "last_day_whole_energy_use": "153397574677",
  "last_day_net_usage": "2596250200",
  "last_week_trx_transaction_number": "24194511",
  "last_week_whole_fee_burn": "47905551862890",
  "last_week_whole_energy_use": "952068809051"
}

type=1–20, time=2

One entry per nonempty ranking is shown from the same response; 18/19 retain their actual empty arrays.


[
  {
    "type": 1,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "amount": 100213879.256242,
        "address": "TWhDfwC8QE6pQyiYy248dNor3uphPEw5M2",
        "percentage": 0.131155,
        "type": 10
      }
    ]
  },
  {
    "type": 2,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "address": "TUSYcK5yf8Et4xNTiUcpfZwmhFsxfdoooo",
        "transaction_number": 55780.000000,
        "percentage": 0.012761,
        "type": 10
      }
    ]
  },
  {
    "type": 3,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "amount": 100200777.823638,
        "address": "TWhDfwC8QE6pQyiYy248dNor3uphPEw5M2",
        "percentage": 0.131137,
        "type": 10
      }
    ]
  },
  {
    "type": 4,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "address": "TDii6vao7xyWg2rKPbCPWVRpSmne8xcqYx",
        "transaction_number": 76016.000000,
        "percentage": 0.017390,
        "type": 10
      }
    ]
  },
  {
    "type": 5,
    "start_time": 1792490400000,
    "end_time": 1792576800000,
    "update_time": 1792540800,
    "data": [
      {
        "votePercentage": 0.226207,
        "address": "TU3kjFuhtEo42tsCBtfYUAZxoqQ4yuSLQ5",
        "freeze": 9833046989,
        "percentage": 0.217770,
        "addressTag": "",
        "vote": 9833046989.000000
      }
    ]
  },
  {
    "type": 6,
    "start_time": 1792490400000,
    "end_time": 1792576800000,
    "update_time": 1740622498,
    "data": [
      {
        "address": "TU3kjFuhtEo42tsCBtfYUAZxoqQ4yuSLQ5",
        "percentage": 0.18887795258492138,
        "votes": 7815521318
      }
    ]
  },
  {
    "type": 7,
    "start_time": 1792281600000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "token_id": "_",
        "holders": 246373715,
        "percentage": 0.713257,
        "name": "TRX",
        "logo": "https://static.tronscan.org/production/logo/trx.png",
        "abbr": "TRON",
        "type": 10,
        "vip": true
      }
    ]
  },
  {
    "type": 8,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "token_id": "0",
        "percentage": 0.712331,
        "name": "TRX",
        "logo": "https://static.tronscan.org/production/logo/trx.png",
        "abbr": "TRON",
        "type": 10,
        "vip": true,
        "address_number": 2738433
      }
    ]
  },
  {
    "type": 9,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "token_id": "0",
        "transaction_number": 4405823,
        "percentage": 0.641251,
        "name": "TRX",
        "logo": "https://static.tronscan.org/production/logo/trx.png",
        "abbr": "TRON",
        "type": 10,
        "vip": true
      }
    ]
  },
  {
    "type": 10,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "percentage": 0.963206,
        "priceInUsd": 31676770865.280918,
        "name": "Tether USD",
        "logo": "https://static.tronscan.org/production/logo/usdtlogo.png",
        "abbr": "USDT",
        "type": 20,
        "vip": true
      }
    ]
  },
  {
    "type": 11,
    "start_time": 1792490400000,
    "end_time": 1792576800000,
    "update_time": 1740622500836,
    "data": [
      {
        "isToken": false,
        "tag1": "USDDOLD-TRX",
        "tag1Url_level": 1,
        "tag1Url": "https://usdd.io",
        "holders": 8997562062.236495,
        "contract": "TNMcQVGPzqH9ZfMCSY4PNrukevtDgp24dK",
        "percentage": 0.46591,
        "name": "MultiSigTRXBurn",
        "risk": false,
        "publicTagDesc": "",
        "vip": false
      }
    ]
  },
  {
    "type": 12,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "tag1": "USDT Token",
        "tag1Url_level": 1,
        "tag1Url": "https://tron.network/usdt",
        "blueTagUrl_level": 0,
        "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "publicTagDesc": "",
        "isToken": true,
        "blueTagUrl": "tether.to",
        "percentage": 0.9935,
        "name": "TetherToken",
        "active_address": 782133,
        "risk": false,
        "vip": true
      }
    ]
  },
  {
    "type": 13,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "tag1": "USDT Token",
        "tag1Url_level": 1,
        "tag1Url": "https://tron.network/usdt",
        "blueTagUrl_level": 0,
        "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "triggers": 2383125,
        "publicTagDesc": "",
        "isToken": true,
        "blueTagUrl": "tether.to",
        "percentage": 0.961164,
        "name": "TetherToken",
        "risk": false,
        "vip": true
      }
    ]
  },
  {
    "type": 14,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "energy_burn": 2222379739,
        "address": "TLaGjwhvA8XQYSxFAcAXy7Dvuue9eGYitv",
        "contract_use": 576,
        "whole_energy_use": 7759236260,
        "energy_use": 5536855945,
        "percentage": 0.038897,
        "addressTag": "OKX Hot Wallet 8"
      }
    ]
  },
  {
    "type": 15,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "net_burn": 0,
        "address": "TH46mnDEM78hFBh26np3hDLjFy7WxFKSVV",
        "whole_net_use": 65497849,
        "net_use": 65497849,
        "percentage": 0.018721
      }
    ]
  },
  {
    "type": 16,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "tag1": "USDT Token",
        "tag1Url_level": 1,
        "tag1Url": "https://tron.network/usdt",
        "blueTagUrl_level": 0,
        "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "energy_use": 166559288211,
        "publicTagDesc": "",
        "isToken": true,
        "energy_burn": 19557234098,
        "contract_use": 28902,
        "whole_energy_use": 186116551211,
        "blueTagUrl": "tether.to",
        "percentage": 0.932996,
        "name": "TetherToken",
        "risk": false,
        "vip": true
      }
    ]
  },
  {
    "type": 17,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "wholeFeeBurn": "2350556.057800",
    "data": [
      {
        "tag1": "USDT Token",
        "tag1Url_level": 1,
        "tag1Url": "https://tron.network/usdt",
        "netBurn": 328872.898000,
        "blueTagUrl_level": 0,
        "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "publicTagDesc": "",
        "isToken": true,
        "energy_burn": 1955723.409800,
        "blueTagUrl": "tether.to",
        "total_contract_fee_usage": 2350556.057800,
        "percentage": 0.971939,
        "name": "TetherToken",
        "risk": false,
        "totalBurn": 2284596.307800,
        "vip": true
      }
    ]
  },
  {
    "type": 18,
    "start_time": 1792490400000,
    "end_time": 1792576800000,
    "data": []
  },
  {
    "type": 19,
    "start_time": 1792490400000,
    "end_time": 1792576800000,
    "data": []
  },
  {
    "type": 20,
    "start_time": 1792454400000,
    "end_time": 1792540800000,
    "update_time": 1792540800000,
    "data": [
      {
        "address": "TLaGjwhvA8XQYSxFAcAXy7Dvuue9eGYitv",
        "netBurn": 2620.275000,
        "percentage": 0.095662,
        "addressTag": "OKX Hot Wallet 8",
        "totalBurn": 224858.248900,
        "energyBurn": 222237.973900
      }
    ]
  }
]

Legacy hourly variants: type=8,9,10,17, time=1

One entry per ranking. These cached snapshots have older returned timestamps; the request time is not their data time.


[
  {
    "type": 8,
    "start_time": 1729350000000,
    "end_time": 1729353600000,
    "update_time": 1729355811971,
    "data": [
      {
        "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "percentage": "20.25085",
        "name": "Tether USD",
        "logo": "https://static.tronscan.org/production/logo/usdtlogo.png",
        "abbr": "USDT",
        "type": 20,
        "vip": true,
        "address_number": 68704
      }
    ]
  },
  {
    "type": 9,
    "start_time": 1729350000000,
    "end_time": 1729353600000,
    "update_time": 1729355811971,
    "data": [
      {
        "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "transaction_number": 151858,
        "percentage": "27.06987",
        "name": "Tether USD",
        "logo": "https://static.tronscan.org/production/logo/usdtlogo.png",
        "abbr": "USDT",
        "type": 20,
        "vip": true
      }
    ]
  },
  {
    "type": 10,
    "start_time": 1729350000000,
    "end_time": 1729353600000,
    "update_time": 1729355811971,
    "data": [
      {
        "amount": 621152148.846674,
        "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "percentage": "25.59003",
        "tokenPrice": 6.348466957737223856,
        "name": "Tether USD",
        "logo": "https://static.tronscan.org/production/logo/usdtlogo.png",
        "priceInTrx": 3943363892.680583730686448959054944,
        "abbr": "USDT",
        "type": 20,
        "vip": true
      }
    ]
  },
  {
    "type": 17,
    "start_time": 1740524400000,
    "end_time": 1740528000000,
    "update_time": 1740532884770,
    "data": [
      {
        "tag1": "USDT Token",
        "tag1Url_level": 1,
        "tag1Url": "https://tron.network/usdt",
        "netBurn": 9037.136000,
        "blueTagUrl_level": 0,
        "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "publicTagDesc": "",
        "isToken": true,
        "blueTagUrl": "tether.to",
        "percentage": 0.94560,
        "name": "TetherToken",
        "risk": false,
        "totalBurn": 278846.763500,
        "vip": true,
        "energyBurn": 269809.627500
      }
    ]
  }
]

Empty snapshots: type=1,17,18,19, time=0


[
  {
    "type": 1,
    "start_time": 1792576800000,
    "end_time": 1792576800000,
    "data": []
  },
  {
    "type": 17,
    "start_time": 1792576800000,
    "end_time": 1792576800000,
    "data": []
  },
  {
    "type": 18,
    "start_time": 1792576800000,
    "end_time": 1792576800000,
    "data": []
  },
  {
    "type": 19,
    "start_time": 1792576800000,
    "end_time": 1792576800000,
    "data": []
  }
]

5. Errors

For HTTP status codes, see Common Errors. Key points for this endpoint:

When type is not 0: the response format is an array, not an object — parse accordingly.