Skip to Content
API首页与搜索获取 TRONSCAN 首页数据

获取 TRONSCAN 首页数据

1. 概述与典型用途

一次请求获取 TRONSCAN 首页所需的全部聚合数据,包括 TPS、节点数、统计概览、质押率、合约触发、稳定币和 TVL 等。

  • 典型用途:首页一次性渲染所有核心指标、减少多接口并发请求。
  • 何时不要用:仅需单一维度数据时,请使用对应的专项接口。
  • 各子对象可能返回空,但整体仍返回 HTTP 200。

2. 接口与鉴权

GET /api/system/homepage-bundle

Base URL 与鉴权见 公共网络与鉴权说明

3. 请求

参数类型必填默认说明
sourcestringcoinmarketcapTRX 价格数据来源:coinmarketcapcoingecko

4. 响应

顶层字段

字段类型是否必返说明
tpsobject必返TPS 数据,见下 tps 对象
nodeobject必返节点统计,见下 node 对象
statsOverviewobject必返链上统计概览,见下 statsOverview 对象
freezeResourceobject必返质押资源数据,见下 freezeResource 对象
triggerStatisticobject必返合约触发统计,见下 triggerStatistic 对象
callerAddressStatisticobject必返调用地址统计,见下 callerAddressStatistic 对象
accountListobject必返账户列表统计,见下 accountList 对象
fundsobject必返资金统计,见下 funds 对象
stableCoinarray必返稳定币列表,每项见下 stableCoin[]
usdtobject必返USDT 专项数据,见下 usdt 对象
trx_volume_24hstring必返TRX 24 小时成交额(单位:USD)
trxPriceLineobject必返TRX 价格趋势数据,见下 trxPriceLine 对象
tvlobject必返TVL 数据,见下 tvl 对象

tps 对象

字段类型是否必返说明
dataobject必返TPS 数据子对象,见 tps.data
typestring必返数据类型标识(值为 "tps"

tps.data 对象

字段类型是否必返说明
blockHeightinteger必返当前区块高度
currentTpsinteger必返当前 TPS
maxTpsinteger必返历史最大 TPS

node 对象

字段类型是否必返说明
totalinteger必返节点总数
codeinteger必返状态码(0 表示成功)

statsOverview 对象

字段类型是否必返说明
successboolean必返子请求是否成功
dataarray必返最近 N 日链上统计序列,每项见 statsOverview.data[]
avg_increase_accountsinteger必返平均日均新增账户数
realTimeAccountNuminteger必返实时账户总数
avg_new_account_for_one_monthinteger必返近 1 月平均新增账户数(日均)
avg_new_account_for_one_month_ratenumber必返近 1 月平均新增账户增长率(小数)
avg_active_account_for_one_monthinteger必返近 1 月平均活跃账户数(日均)
avg_active_account_for_one_month_ratenumber必返近 1 月平均活跃账户增长率(小数)
new_account_for_one_monthinteger必返近 1 月新增账户累计
yesterday_total_addressinteger必返昨日累计账户总数
yesterday_total_address_ratenumber必返昨日总账户日环比(小数)

statsOverview.data[] 元素

字段类型是否必返说明单位/精度
dateinteger必返当日时间戳ms
dateDayStrstring必返当日日期(YYYY-MM-DD
totalAddressinteger必返累计账户总数
accountWithTrxinteger必返持有 TRX 的账户数
active_account_numberinteger必返当日活跃账户数
newAddressSeeninteger必返当日新增账户数
totalBlockCountinteger必返累计区块数
newBlockSeeninteger必返当日新出区块数
avgBlockTimeinteger必返平均出块时间
avgBlockSizeinteger必返平均区块大小字节
blockchainSizeinteger必返链总大小字节
totalTransactioninteger必返累计交易数
newTransactionSeeninteger必返当日新增交易数
newTriggerinteger必返当日合约触发数
triggersinteger必返累计合约触发数
newTrc10integer必返当日新增 TRC10 代币数
newTrc20integer必返当日新增 TRC20 代币数
totalTrc10integer必返累计 TRC10 代币数
totalTrc20integer必返累计 TRC20 代币数
trx_transferinteger必返当日 TRX 转账数
trc10_transferinteger必返当日 TRC10 转账数
freeze_transactioninteger必返当日质押交易数
unfreeze_transactioninteger必返当日解押交易数
vote_transactioninteger必返当日投票交易数
shielded_transactioninteger必返当日匿名交易数
usdt_transactioninteger必返当日 USDT 交易数
other_transactioninteger必返当日其他类型交易数
energy_usageinteger必返当日 energy 消耗sun
net_usageinteger必返当日带宽消耗字节

freezeResource 对象

字段类型是否必返说明
totalinteger必返data 数组元素数
dataarray必返最近 N 日质押资源序列,每项见 freezeResource.data[]
freezing_ratenumber必返当前质押率(小数)
yesterday_freezing_ratenumber必返昨日质押率(小数)
avg_freezing_rate_for_one_monthnumber必返近 1 月平均质押率(小数)
freeze_rate_diffnumber必返质押率日环比(小数)
freeze1Percentnumber必返Stake 1.0 占比(小数)
freeze2Percentnumber必返Stake 2.0 占比(小数)
total_freeze_weightinteger必返累计质押总量
total_freeze_weight_change_24hnumber必返累计质押 24h 变化(小数)

freezeResource.data[] 元素

字段类型是否必返说明单位/精度
daystring必返日期(YYYY-MM-DD
freeze1Balanceinteger必返Stake 1.0 总量TRX(整数精度)
freeze2Balanceinteger必返Stake 2.0 总量TRX(整数精度)
freeze1Percentnumber必返Stake 1.0 占比(小数)
freeze2Percentnumber必返Stake 2.0 占比(小数)
freezing_ratenumber必返当日质押率(小数)
freezing_rate_change_24hnumber必返质押率 24h 变化(小数)
total_freeze_weightinteger必返累计质押总量sun
total_freeze_weight_change_24hnumber必返累计质押 24h 变化(小数)
total_net_weightinteger必返用于带宽的质押总量sun
total_energy_weightinteger必返用于 energy 的质押总量sun
net_ratenumber必返带宽占比(小数)
energy_ratenumber必返energy 占比(小数)
total_net_costnumber必返当日带宽消耗占比(小数)
net_cost_change_24hnumber必返带宽消耗 24h 变化(小数)
total_energy_costnumber必返当日 energy 消耗占比(小数)
energy_cost_change_24hnumber必返energy 消耗 24h 变化(小数)
total_turn_overstring必返当日累计销毁量TRX(整数字符串)
total_turnover_change_24hnumber必返销毁量 24h 变化(小数)

triggerStatistic 对象

字段类型是否必返说明
totalinteger必返data 数组元素数
dataarray必返最近 N 日合约触发序列,每项 schema 同 triggerStatistic.min
minobject必返周期内最低值数据点,见 triggerStatistic.min
maxobject必返周期内最高值数据点,schema 同 triggerStatistic.min
avg_trigger_countstring必返周期内日均触发数
trigger_ratiostring必返触发率(小数字符串)

triggerStatistic.min 对象(maxdata[] 同 schema)

字段类型是否必返说明
dayinteger必返时间戳(单位:ms)
dayStrstring必返日期(YYYY-MM-DD
triggers_amountinteger必返当日合约触发数
triggers_amount_ratenumber必返触发数日环比(小数)

callerAddressStatistic 对象

字段类型是否必返说明
totalinteger必返data 数组元素数
dataarray必返最近 N 日调用地址序列,每项 schema 同 callerAddressStatistic.min
minobject必返周期内最低值数据点,见 callerAddressStatistic.min
maxobject必返周期内最高值数据点,schema 同 callerAddressStatistic.min

callerAddressStatistic.min 对象(maxdata[] 同 schema)

字段类型是否必返说明
dayinteger必返时间戳(单位:ms)
caller_amountinteger必返当日调用地址数
caller_amount_ratenumber必返调用地址日环比(小数)

accountList 对象

字段类型是否必返说明
totalinteger必返列表理论总数(如 10000
dataarray必返账户列表(本接口默认采样为空数组;具体数据请用专项账户接口)
rangeTotalinteger必返当前账户总数

funds 对象

字段类型是否必返说明单位/精度
genesisBlockIssuenumber必返创世区块发行量TRX(整数精度)
totalBlockPaynumber必返累计出块奖励TRX(整数精度)
totalNodePaynumber必返累计节点奖励TRX(整数精度)
totalTurnOvernumber必返累计销毁总量TRX(小数)
turnOvernumber必返当前周期销毁量TRX(小数)
fundTrxnumber必返基金持有 TRX 总量TRX(小数)
totalFundBalanceinteger必返基金余额(原始)sun
totalDonateBalanceinteger必返捐赠余额(原始)sun
fundSumBalanceinteger必返基金总余额(原始,同 totalFundBalancesun
donateBalanceinteger必返当前捐赠余额(原始)sun
burnPerDaynumber必返每日销毁量TRX(整数精度)
burnByChargenumber必返通过手续费销毁的累计量TRX(小数)
burnUsddByChargenumber必返通过 USDD 手续费销毁的累计量TRX(小数)
usddTrxBurnContractTransferTrxnumber必返USDD TRX 销毁合约转入量TRX(整数精度)

stableCoin[] 元素

字段类型是否必返说明单位/精度
namestring必返代币名称
abbrstring必返代币简称
contractAddressstring必返合约地址
iconstring必返代币图标 URL
vipboolean必返是否为 VIP 代币
priceInUsdnumber必返当前价格USD
priceInTrxnumber必返当前价格TRX
supplyinteger必返总供应量raw(单位依代币 decimals)
holdersinteger必返持有者数量
amount24hnumber必返24 小时转账金额USD
volumn24hnumber必返24 小时成交量(DEX)USD
transferCountinteger必返累计转账次数
transferCount24hinteger必返24 小时转账次数
liquidityarray必返近 30 日流动性趋势(部分代币可能返回空数组),每项见 stableCoin[].liquidity[]
transfersarray必返近 30 日转账趋势,每项见 stableCoin[].transfers[]

stableCoin[].liquidity[] 元素

字段类型是否必返说明单位/精度
dateinteger必返当日时间戳ms
daystring必返当日日期(YYYY-MM-DD
liquiditystring必返当日流动性raw(字符串,单位依代币 decimals)

stableCoin[].transfers[] 元素

字段类型是否必返说明单位/精度
dateinteger必返当日时间戳ms
daystring必返当日日期(YYYY-MM-DD
amountnumber必返当日转账金额USD
transfer_countinteger必返当日转账次数

usdt 对象(所有字段为字符串数字)

字段类型是否必返说明单位/精度
holdersstring必返USDT 持有者数
holders_percentstring必返USDT 持有者占链上账户比小数(字符串)
transfer_countstring必返24h USDT 转账次数
transfer_count_percentstring必返USDT 转账次数占全链比小数(字符串)
transfer_amountstring必返24h USDT 转账金额USD(字符串)
transfer_amount_percentstring必返USDT 转账金额占全链比小数(字符串)
turnoverstring必返24h USDT 周转量USD(字符串)
turnover_percentstring必返USDT 周转占全链比小数(字符串)
active_accountstring必返24h USDT 活跃账户
active_account_percentstring必返USDT 活跃账户占全链活跃比小数(字符串)

trxPriceLine 对象

字段类型是否必返说明
totalinteger必返data 数组元素数
dataarray必返TRX 价格序列,每项见 trxPriceLine.data[]

trxPriceLine.data[] 元素

字段类型是否必返说明单位/精度
timestring必返时间戳秒(字符串)
priceUsdstring必返TRX 当时价格USD(字符串)

tvl 对象

字段类型是否必返说明单位/精度
totalnumber必返TVL 总量USD
tvlLinearray必返TVL 趋势序列,每项见 tvl.tvlLine[]
projectsarray必返参与项目列表,每项见 tvl.projects[]

tvl.tvlLine[] 元素

字段类型是否必返说明单位/精度
tstring必返时间戳秒(字符串)
vnumber必返当时 TVL(USD)USD
trxVnumber必返当时 TVL(TRX)TRX

tvl.projects[] 元素

字段类型是否必返说明单位/精度
projectstring必返项目名称
logostring必返项目 Logo URL
typestring必返项目类型(如 LendingGovernanceDEXSwap,Farm,Meme,Perp 等组合标签)
vipstring可选VIP 标识("0" 或非零字符串);部分项目可能无此字段
lockednumber必返锁仓量USD
urlstring必返项目 URL
gainnumber必返TVL 24h 涨跌幅小数(如 -0.0361 = -3.61%)

5. 错误

HTTP 状态码见 公共错误说明。本接口要点:

  • 各子对象可能为空:部分子对象返回空时,整体响应仍为 HTTP 200,属于正常响应。
最后更新于: