获取 TRONSCAN 首页数据
1. 概述与典型用途
一次请求获取 TRONSCAN 首页所需的全部聚合数据,包括 TPS、节点数、统计概览、质押率、合约触发、稳定币和 TVL 等。
- 典型用途:首页一次性渲染所有核心指标、减少多接口并发请求。
- 何时不要用:仅需单一维度数据时,请使用对应的专项接口。
- 各子对象可能返回空,但整体仍返回 HTTP 200。
2. 接口与鉴权
GET /api/system/homepage-bundle
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
source | string | 否 | coinmarketcap | TRX 价格数据来源:coinmarketcap 或 coingecko |
4. 响应
字段
顶层字段
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
tps | object | 必返 | TPS 数据,见下 tps 对象 |
node | object | 必返 | 节点统计,见下 node 对象 |
statsOverview | object | 必返 | 链上统计概览,见下 statsOverview 对象 |
freezeResource | object | 必返 | 质押资源数据,见下 freezeResource 对象 |
triggerStatistic | object | 必返 | 合约触发统计,见下 triggerStatistic 对象 |
callerAddressStatistic | object | 必返 | 调用地址统计,见下 callerAddressStatistic 对象 |
accountList | object | 必返 | 账户列表统计,见下 accountList 对象 |
funds | object | 必返 | 资金统计,见下 funds 对象 |
stableCoin | array | 必返 | 稳定币列表,每项见下 stableCoin[] |
usdt | object | 必返 | USDT 专项数据,见下 usdt 对象 |
trx_volume_24h | string | 必返 | TRX 24 小时成交额(单位:USD) |
trxPriceLine | object | 必返 | TRX 价格趋势数据,见下 trxPriceLine 对象 |
tvl | object | 必返 | TVL 数据,见下 tvl 对象 |
tps 对象
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
data | object | 必返 | TPS 数据子对象,见 tps.data |
type | string | 必返 | 数据类型标识(值为 "tps") |
tps.data 对象
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
blockHeight | integer | 必返 | 当前区块高度 |
currentTps | integer | 必返 | 当前 TPS |
maxTps | integer | 必返 | 历史最大 TPS |
node 对象
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
total | integer | 必返 | 节点总数 |
code | integer | 必返 | 状态码(0 表示成功) |
statsOverview 对象
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
success | boolean | 必返 | 子请求是否成功 |
data | array | 必返 | 最近 N 日链上统计序列,每项见 statsOverview.data[] |
avg_increase_accounts | integer | 必返 | 平均日均新增账户数 |
realTimeAccountNum | integer | 必返 | 实时账户总数 |
avg_new_account_for_one_month | integer | 必返 | 近 1 月平均新增账户数(日均) |
avg_new_account_for_one_month_rate | number | 必返 | 近 1 月平均新增账户增长率(小数) |
avg_active_account_for_one_month | integer | 必返 | 近 1 月平均活跃账户数(日均) |
avg_active_account_for_one_month_rate | number | 必返 | 近 1 月平均活跃账户增长率(小数) |
new_account_for_one_month | integer | 必返 | 近 1 月新增账户累计 |
yesterday_total_address | integer | 必返 | 昨日累计账户总数 |
yesterday_total_address_rate | number | 必返 | 昨日总账户日环比(小数) |
statsOverview.data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | integer | 必返 | 当日时间戳 | ms |
dateDayStr | string | 必返 | 当日日期(YYYY-MM-DD) | — |
totalAddress | integer | 必返 | 累计账户总数 | — |
accountWithTrx | integer | 必返 | 持有 TRX 的账户数 | — |
active_account_number | integer | 必返 | 当日活跃账户数 | — |
newAddressSeen | integer | 必返 | 当日新增账户数 | — |
totalBlockCount | integer | 必返 | 累计区块数 | — |
newBlockSeen | integer | 必返 | 当日新出区块数 | — |
avgBlockTime | integer | 必返 | 平均出块时间 | 秒 |
avgBlockSize | integer | 必返 | 平均区块大小 | 字节 |
blockchainSize | integer | 必返 | 链总大小 | 字节 |
totalTransaction | integer | 必返 | 累计交易数 | — |
newTransactionSeen | integer | 必返 | 当日新增交易数 | — |
newTrigger | integer | 必返 | 当日合约触发数 | — |
triggers | integer | 必返 | 累计合约触发数 | — |
newTrc10 | integer | 必返 | 当日新增 TRC10 代币数 | — |
newTrc20 | integer | 必返 | 当日新增 TRC20 代币数 | — |
totalTrc10 | integer | 必返 | 累计 TRC10 代币数 | — |
totalTrc20 | integer | 必返 | 累计 TRC20 代币数 | — |
trx_transfer | integer | 必返 | 当日 TRX 转账数 | — |
trc10_transfer | integer | 必返 | 当日 TRC10 转账数 | — |
freeze_transaction | integer | 必返 | 当日质押交易数 | — |
unfreeze_transaction | integer | 必返 | 当日解押交易数 | — |
vote_transaction | integer | 必返 | 当日投票交易数 | — |
shielded_transaction | integer | 必返 | 当日匿名交易数 | — |
usdt_transaction | integer | 必返 | 当日 USDT 交易数 | — |
other_transaction | integer | 必返 | 当日其他类型交易数 | — |
energy_usage | integer | 必返 | 当日 energy 消耗 | sun |
net_usage | integer | 必返 | 当日带宽消耗 | 字节 |
freezeResource 对象
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
total | integer | 必返 | data 数组元素数 |
data | array | 必返 | 最近 N 日质押资源序列,每项见 freezeResource.data[] |
freezing_rate | number | 必返 | 当前质押率(小数) |
yesterday_freezing_rate | number | 必返 | 昨日质押率(小数) |
avg_freezing_rate_for_one_month | number | 必返 | 近 1 月平均质押率(小数) |
freeze_rate_diff | number | 必返 | 质押率日环比(小数) |
freeze1Percent | number | 必返 | Stake 1.0 占比(小数) |
freeze2Percent | number | 必返 | Stake 2.0 占比(小数) |
total_freeze_weight | integer | 必返 | 累计质押总量 |
total_freeze_weight_change_24h | number | 必返 | 累计质押 24h 变化(小数) |
freezeResource.data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 日期(YYYY-MM-DD) | — |
freeze1Balance | integer | 必返 | Stake 1.0 总量 | TRX(整数精度) |
freeze2Balance | integer | 必返 | Stake 2.0 总量 | TRX(整数精度) |
freeze1Percent | number | 必返 | Stake 1.0 占比(小数) | — |
freeze2Percent | number | 必返 | Stake 2.0 占比(小数) | — |
freezing_rate | number | 必返 | 当日质押率(小数) | — |
freezing_rate_change_24h | number | 必返 | 质押率 24h 变化(小数) | — |
total_freeze_weight | integer | 必返 | 累计质押总量 | sun |
total_freeze_weight_change_24h | number | 必返 | 累计质押 24h 变化(小数) | — |
total_net_weight | integer | 必返 | 用于带宽的质押总量 | sun |
total_energy_weight | integer | 必返 | 用于 energy 的质押总量 | sun |
net_rate | number | 必返 | 带宽占比(小数) | — |
energy_rate | number | 必返 | energy 占比(小数) | — |
total_net_cost | number | 必返 | 当日带宽消耗占比(小数) | — |
net_cost_change_24h | number | 必返 | 带宽消耗 24h 变化(小数) | — |
total_energy_cost | number | 必返 | 当日 energy 消耗占比(小数) | — |
energy_cost_change_24h | number | 必返 | energy 消耗 24h 变化(小数) | — |
total_turn_over | string | 必返 | 当日累计销毁量 | TRX(整数字符串) |
total_turnover_change_24h | number | 必返 | 销毁量 24h 变化(小数) | — |
triggerStatistic 对象
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
total | integer | 必返 | data 数组元素数 |
data | array | 必返 | 最近 N 日合约触发序列,每项 schema 同 triggerStatistic.min |
min | object | 必返 | 周期内最低值数据点,见 triggerStatistic.min |
max | object | 必返 | 周期内最高值数据点,schema 同 triggerStatistic.min |
avg_trigger_count | string | 必返 | 周期内日均触发数 |
trigger_ratio | string | 必返 | 触发率(小数字符串) |
triggerStatistic.min 对象(max 与 data[] 同 schema)
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
day | integer | 必返 | 时间戳(单位:ms) |
dayStr | string | 必返 | 日期(YYYY-MM-DD) |
triggers_amount | integer | 必返 | 当日合约触发数 |
triggers_amount_rate | number | 必返 | 触发数日环比(小数) |
callerAddressStatistic 对象
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
total | integer | 必返 | data 数组元素数 |
data | array | 必返 | 最近 N 日调用地址序列,每项 schema 同 callerAddressStatistic.min |
min | object | 必返 | 周期内最低值数据点,见 callerAddressStatistic.min |
max | object | 必返 | 周期内最高值数据点,schema 同 callerAddressStatistic.min |
callerAddressStatistic.min 对象(max 与 data[] 同 schema)
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
day | integer | 必返 | 时间戳(单位:ms) |
caller_amount | integer | 必返 | 当日调用地址数 |
caller_amount_rate | number | 必返 | 调用地址日环比(小数) |
accountList 对象
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
total | integer | 必返 | 列表理论总数(如 10000) |
data | array | 必返 | 账户列表(本接口默认采样为空数组;具体数据请用专项账户接口) |
rangeTotal | integer | 必返 | 当前账户总数 |
funds 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
genesisBlockIssue | number | 必返 | 创世区块发行量 | TRX(整数精度) |
totalBlockPay | number | 必返 | 累计出块奖励 | TRX(整数精度) |
totalNodePay | number | 必返 | 累计节点奖励 | TRX(整数精度) |
totalTurnOver | number | 必返 | 累计销毁总量 | TRX(小数) |
turnOver | number | 必返 | 当前周期销毁量 | TRX(小数) |
fundTrx | number | 必返 | 基金持有 TRX 总量 | TRX(小数) |
totalFundBalance | integer | 必返 | 基金余额(原始) | sun |
totalDonateBalance | integer | 必返 | 捐赠余额(原始) | sun |
fundSumBalance | integer | 必返 | 基金总余额(原始,同 totalFundBalance) | sun |
donateBalance | integer | 必返 | 当前捐赠余额(原始) | sun |
burnPerDay | number | 必返 | 每日销毁量 | TRX(整数精度) |
burnByCharge | number | 必返 | 通过手续费销毁的累计量 | TRX(小数) |
burnUsddByCharge | number | 必返 | 通过 USDD 手续费销毁的累计量 | TRX(小数) |
usddTrxBurnContractTransferTrx | number | 必返 | USDD TRX 销毁合约转入量 | TRX(整数精度) |
stableCoin[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
name | string | 必返 | 代币名称 | — |
abbr | string | 必返 | 代币简称 | — |
contractAddress | string | 必返 | 合约地址 | — |
icon | string | 必返 | 代币图标 URL | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
priceInUsd | number | 必返 | 当前价格 | USD |
priceInTrx | number | 必返 | 当前价格 | TRX |
supply | integer | 必返 | 总供应量 | raw(单位依代币 decimals) |
holders | integer | 必返 | 持有者数量 | — |
amount24h | number | 必返 | 24 小时转账金额 | USD |
volumn24h | number | 必返 | 24 小时成交量(DEX) | USD |
transferCount | integer | 必返 | 累计转账次数 | — |
transferCount24h | integer | 必返 | 24 小时转账次数 | — |
liquidity | array | 必返 | 近 30 日流动性趋势(部分代币可能返回空数组),每项见 stableCoin[].liquidity[] | — |
transfers | array | 必返 | 近 30 日转账趋势,每项见 stableCoin[].transfers[] | — |
stableCoin[].liquidity[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | integer | 必返 | 当日时间戳 | ms |
day | string | 必返 | 当日日期(YYYY-MM-DD) | — |
liquidity | string | 必返 | 当日流动性 | raw(字符串,单位依代币 decimals) |
stableCoin[].transfers[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | integer | 必返 | 当日时间戳 | ms |
day | string | 必返 | 当日日期(YYYY-MM-DD) | — |
amount | number | 必返 | 当日转账金额 | USD |
transfer_count | integer | 必返 | 当日转账次数 | — |
usdt 对象(所有字段为字符串数字)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
holders | string | 必返 | USDT 持有者数 | — |
holders_percent | string | 必返 | USDT 持有者占链上账户比 | 小数(字符串) |
transfer_count | string | 必返 | 24h USDT 转账次数 | — |
transfer_count_percent | string | 必返 | USDT 转账次数占全链比 | 小数(字符串) |
transfer_amount | string | 必返 | 24h USDT 转账金额 | USD(字符串) |
transfer_amount_percent | string | 必返 | USDT 转账金额占全链比 | 小数(字符串) |
turnover | string | 必返 | 24h USDT 周转量 | USD(字符串) |
turnover_percent | string | 必返 | USDT 周转占全链比 | 小数(字符串) |
active_account | string | 必返 | 24h USDT 活跃账户 | — |
active_account_percent | string | 必返 | USDT 活跃账户占全链活跃比 | 小数(字符串) |
trxPriceLine 对象
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
total | integer | 必返 | data 数组元素数 |
data | array | 必返 | TRX 价格序列,每项见 trxPriceLine.data[] |
trxPriceLine.data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
time | string | 必返 | 时间戳 | 秒(字符串) |
priceUsd | string | 必返 | TRX 当时价格 | USD(字符串) |
tvl 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | number | 必返 | TVL 总量 | USD |
tvlLine | array | 必返 | TVL 趋势序列,每项见 tvl.tvlLine[] | — |
projects | array | 必返 | 参与项目列表,每项见 tvl.projects[] | — |
tvl.tvlLine[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
t | string | 必返 | 时间戳 | 秒(字符串) |
v | number | 必返 | 当时 TVL(USD) | USD |
trxV | number | 必返 | 当时 TVL(TRX) | TRX |
tvl.projects[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
project | string | 必返 | 项目名称 | — |
logo | string | 必返 | 项目 Logo URL | — |
type | string | 必返 | 项目类型(如 Lending、Governance、DEX、Swap,Farm,Meme,Perp 等组合标签) | — |
vip | string | 可选 | VIP 标识("0" 或非零字符串);部分项目可能无此字段 | — |
locked | number | 必返 | 锁仓量 | USD |
url | string | 必返 | 项目 URL | — |
gain | number | 必返 | TVL 24h 涨跌幅 | 小数(如 -0.0361 = -3.61%) |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 各子对象可能为空:部分子对象返回空时,整体响应仍为 HTTP 200,属于正常响应。
最后更新于: