获取 TRX 流通数据
1. 概述与典型用途
返回 TRX 的统计数据，如供应量、TRON 协议收入、铸造量和销毁量的历史趋势。
- 典型用途：分析 TRX 通胀/通缩趋势、展示供应量变化图表。
- 何时不要用：查询当前供应量快照用「获取 TRX 供应量/市值/销毁数据」。
2. 接口与鉴权
GET /api/turnover
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
size | integer | 否 | 2000 | 返回数据条数，最大 10000 |
start_timestamp | integer | 否 | 最早统计起点 | 开始时间，精确到毫秒 |
end_timestamp | integer | 否 | 当前时间 | 结束时间，精确到毫秒 |
type | integer | 否 | 0 | 查询类型。0：按天，1：按月，2：按季度，3：按年 |
from | string | 否 | — | 取值 issuance 时，响应额外返回 last_14_days、last_30_days、last_180_days、year_worth_percent 及 yesterday_* 字段 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
year_worth_percent | object | 可选 | 各时段供应量变化率（仅 from=issuance） | — |
total_trx_burn | number | 必返 | 累计总销毁量（手续费直接销毁 + USDD 折算，TRX） | TRX |
total_trx_burn_in_usd | number | 必返 | 累计总销毁量（美元） | USD |
trx_burn | number | 必返 | 手续费/资源消耗直接销毁的 TRX 量 | TRX |
trx_burn_in_usd | number | 必返 | 上述直接销毁折算美元 | USD |
usdd_burn | number | 必返 | USDD 销毁折算 TRX 量 | TRX |
usdd_burn_in_usd | number | 必返 | USDD 销毁折算美元 | USD |
burn_per_day | integer | 必返 | 每日目标销毁量 | TRX |
burn_per_day_in_usd | number | 必返 | 每日目标销毁量（美元） | USD |
tron_revenue_one_year | string | 必返 | 近一年 TRON 协议收入 | TRX |
continue_day | integer | 必返 | 连续通缩天数 | 天 |
increase_type | string | 必返 | 通胀/通缩类型 | — |
total | integer | 必返 | 数据总条数 | — |
yesterday_total_turn_over | integer | 可选 | 昨日 TRX 总流通量（仅 from=issuance） | TRX |
yesterday_turn_over_percent | string | 可选 | 昨日 TRX 总流通量环比变化率（仅 from=issuance） | — |
yesterday_worth | string | 可选 | 昨日净产出量（仅 from=issuance） | TRX |
yesterday_worth_in_usd | string | 可选 | 昨日净产出美元价值（仅 from=issuance） | USD |
yesterday_worth_percent | string | 可选 | 昨日净产出占比（仅 from=issuance） | — |
yesterday_burn_trx_in_usd | string | 可选 | 昨日销毁 TRX 美元价值（仅 from=issuance） | USD |
last_14_days | object | 可选 | 最近 14 天汇总，含 last_14_days_worth/last_14_days_worth_rate（仅 from=issuance） | — |
last_30_days | object | 可选 | 最近 30 天汇总，含 last_30_days_worth/last_30_days_worth_rate（仅 from=issuance） | — |
last_180_days | object | 可选 | 最近 180 天汇总，含同名字段（仅 from=issuance） | — |
data | array | 必返 | 每日流通数据列表，见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 统计日期 | yyyy-MM-dd |
total_turn_over | integer | 必返 | 当日 TRX 总流通量 | TRX |
total_turn_over_percent_than_last_data | string | 必返 | 环比上一日流通量变化率 | — |
total_burn | integer | 必返 | 累计手续费/资源销毁量 | TRX |
total_burn_in_usd | number | 必返 | 累计手续费/资源销毁量（美元） | USD |
total_burn_percent | number | 必返 | 当日销毁量环比变化率 | — |
total_trx_burn | integer | 必返 | 累计 TRX 直接销毁量 | TRX |
total_trx_burn_in_usd | number | 必返 | 累计 TRX 直接销毁量（美元） | USD |
total_usdd_burn | number | 必返 | USDD 销毁量（USD 计） | USD |
total_usdd_burn_trx | number | 必返 | USDD 销毁折算 TRX 量 | TRX |
total_usdd_burn_value | number | 必返 | USDD 销毁价值 | USD |
total_produce | integer | 必返 | 累计产出量 | TRX |
total_produce_in_usd | number | 必返 | 累计产出量（美元） | USD |
total_produce_percent | number | 必返 | 当日产出量环比变化率 | — |
total_block_pay | integer | 必返 | 累计出块奖励 | TRX |
total_node_pay | integer | 必返 | 累计节点奖励 | TRX |
total_energy_limit | integer | 必返 | 全网能量上限 | — |
total_energy_weight | integer | 必返 | 全网能量权重 | — |
total_net_limit | integer | 必返 | 全网带宽上限 | — |
total_net_weight | integer | 必返 | 全网带宽权重 | — |
price | number | 必返 | 当日 TRX 价格 | USD |
worth | integer | 必返 | 当日净产出（产出 - 销毁） | TRX |
worth_in_usd | number | 必返 | 当日净产出美元价值 | USD |
freeze1Balance | integer | 必返 | 带宽质押量 | TRX |
freeze2Balance | integer | 必返 | 能量质押量 | TRX |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果不是错误：无命中返回
200+data: []，属于正常响应。
最后更新于: