获取 Top 10 统计数据

1. 概述与典型用途

返回 Top 统计数据，包括总览、账户、代币、合约及资源维度。

典型用途：展示各维度排行榜数据、首页 Top N 组件渲染。
何时不要用：查看单个合约调用详情用「获取合约调用统计数据」。

2. 接口与鉴权

GET /api/top10

3. 请求

字段

参数	类型	必填	默认	说明
`time`	integer	否	`1`	时间类型。`0`：实时，`1`：最近一小时，`2`：最近 24 小时，`3`：上周，`4`：最近 3 天
`type`	string	否	`0`	统计数据类型，取值范围 `0`–`20`；多个非零类型可用逗号分隔（如 `1,2,17`）。`0`：总览；`1`：TRX 发送总量最多的账户；`2`：TRX 发送交易次数最多的账户；`3`：TRX 接收总量最多的账户；`4`：TRX 接收交易次数最多的账户；`5`：冻结 TRX 最多的账户；`6`：投票最多的账户；`7`：持有者最多的代币；`8`：交易账户最多的代币；`9`：总交易次数最多的代币；`10`：总交易额最多的代币；`11`：TRX 余额最多的合约；`12`：调用账户最多的合约；`13`：调用次数最多的合约；`14`：能量消耗最多的账户；`15`：带宽消耗最多的账户；`16`：能量消耗最多的合约；`17`：手续费消耗最多的合约；`18`：热门代币；`19`：热门合约；`20`：账户手续费使用情况

4. 响应

字段

type=0 时（总览）

顶层字段（所有字段类型均为 string，除 start_time/end_time 为 integer）：

字段	类型	是否必返	说明	单位/精度
`token_record`	string	必返	上线代币总数（含未激活）	—
`trc20_record`	string	必返	TRC20 代币上线总数	—
`trc10_record`	string	必返	TRC10 代币上线总数	—
`token_all`	string	必返	当前存活代币总数	—
`trc20_all`	string	必返	当前存活 TRC20 代币数	—
`trc10_all`	string	必返	当前存活 TRC10 代币数	—
`whole_vote`	string	必返	全网投票总量	—
`whole_freeze`	string	必返	全网冻结 TRX 总量	TRX
`contract_whole_balance`	string	必返	合约 TRX 余额总量	TRX
`start_time`	integer	必返	统计起始时间	毫秒时间戳
`end_time`	integer	必返	统计结束时间	毫秒时间戳
`last_hour_contract_active_address`	string	必返	最近一小时合约活跃地址数	—
`last_hour_contract_triggers`	string	必返	最近一小时合约触发次数	—
`last_hour_energy_usage`	string	必返	最近一小时能量使用量	—
`last_hour_net_usage`	string	必返	最近一小时带宽使用量	—
`last_hour_token10_active_address`	string	必返	最近一小时 TRC10 活跃地址数	—
`last_hour_token10_sum_transaction`	string	必返	最近一小时 TRC10 交易次数	—
`last_hour_token10_sum_transaction_amount`	string	必返	最近一小时 TRC10 交易总额	—
`last_hour_token20_active_address`	string	必返	最近一小时 TRC20 活跃地址数	—
`last_hour_token20_sum_transaction`	string	必返	最近一小时 TRC20 交易次数	—
`last_hour_token20_sum_transaction_amount`	string	必返	最近一小时 TRC20 交易总额	—
`last_hour_trx_transaction_number`	string	必返	最近一小时 TRX 交易次数	—
`last_hour_trx_transfer_amount`	string	必返	最近一小时 TRX 转账总额	TRX
`last_hour_whole_contract_use`	string	必返	最近一小时合约资源使用量	—
`last_hour_whole_energy_burn`	string	必返	最近一小时能量燃烧量	—
`last_hour_whole_energy_use`	string	必返	最近一小时能量使用量（全网）	—
`last_hour_whole_fee_burn`	string	必返	最近一小时手续费燃烧量	sun
`last_hour_whole_net_burn`	string	必返	最近一小时带宽燃烧量	—
`last_hour_whole_net_use`	string	必返	最近一小时带宽使用量（全网）	—
`last_day_contract_active_address`	string	必返	最近 24 小时合约活跃地址数	—
`last_day_contract_triggers`	string	必返	最近 24 小时合约触发次数	—
`last_day_energy_usage`	string	必返	最近 24 小时能量使用量	—
`last_day_net_usage`	string	必返	最近 24 小时带宽使用量	—
`last_day_token10_active_address`	string	必返	最近 24 小时 TRC10 活跃地址数	—
`last_day_token10_sum_transaction`	string	必返	最近 24 小时 TRC10 交易次数	—
`last_day_token10_sum_transaction_amount`	string	必返	最近 24 小时 TRC10 交易总额	—
`last_day_token20_active_address`	string	必返	最近 24 小时 TRC20 活跃地址数	—
`last_day_token20_sum_transaction`	string	必返	最近 24 小时 TRC20 交易次数	—
`last_day_token20_sum_transaction_amount`	string	必返	最近 24 小时 TRC20 交易总额	—
`last_day_trx_transaction_number`	string	必返	最近 24 小时 TRX 交易次数	—
`last_day_trx_transfer_amount`	string	必返	最近 24 小时 TRX 转账总额	TRX
`last_day_whole_contract_use`	string	必返	最近 24 小时合约资源使用量	—
`last_day_whole_energy_burn`	string	必返	最近 24 小时能量燃烧量	—
`last_day_whole_energy_use`	string	必返	最近 24 小时能量使用量（全网）	—
`last_day_whole_fee_burn`	string	必返	最近 24 小时手续费燃烧量	sun
`last_day_whole_net_burn`	string	必返	最近 24 小时带宽燃烧量	—
`last_day_whole_net_use`	string	必返	最近 24 小时带宽使用量（全网）	—
`last_three_day_contract_active_address`	string	必返	最近 3 天合约活跃地址数	—
`last_three_day_contract_triggers`	string	必返	最近 3 天合约触发次数	—
`last_three_day_energy_usage`	string	必返	最近 3 天能量使用量	—
`last_three_day_net_usage`	string	必返	最近 3 天带宽使用量	—
`last_three_day_token10_active_address`	string	必返	最近 3 天 TRC10 活跃地址数	—
`last_three_day_token10_sum_transaction`	string	必返	最近 3 天 TRC10 交易次数	—
`last_three_day_token10_sum_transaction_amount`	string	必返	最近 3 天 TRC10 交易总额	—
`last_three_day_token20_active_address`	string	必返	最近 3 天 TRC20 活跃地址数	—
`last_three_day_token20_sum_transaction`	string	必返	最近 3 天 TRC20 交易次数	—
`last_three_day_token20_sum_transaction_amount`	string	必返	最近 3 天 TRC20 交易总额	—
`last_three_day_trx_transaction_number`	string	必返	最近 3 天 TRX 交易次数	—
`last_three_day_trx_transfer_amount`	string	必返	最近 3 天 TRX 转账总额	TRX
`last_three_day_whole_contract_use`	string	必返	最近 3 天合约资源使用量	—
`last_three_day_whole_energy_burn`	string	必返	最近 3 天能量燃烧量	—
`last_three_day_whole_energy_use`	string	必返	最近 3 天能量使用量（全网）	—
`last_three_day_whole_fee_burn`	string	必返	最近 3 天手续费燃烧量	sun
`last_three_day_whole_net_burn`	string	必返	最近 3 天带宽燃烧量	—
`last_three_day_whole_net_use`	string	必返	最近 3 天带宽使用量（全网）	—
`last_week_contract_active_address`	string	必返	最近一周合约活跃地址数	—
`last_week_contract_triggers`	string	必返	最近一周合约触发次数	—
`last_week_energy_usage`	string	必返	最近一周能量使用量	—
`last_week_net_usage`	string	必返	最近一周带宽使用量	—
`last_week_token10_active_address`	string	必返	最近一周 TRC10 活跃地址数	—
`last_week_token10_sum_transaction`	string	必返	最近一周 TRC10 交易次数	—
`last_week_token10_sum_transaction_amount`	string	必返	最近一周 TRC10 交易总额	—
`last_week_token20_active_address`	string	必返	最近一周 TRC20 活跃地址数	—
`last_week_token20_sum_transaction`	string	必返	最近一周 TRC20 交易次数	—
`last_week_token20_sum_transaction_amount`	string	必返	最近一周 TRC20 交易总额	—
`last_week_trx_transaction_number`	string	必返	最近一周 TRX 交易次数	—
`last_week_trx_transfer_amount`	string	必返	最近一周 TRX 转账总额	TRX
`last_week_whole_contract_use`	string	必返	最近一周合约资源使用量	—
`last_week_whole_energy_burn`	string	必返	最近一周能量燃烧量	—
`last_week_whole_energy_use`	string	必返	最近一周能量使用量（全网）	—
`last_week_whole_fee_burn`	string	必返	最近一周手续费燃烧量	sun
`last_week_whole_net_burn`	string	必返	最近一周带宽燃烧量	—
`last_week_whole_net_use`	string	必返	最近一周带宽使用量（全网）	—

type 非 0 时

响应为数组，每个元素包含 start_time、end_time、type 及 data 字段。

字段	类型	存在性	说明	单位
`type`	integer	必返	排行榜类型（`1`–`20`）。	—
`start_time`	integer	必返	该排行榜快照的统计起始时间，以返回窗口为准。	ms
`end_time`	integer	必返	该排行榜快照的统计结束时间；缓存快照可能早于请求时间。	ms
`update_time`	integer	可选	存在时表示数据更新时间。实测 `type=5/6` 使用秒，其他已观测模式使用毫秒，不能统一按同一单位解析。	s / ms
`data`	array	必返	排行榜条目，字段见下；快照无数据时在此外层结构内返回 `[]`。	—
`wholeFeeBurn`	string	可选	仅 `type=17` 且存在 `total_contract_fee_usage` 时返回，为该合计值的字符串形式。	TRX

type=5/6/7/11 始终读取最新存储快照，不随 time 切换数据。返回的时间字段来自已有源数据或回退窗口，不保证数据实时更新。

data[] 公共字段

账户（type=1–6,14,15,20）

字段	类型	存在性	说明	单位
`address`	string	必返	上榜账户地址。	—
`addressTag`	string	可选	地址标签，可能缺省或为空字符串。	—
`percentage`	number	必返	该排名指标在快照统计总体中的占比，分母不是仅返回的前十名之和。	比例

代币（type=7–10）

字段	类型	存在性	说明	单位
`token_id`	string	必返	代币标识：TRC10 ID、TRC20 合约地址；原生 TRX 在不同快照中可用 `_` 或 `0` 表示。	—
`type`	integer	必返	代币标准：`10` 为 TRC10/原生 TRX，`20` 为 TRC20；与外层排行榜 `type` 含义不同。	—
`name`	string	可选	代币名称。	—
`abbr`	string	可选	代币简称。	—
`logo`	string	可选	代币图标 URL。	—
`vip`	boolean	必返	是否为 VIP 代币。	—

合约（type=11,12,13,16,17）

字段	类型	存在性	说明	单位
`contract`	string	必返	上榜合约地址。	—
`percentage`	number	必返	该排名指标在快照统计总体中的占比，分母不是仅返回的前十名之和。	比例
`name`	string	可选	合约名称。	—
`isToken`	boolean	可选	合约元信息是否将其标记为代币合约。	—
`risk`	boolean	可选	合约风险标记。	—
`vip`	boolean	可选	VIP 标记。	—
`tag1`	string	可选	公开地址标签，可能为空字符串。	—
`tag1Url`	string	可选	公开标签对应的链接。	—
`tag1Url_level`	integer	可选	`tag1Url` 的链接分类，存在时返回。	—
`blueTagUrl`	string	可选	项目 URL。	—
`blueTagUrl_level`	integer	可选	`blueTagUrl` 的链接分类，存在时返回。	—
`publicTagDesc`	string	可选	公开标签说明。	—

data[] 排名指标字段

下列字段仅在所列外层排行榜 type 的非空条目及对应快照分支中出现。带快照条件的字段按实际分支返回，不要求同一条目同时包含新旧结构。

排行榜 `type` / 快照	字段	类型	含义	单位
`1/3`	`amount`	number	统计窗口内发送（`1`）或接收（`3`）的 TRX 数量，已从 SUN 换算。	TRX
`1–4`	`type`	integer	TRX 的代币标准标记 `10`，与外层排行榜类型不同。	—
`2/4/9`	`transaction_number`	number	TRX 转出（`2`）、TRX 转入（`4`）或代币转账（`9`）次数；数值可能带小数点。	次
`5`	`freeze`	number	质押 TRX 余额，该快照截断为整数 TRX。	TRX
`5/6`	`vote` / `votes`	number	账户投出的票数：`5` 返回 `vote`，`6` 返回 `votes`。	票
`5`	`votePercentage`	number	账户票数 ÷ 快照总票数；同条记录的 `percentage` 为质押占比。	0–1
`7`	`holders`	number	代币持有地址数量。	地址数
`7`	`percentage`	number	持有地址数 ÷ 统计范围内各代币持有地址数之和；同一地址可持有多个代币。	0–1
`8`	`address_number`	number	转账活跃地址数；日、周、三日快照统计收发双方，旧小时快照统计发送方。	地址数
`8–10`	`percentage`	number \| string	当前快照的指标占比，或旧小时快照的增长率；见下方快照差异。	比例
`10` （美元快照）	`priceInUsd`	number	美元计价转账总额，不是单个代币价格。	USD
`10` （旧小时快照）	`amount`	number	转账代币数量，已按代币精度换算。	代币数量
`10` （旧小时快照）	`tokenPrice`	number	每个代币的 TRX 价格。	TRX/代币
`10` （旧小时快照）	`priceInTrx`	number	TRX 计价转账总额：`amount * tokenPrice`。	TRX
`11`	`holders`	number	合约 TRX 余额，此处不是持有人数。	TRX
`12`	`active_address`	number	调用该合约的去重地址数量。	地址数
`13`	`triggers`	number	统计窗口内的合约触发次数。	次
`14/16`	`energy_use`	number	发送方或调用方资源提供的 Energy 数量。	Energy
`14/16`	`energy_burn`	number	燃烧 TRX 获取的 Energy 数量。	Energy
`14/16`	`contract_use`	number	合约部署者提供的 Energy 数量。	Energy
`14/16`	`whole_energy_use`	number	Energy 总量：`energy_use + energy_burn + contract_use`；分别按账户（`14`）或合约（`16`）统计。	Energy
`15`	`net_use`	number	质押或免费资源提供的 Bandwidth 数量。	Bandwidth
`15`	`net_burn`	number	燃烧 TRX 获取的 Bandwidth 数量。	Bandwidth
`15`	`whole_net_use`	number	Bandwidth 总量：`net_use + net_burn`。	Bandwidth
`17/20`	`totalBurn`	number	为 Energy 和 Bandwidth 燃烧的 TRX 合计；分别按合约调用（`17`）或账户（`20`）统计。	TRX
`17` （日/周/三日快照）	`energy_burn`	number	为 Energy 燃烧的 TRX；与 `14/16` 的同名字段不同，此处是金额。	TRX
`17` （旧小时快照）, `20`	`energyBurn`	number	为 Energy 燃烧的 TRX。	TRX
`17/20`	`netBurn`	number	为 Bandwidth 燃烧的 TRX。	TRX
`17` （日/周/三日快照）	`total_contract_fee_usage`	number	快照内全部合约调用的资源费用销毁总额；为 `percentage` 的分母，不是本条记录需要再加上的费用。	TRX

快照差异与空结果

type=8/9/10 的实测日、周、三日快照返回数值型 percentage：该代币指标除以参与统计的全部代币对应指标之和，分母在截取前十名之前计算。旧小时快照返回字符串增长率 (current - base) / base，其中 base = max(上一快照的对应值, 1)，缺少历史值时也取 1。增长率可为负数或大于 1，不是总量占比。两种比例都仅在显示百分数时乘以 100。

type=10 的实测旧小时结构使用 amount、tokenPrice、priceInTrx，美元结构使用 priceInUsd。type=17 按返回结构选用 energy_burn 或旧字段 energyBurn，在此模式下两者单位都是 TRX。不要要求同一条记录同时包含各快照分支的全部字段。

所有 20 种模式在 data 为空时均保留数组外层结构。data: [] 表示该快照没有可用排行条目，不代表所有指标为零。实测 type=18/19 在 time=0–4 均返回 data: []，其非空字段契约仍待确认。

示例

示例为代表性节选，完整字段契约（含所有”始终”字段）以上方 §5 响应字段表为准。


{
  "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

同一次响应中，每个非空排行榜节选一条记录；18/19 保留实际空数组。


[
  {
    "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
      }
    ]
  }
]

旧小时快照分支：type=8,9,10,17，time=1

每种模式节选一条记录。这些缓存快照返回较早的时间戳，请求时间不等于数据时间。


[
  {
    "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
      }
    ]
  }
]

空快照：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. 错误

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

type 非 0 时：响应格式为数组而非对象，请注意解析。