获取 TRON 统计数据
1. 概述与典型用途
返回 TRON 每天的综合统计数据,涵盖交易、账户、资源、区块和代币等多维度指标及其环比变化率。
- 典型用途:构建综合数据仪表盘、一次请求获取所有核心指标、分析链上整体健康状况。
- 何时不要用:仅需单一维度数据时,请使用对应的专项接口(如交易趋势、活跃账户等)以减少数据传输。
2. 接口与鉴权
GET /api/stats/overview
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
days | integer | 否 | 15 | 查询天数 |
type | string | 否 | — | 控制额外返回数据类型,传 trxHolder 时额外返回持有 TRX 账户数数据 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
success | boolean | 必返 | 请求是否成功 | — |
avg_increase_accounts | integer | 必返 | 平均每日新增账户数 | — |
data | array | 必返 | 每日统计数据数组,见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | integer | 必返 | 统计日期 | 毫秒时间戳 |
dateDayStr | string | 必返 | 日期字符串 | yyyy-MM-dd |
totalTransaction | integer | 必返 | 累计总交易数 | — |
newTransactionSeen | integer | 必返 | 当日新增交易数 | — |
totalAddress | integer | 必返 | 累计总地址数 | — |
totalAddressRate | number | 必返 | 总地址数环比变化率 | 小数 |
totalAddressMom | number | 必返 | 总地址数月环比变化率(month-over-month) | 小数 |
newAddressSeen | integer | 必返 | 当日新增地址数 | — |
active_account_number | integer | 必返 | 当日活跃账户数 | — |
accountWithTrx | integer | 必返 | 持有 TRX 的账户数 | — |
avgBlockTime | integer | 必返 | 平均出块时间 | 秒 |
avgBlockSize | integer | 必返 | 平均区块大小 | 字节 |
totalBlockCount | integer | 必返 | 累计区块数 | — |
newBlockSeen | integer | 必返 | 当日新增区块数 | — |
blockchainSize | integer | 必返 | 累计区块链数据大小 | 字节 |
triggers | integer | 必返 | 累计合约触发数 | — |
newTrigger | integer | 必返 | 当日合约触发数 | — |
trx_transfer | integer | 必返 | 当日 TRX 转账数 | — |
trc10_transfer | integer | 必返 | 当日 TRC10 转账数 | — |
usdt_transaction | integer | 必返 | 当日 USDT 交易数 | — |
freeze_transaction | integer | 必返 | 当日质押类交易数 | — |
unfreeze_transaction | integer | 必返 | 当日解质押类交易数 | — |
vote_transaction | integer | 必返 | 当日投票类交易数 | — |
shielded_transaction | integer | 必返 | 当日隐私交易数 | — |
other_transaction | integer | 必返 | 当日其他类型交易数 | — |
energy_usage | integer | 必返 | 当日能量消耗 | — |
net_usage | integer | 必返 | 当日带宽消耗 | — |
energy_usage_change_24h | number | 必返 | 能量消耗 24h 变化率 | 小数 |
net_usage_change_24h | number | 必返 | 带宽消耗 24h 变化率 | 小数 |
active_account_number_rate | number | 必返 | 活跃账户数环比变化率 | 小数 |
newAddressSeenRate | number | 必返 | 新增地址数环比变化率 | 小数 |
totalTrc20 | integer | 必返 | TRC20 代币总数 | — |
newTrc20 | integer | 必返 | 当日新增 TRC20 代币数 | — |
totalTrc10 | integer | 必返 | TRC10 代币总数 | — |
newTrc10 | integer | 必返 | 当日新增 TRC10 代币数 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 空结果不是错误:无数据返回
200+data: [],属于正常响应。
最后更新于: