获取账户每日分析数据列表
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. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 账户地址(Base58,T 开头) |
start_timestamp | integer | 是 | — | 开始时间,毫秒时间戳 |
end_timestamp | integer | 是 | — | 结束时间,毫秒时间戳 |
type | integer | 否 | 0 | 分析类型,取值 0 ~ 4,参见上表 |
4. 响应
字段
顶层结构固定为 { "size": <int>, "data": [...] },data[] 元素的字段随 type 变化。
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
size | integer | 必返 | 返回数据条数 | — |
data | array | 必返 | 每日分析数据数组,见下 | — |
data[] 元素(type=0 余额)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 日期(YYYY-MM-DD) | — |
trx_amount | string | 必返 | 当日 TRX 余额 | TRX |
usdt_amount | string | 必返 | 折合 USDT 金额 | USDT |
price | number | 必返 | TRX 对 USDT 价格 | — |
data[] 元素(type=1 代币转账)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 日期 | — |
transfer_count | integer | 必返 | 转账笔数 | — |
token_count | integer | 必返 | 涉及的唯一代币种类数 | — |
data[] 元素(type=2 能量消耗)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 日期 | — |
energy_usage | integer | 必返 | 来自冻结 TRX 的能量消耗 | — |
energy_burn | integer | 必返 | TRX 燃烧获得的能量 | — |
origin_energy_usage | integer | 必返 | 合约部署方承担的能量 | — |
energy_usage_total | integer | 必返 | 能量消耗合计 | — |
energy_usage_as_deploy | integer | 必返 | 作为部署方消耗的能量 | — |
energy_total | integer | 必返 | 总能量消耗 | — |
data[] 元素(type=3 带宽消耗)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 日期 | — |
net_usage | integer | 必返 | 来自冻结 TRX 或免费带宽的消耗 | — |
net_burn | integer | 必返 | TRX 燃烧获得的带宽 | — |
net_usage_total | integer | 必返 | 带宽消耗合计 | — |
data[] 元素(type=4 交易)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 日期 | — |
transaction_count | integer | 必返 | 交易笔数 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 空结果 ≠ 错误:指定时间段内无数据时返回
200+data: [],属于正常响应。
最后更新于: