Skip to Content
API账户获取账户每日分析数据列表

获取账户每日分析数据列表

1. 概述与典型用途

查询指定时间段内账户的每日分析数据列表,通过 type 参数选择不同的分析维度。

  • 典型用途:账户活动趋势图、资源消耗分析、余额变动追踪。
  • 何时不要用:查询账户当前状态用「获取账户详细信息」;查询单笔交易用「交易与转账」相关接口。

type 取值说明:

type说明
0余额 — 当日 TRX 余额及 TRX 价格(以 USDT 计算)
1代币转账 — 转账次数(TRX/TRC10/TRC20)及涉及的唯一代币种类数
2能量消耗 — 来自冻结 TRX、TRX 燃烧、合约部署方的消耗及总计
3带宽消耗 — 来自冻结 TRX 或免费带宽、TRX 燃烧的消耗
4交易 — 当前账户发起和接收的交易笔数

2. 接口与鉴权

GET /api/account/analysis

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

3. 请求

参数类型必填默认说明
addressstring账户地址(Base58,T 开头)
start_timestampinteger开始时间,毫秒时间戳
end_timestampinteger结束时间,毫秒时间戳
typeinteger0分析类型,取值 0 ~ 4,参见上表

4. 响应

顶层结构固定为 { "size": <int>, "data": [...] }data[] 元素的字段随 type 变化。

顶层

字段类型是否必返说明单位/精度
sizeinteger必返返回数据条数
dataarray必返每日分析数据数组,见下

data[] 元素(type=0 余额)

字段类型是否必返说明单位/精度
daystring必返日期(YYYY-MM-DD
trx_amountstring必返当日 TRX 余额TRX
usdt_amountstring必返折合 USDT 金额USDT
pricenumber必返TRX 对 USDT 价格

data[] 元素(type=1 代币转账)

字段类型是否必返说明单位/精度
daystring必返日期
transfer_countinteger必返转账笔数
token_countinteger必返涉及的唯一代币种类数

data[] 元素(type=2 能量消耗)

字段类型是否必返说明单位/精度
daystring必返日期
energy_usageinteger必返来自冻结 TRX 的能量消耗
energy_burninteger必返TRX 燃烧获得的能量
origin_energy_usageinteger必返合约部署方承担的能量
energy_usage_totalinteger必返能量消耗合计
energy_usage_as_deployinteger必返作为部署方消耗的能量
energy_totalinteger必返总能量消耗

data[] 元素(type=3 带宽消耗)

字段类型是否必返说明单位/精度
daystring必返日期
net_usageinteger必返来自冻结 TRX 或免费带宽的消耗
net_burninteger必返TRX 燃烧获得的带宽
net_usage_totalinteger必返带宽消耗合计

data[] 元素(type=4 交易)

字段类型是否必返说明单位/精度
daystring必返日期
transaction_countinteger必返交易笔数

5. 错误

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

  • 空结果 ≠ 错误:指定时间段内无数据时返回 200 + data: [],属于正常响应。
最后更新于: