Get TRONSCAN Homepage Data

1. Overview & Typical Use

Fetches all aggregated data required for the TRONSCAN homepage in a single request, including TPS, node count, statistics overview, staking rate, contract triggers, stablecoins, and TVL.

Typical use: rendering all core metrics on the homepage at once, reducing concurrent multi-endpoint requests.
When not to use: when only a single dimension of data is needed, use the corresponding dedicated endpoint.
Individual sub-objects may be empty, but the overall response still returns HTTP 200.

2. Endpoint & Authentication

GET /api/system/homepage-bundle

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

3. Request

Fields

Parameter	Type	Required	Default	Description
`source`	string	No	`coinmarketcap`	TRX price data source: `coinmarketcap` or `coingecko`

4. Response

Fields

Top-level fields

Field	Type	Required	Description
`tps`	object	Required	TPS data, see `tps` object below
`node`	object	Required	Node statistics, see `node` object below
`statsOverview`	object	Required	On-chain statistics overview, see `statsOverview` object below
`freezeResource`	object	Required	Staking resource data, see `freezeResource` object below
`triggerStatistic`	object	Required	Contract trigger statistics, see `triggerStatistic` object below
`callerAddressStatistic`	object	Required	Caller address statistics, see `callerAddressStatistic` object below
`accountList`	object	Required	Account list statistics, see `accountList` object below
`funds`	object	Required	Fund statistics, see `funds` object below
`stableCoin`	array	Required	Stablecoin list, each item see `stableCoin[]` below
`usdt`	object	Required	USDT-specific data, see `usdt` object below
`trx_volume_24h`	string	Required	24-hour TRX trading volume (unit: USD)
`trxPriceLine`	object	Required	TRX price trend data, see `trxPriceLine` object below
`tvl`	object	Required	TVL data, see `tvl` object below

tps object

Field	Type	Required	Description
`data`	object	Required	TPS data sub-object, see `tps.data`
`type`	string	Required	Data type identifier (value is `"tps"`)

tps.data object

Field	Type	Required	Description
`blockHeight`	integer	Required	Current block height
`currentTps`	integer	Required	Current TPS
`maxTps`	integer	Required	Historical max TPS

node object

Field	Type	Required	Description
`total`	integer	Required	Total node count
`code`	integer	Required	Status code (`0` = success)

statsOverview object

Field	Type	Required	Description
`success`	boolean	Required	Whether the sub-request succeeded
`data`	array	Required	Recent N-day on-chain statistics series, each item see `statsOverview.data[]`
`avg_increase_accounts`	integer	Required	Average daily new accounts
`realTimeAccountNum`	integer	Required	Real-time total account count
`avg_new_account_for_one_month`	integer	Required	Average new accounts in the past 1 month (daily)
`avg_new_account_for_one_month_rate`	number	Required	Average new account growth rate over past 1 month (decimal)
`avg_active_account_for_one_month`	integer	Required	Average active accounts in the past 1 month (daily)
`avg_active_account_for_one_month_rate`	number	Required	Average active account growth rate over past 1 month (decimal)
`new_account_for_one_month`	integer	Required	Cumulative new accounts in the past 1 month
`yesterday_total_address`	integer	Required	Cumulative total account count as of yesterday
`yesterday_total_address_rate`	number	Required	Day-over-day rate for total accounts as of yesterday (decimal)

statsOverview.data[] element

Field	Type	Required	Description	Unit/Precision
`date`	integer	Required	Day timestamp	ms
`dateDayStr`	string	Required	Day date (`YYYY-MM-DD`)	—
`totalAddress`	integer	Required	Cumulative total accounts	—
`accountWithTrx`	integer	Required	Accounts holding TRX	—
`active_account_number`	integer	Required	Active accounts on that day	—
`newAddressSeen`	integer	Required	New accounts on that day	—
`totalBlockCount`	integer	Required	Cumulative blocks	—
`newBlockSeen`	integer	Required	New blocks on that day	—
`avgBlockTime`	integer	Required	Average block time	seconds
`avgBlockSize`	integer	Required	Average block size	bytes
`blockchainSize`	integer	Required	Chain total size	bytes
`totalTransaction`	integer	Required	Cumulative transactions	—
`newTransactionSeen`	integer	Required	New transactions on that day	—
`newTrigger`	integer	Required	New contract triggers on that day	—
`triggers`	integer	Required	Cumulative contract triggers	—
`newTrc10`	integer	Required	New TRC10 tokens on that day	—
`newTrc20`	integer	Required	New TRC20 tokens on that day	—
`totalTrc10`	integer	Required	Cumulative TRC10 tokens	—
`totalTrc20`	integer	Required	Cumulative TRC20 tokens	—
`trx_transfer`	integer	Required	TRX transfers on that day	—
`trc10_transfer`	integer	Required	TRC10 transfers on that day	—
`freeze_transaction`	integer	Required	Staking transactions on that day	—
`unfreeze_transaction`	integer	Required	Unstaking transactions on that day	—
`vote_transaction`	integer	Required	Vote transactions on that day	—
`shielded_transaction`	integer	Required	Shielded transactions on that day	—
`usdt_transaction`	integer	Required	USDT transactions on that day	—
`other_transaction`	integer	Required	Other-type transactions on that day	—
`energy_usage`	integer	Required	Energy consumed on that day	sun
`net_usage`	integer	Required	Bandwidth consumed on that day	bytes

freezeResource object

Field	Type	Required	Description
`total`	integer	Required	Number of elements in `data`
`data`	array	Required	Recent N-day staking resource series, each item see `freezeResource.data[]`
`freezing_rate`	number	Required	Current staking rate (decimal)
`yesterday_freezing_rate`	number	Required	Yesterday’s staking rate (decimal)
`avg_freezing_rate_for_one_month`	number	Required	Average staking rate over past 1 month (decimal)
`freeze_rate_diff`	number	Required	Staking rate day-over-day (decimal)
`freeze1Percent`	number	Required	Stake 1.0 share (decimal)
`freeze2Percent`	number	Required	Stake 2.0 share (decimal)
`total_freeze_weight`	integer	Required	Cumulative total staked
`total_freeze_weight_change_24h`	number	Required	24h change in cumulative staked (decimal)

freezeResource.data[] element

Field	Type	Required	Description	Unit/Precision
`day`	string	Required	Date (`YYYY-MM-DD`)	—
`freeze1Balance`	integer	Required	Stake 1.0 total	TRX (integer precision)
`freeze2Balance`	integer	Required	Stake 2.0 total	TRX (integer precision)
`freeze1Percent`	number	Required	Stake 1.0 share (decimal)	—
`freeze2Percent`	number	Required	Stake 2.0 share (decimal)	—
`freezing_rate`	number	Required	Staking rate on that day (decimal)	—
`freezing_rate_change_24h`	number	Required	24h change in staking rate (decimal)	—
`total_freeze_weight`	integer	Required	Cumulative total staked	sun
`total_freeze_weight_change_24h`	number	Required	24h change in cumulative staked (decimal)	—
`total_net_weight`	integer	Required	Total staked for bandwidth	sun
`total_energy_weight`	integer	Required	Total staked for energy	sun
`net_rate`	number	Required	Bandwidth share (decimal)	—
`energy_rate`	number	Required	Energy share (decimal)	—
`total_net_cost`	number	Required	Bandwidth consumption share on that day (decimal)	—
`net_cost_change_24h`	number	Required	24h change in bandwidth consumption (decimal)	—
`total_energy_cost`	number	Required	Energy consumption share on that day (decimal)	—
`energy_cost_change_24h`	number	Required	24h change in energy consumption (decimal)	—
`total_turn_over`	string	Required	Cumulative burned on that day	TRX (integer string)
`total_turnover_change_24h`	number	Required	24h change in burned (decimal)	—

triggerStatistic object

Field	Type	Required	Description
`total`	integer	Required	Number of elements in `data`
`data`	array	Required	Recent N-day contract trigger series, each item schema same as `triggerStatistic.min`
`min`	object	Required	Minimum data point in the period, see `triggerStatistic.min`
`max`	object	Required	Maximum data point in the period, schema same as `triggerStatistic.min`
`avg_trigger_count`	string	Required	Average daily triggers in the period
`trigger_ratio`	string	Required	Trigger ratio (decimal string)

triggerStatistic.min object (max and data[] share the same schema)

Field	Type	Required	Description
`day`	integer	Required	Timestamp (unit: ms)
`dayStr`	string	Required	Date (`YYYY-MM-DD`)
`triggers_amount`	integer	Required	Contract triggers on that day
`triggers_amount_rate`	number	Required	Day-over-day trigger count (decimal)

callerAddressStatistic object

Field	Type	Required	Description
`total`	integer	Required	Number of elements in `data`
`data`	array	Required	Recent N-day caller address series, each item schema same as `callerAddressStatistic.min`
`min`	object	Required	Minimum data point in the period, see `callerAddressStatistic.min`
`max`	object	Required	Maximum data point in the period, schema same as `callerAddressStatistic.min`

callerAddressStatistic.min object (max and data[] share the same schema)

Field	Type	Required	Description
`day`	integer	Required	Timestamp (unit: ms)
`caller_amount`	integer	Required	Caller addresses on that day
`caller_amount_rate`	number	Required	Day-over-day caller address count (decimal)

accountList object

Field	Type	Required	Description
`total`	integer	Required	List theoretical total (e.g. `10000`)
`data`	array	Required	Account list (this endpoint’s default sample is empty; use dedicated account endpoints for actual data)
`rangeTotal`	integer	Required	Current total account count

funds object

Field	Type	Required	Description	Unit/Precision
`genesisBlockIssue`	number	Required	Genesis block issuance	TRX (integer precision)
`totalBlockPay`	number	Required	Cumulative block rewards	TRX (integer precision)
`totalNodePay`	number	Required	Cumulative node rewards	TRX (integer precision)
`totalTurnOver`	number	Required	Cumulative burn total	TRX (decimal)
`turnOver`	number	Required	Current cycle burn amount	TRX (decimal)
`fundTrx`	number	Required	Total TRX held by fund	TRX (decimal)
`totalFundBalance`	integer	Required	Fund balance (raw)	sun
`totalDonateBalance`	integer	Required	Donation balance (raw)	sun
`fundSumBalance`	integer	Required	Total fund balance (raw, same as `totalFundBalance`)	sun
`donateBalance`	integer	Required	Current donation balance (raw)	sun
`burnPerDay`	number	Required	Daily burn amount	TRX (integer precision)
`burnByCharge`	number	Required	Cumulative amount burned via fees	TRX (decimal)
`burnUsddByCharge`	number	Required	Cumulative amount burned via USDD fees	TRX (decimal)
`usddTrxBurnContractTransferTrx`	number	Required	USDD TRX burn contract inflow	TRX (integer precision)

stableCoin[] element

Field	Type	Required	Description	Unit/Precision
`name`	string	Required	Token name	—
`abbr`	string	Required	Token abbreviation	—
`contractAddress`	string	Required	Contract address	—
`icon`	string	Required	Token icon URL	—
`vip`	boolean	Required	Whether it is a VIP token	—
`priceInUsd`	number	Required	Current price	USD
`priceInTrx`	number	Required	Current price	TRX
`supply`	integer	Required	Total supply	raw (unit depends on token decimals)
`holders`	integer	Required	Number of holders	—
`amount24h`	number	Required	24-hour transfer amount	USD
`volumn24h`	number	Required	24-hour trading volume (DEX)	USD
`transferCount`	integer	Required	Cumulative transfer count	—
`transferCount24h`	integer	Required	24-hour transfer count	—
`liquidity`	array	Required	30-day liquidity trend (some tokens may return empty array), each item see `stableCoin[].liquidity[]`	—
`transfers`	array	Required	30-day transfer trend, each item see `stableCoin[].transfers[]`	—

stableCoin[].liquidity[] element

Field	Type	Required	Description	Unit/Precision
`date`	integer	Required	Day timestamp	ms
`day`	string	Required	Day date (`YYYY-MM-DD`)	—
`liquidity`	string	Required	Daily liquidity	raw (string, unit depends on token decimals)

stableCoin[].transfers[] element

Field	Type	Required	Description	Unit/Precision
`date`	integer	Required	Day timestamp	ms
`day`	string	Required	Day date (`YYYY-MM-DD`)	—
`amount`	number	Required	Daily transfer amount	USD
`transfer_count`	integer	Required	Daily transfer count	—

usdt object (all fields are string numbers)

Field	Type	Required	Description	Unit/Precision
`holders`	string	Required	USDT holder count	—
`holders_percent`	string	Required	USDT holders share of on-chain accounts	decimal (string)
`transfer_count`	string	Required	24h USDT transfer count	—
`transfer_count_percent`	string	Required	USDT transfer count share of all chain	decimal (string)
`transfer_amount`	string	Required	24h USDT transfer amount	USD (string)
`transfer_amount_percent`	string	Required	USDT transfer amount share of all chain	decimal (string)
`turnover`	string	Required	24h USDT turnover	USD (string)
`turnover_percent`	string	Required	USDT turnover share of all chain	decimal (string)
`active_account`	string	Required	24h USDT active accounts	—
`active_account_percent`	string	Required	USDT active accounts share of all active accounts	decimal (string)

trxPriceLine object

Field	Type	Required	Description
`total`	integer	Required	Number of elements in `data`
`data`	array	Required	TRX price series, each item see `trxPriceLine.data[]`

trxPriceLine.data[] element

Field	Type	Required	Description	Unit/Precision
`time`	string	Required	Timestamp	seconds (string)
`priceUsd`	string	Required	TRX price at that time	USD (string)

tvl object

Field	Type	Required	Description	Unit/Precision
`total`	number	Required	Total TVL	USD
`tvlLine`	array	Required	TVL trend series, each item see `tvl.tvlLine[]`	—
`projects`	array	Required	Participating project list, each item see `tvl.projects[]`	—

tvl.tvlLine[] element

Field	Type	Required	Description	Unit/Precision
`t`	string	Required	Timestamp	seconds (string)
`v`	number	Required	TVL at that time (USD)	USD
`trxV`	number	Required	TVL at that time (TRX)	TRX

tvl.projects[] element

Field	Type	Required	Description	Unit/Precision
`project`	string	Required	Project name	—
`logo`	string	Required	Project logo URL	—
`type`	string	Required	Project type (e.g. `Lending`, `Governance`, `DEX`, `Swap,Farm,Meme,Perp` and other combined labels)	—
`vip`	string	Optional	VIP identifier (`"0"` or non-zero string); some projects may lack this field	—
`locked`	number	Required	Locked amount	USD
`url`	string	Required	Project URL	—
`gain`	number	Required	TVL 24h change	decimal (e.g. `-0.0361` = -3.61%)

Example

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


{
  "tps": {
    "data": { "blockHeight": 83240530, "currentTps": 183, "maxTps": 1035 },
    "type": "tps"
  },
  "node": { "total": 8177, "code": 0 },
  "statsOverview": {
    "success": true,
    "data": [
      {
        "date": 1779062400000,
        "dateDayStr": "2026-05-18",
        "totalAddress": 382284460,
        "accountWithTrx": 232740581,
        "active_account_number": 4930180,
        "newAddressSeen": 197054,
        "totalBlockCount": 82826852,
        "newBlockSeen": 28792,
        "avgBlockTime": 3,
        "avgBlockSize": 106317,
        "blockchainSize": 3626732135127,
        "totalTransaction": 14044251816,
        "newTransactionSeen": 13097409,
        "newTrigger": 2607542,
        "triggers": 5086430948,
        "newTrc10": 1,
        "newTrc20": 24,
        "totalTrc10": 5163,
        "totalTrc20": 210346,
        "trx_transfer": 5169463,
        "trc10_transfer": 1719880,
        "freeze_transaction": 1763,
        "unfreeze_transaction": 565,
        "vote_transaction": 1810,
        "shielded_transaction": 0,
        "usdt_transaction": 2520130,
        "other_transaction": 3596386,
        "energy_usage": 215865841754,
        "net_usage": 3782991270
      }
    ],
    "avg_increase_accounts": 95297,
    "realTimeAccountNum": 384967063,
    "avg_new_account_for_one_month": 186710,
    "avg_new_account_for_one_month_rate": 0.0053,
    "avg_active_account_for_one_month": 4769102,
    "avg_active_account_for_one_month_rate": 0.0086,
    "new_account_for_one_month": 5601313,
    "yesterday_total_address": 384946324,
    "yesterday_total_address_rate": 0.0005
  },
  "freezeResource": {
    "total": 15,
    "data": [
      {
        "day": "2026-05-18",
        "freeze1Balance": 18129187952,
        "freeze2Balance": 28113768924,
        "freeze1Percent": 0.392,
        "freeze2Percent": 0.608,
        "freezing_rate": 0.4878,
        "freezing_rate_change_24h": 0.0002,
        "total_freeze_weight": 46242956876,
        "total_freeze_weight_change_24h": 0.00024,
        "total_net_weight": 26792908410,
        "total_energy_weight": 19450048466,
        "net_rate": 0.5794,
        "energy_rate": 0.4206,
        "total_net_cost": 0.6202,
        "net_cost_change_24h": 0.0,
        "total_energy_cost": 0.1081,
        "energy_cost_change_24h": 0.0009,
        "total_turn_over": "94802528195",
        "total_turnover_change_24h": 0.0
      }
    ],
    "freezing_rate": 0.49,
    "yesterday_freezing_rate": 0.49,
    "avg_freezing_rate_for_one_month": 0.4887,
    "freeze_rate_diff": 0.0,
    "freeze1Percent": 0.3901,
    "freeze2Percent": 0.6099,
    "total_freeze_weight": 46459656708,
    "total_freeze_weight_change_24h": 0.000208
  },
  "triggerStatistic": {
    "total": 15,
    "data": [
      { "day": 1779062400000, "dayStr": "2026-05-18", "triggers_amount": 2607542, "triggers_amount_rate": 0.27295902675733863 }
    ],
    "min": { "day": 1779580800000, "dayStr": "2026-05-24", "triggers_amount": 1951119, "triggers_amount_rate": -0.0622938229549544 },
    "max": { "day": 1780272000000, "dayStr": "2026-06-01", "triggers_amount": 2660416, "triggers_amount_rate": 0.3428658535354249 },
    "avg_trigger_count": "1167081",
    "trigger_ratio": "0.095"
  },
  "callerAddressStatistic": {
    "total": 15,
    "data": [
      { "day": 1779062400000, "caller_amount": 846508, "caller_amount_rate": 0.2461952025250488 }
    ],
    "min": { "day": 1779580800000, "caller_amount": 658673, "caller_amount_rate": -0.0675848225408258 },
    "max": { "day": 1780272000000, "caller_amount": 1054321, "caller_amount_rate": 0.31 }
  },
  "accountList": { "total": 10000, "data": [], "rangeTotal": 384967063 },
  "funds": {
    "genesisBlockIssue": 100000000000.0,
    "totalBlockPay": 1477951352.0,
    "totalNodePay": 10943323520.0,
    "totalTurnOver": 94816951292.22829,
    "turnOver": 62291737340.3683,
    "fundTrx": 32525213951.85998,
    "totalFundBalance": 33177933703065630,
    "totalDonateBalance": 652719751205649,
    "fundSumBalance": 33177933703065630,
    "donateBalance": 652719751205649,
    "burnPerDay": 1000000000.0,
    "burnByCharge": 16604323579.771715,
    "burnUsddByCharge": 0.423495,
    "usddTrxBurnContractTransferTrx": 10000.0
  },
  "stableCoin": [
    {
      "name": "Tether USD",
      "abbr": "USDT",
      "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "icon": "https://static.tronscan.org/production/logo/usdtlogo.png",
      "vip": true,
      "priceInUsd": 0.998042,
      "priceInTrx": 2.930972837361262,
      "supply": 89352877517,
      "holders": 74733032,
      "amount24h": 31269887170.858463,
      "volumn24h": 31208660731.778,
      "transferCount": 3415821111,
      "transferCount24h": 2639878,
      "liquidity": [{ "date": 1777766400000, "day": "2026-05-02", "liquidity": "87368062147" }],
      "transfers": [{ "date": 1777680000000, "day": "2026-05-02", "amount": 13518551023.869, "transfer_count": 2148203 }]
    }
  ],
  "usdt": {
    "holders": "74732002",
    "holders_percent": "0.012213",
    "transfer_count": "16054821",
    "transfer_count_percent": "0.016717",
    "transfer_amount": "152481849410.250641",
    "transfer_amount_percent": "0.052046",
    "turnover": "89352877517.784150",
    "turnover_percent": "0.022718",
    "active_account": "1191592",
    "active_account_percent": "0.253475"
  },
  "trx_volume_24h": "613261632.7153871",
  "trxPriceLine": {
    "total": 25,
    "data": [{ "time": "1780300800", "priceUsd": "0.3511456597483515" }]
  },
  "tvl": {
    "total": 27533743204.0,
    "tvlLine": [{ "t": "1780358400", "v": 27748289655.3905, "trxV": 15934733143.7128 }],
    "projects": [
      {
        "project": "TRX Staking",
        "logo": "https://static.tronscan.org/production/upload/logo/Staking.png",
        "type": "Governance",
        "vip": "0",
        "locked": 15825024950.63,
        "url": "https://tronscan.org/#/sr/wallet-stake-home",
        "gain": -0.031
      },
      {
        "project": "SUN.io",
        "logo": "https://static.tronscan.org/production/upload/logo/SUN.png",
        "type": "Swap,Farm,Meme,Perp",
        "locked": 318220000.0,
        "url": "https://sun.io",
        "gain": 0.012
      }
    ]
  }
}

5. Errors

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

Sub-objects may be empty: when some sub-objects return empty, the overall response still returns HTTP 200, which is a normal response.