获取合约每日分析数据列表

1. 概述与典型用途

按日查询合约在指定时间段内的多维度分析数据，通过 type 参数切换六种查询类型：余额、代币转账、能量消耗、带宽消耗、合约调用、费用。

GET /api/contract/analysis

type 取值说明：

值	说明
`0`	余额 — 当日 TRX 余额及 TRX 价格
`1`	代币转账 — TRC20 代币转账次数及转账代币种类数
`2`	能量消耗 — 来自冻结 TRX、TRX 燃烧、合约部署方提供的消耗
`3`	带宽消耗 — 来自免费带宽或冻结 TRX、TRX 燃烧的消耗
`4`	合约调用 — 调用次数及调用账户数量
`5`	费用 — 通过 TRX 燃烧消耗的带宽和能量

顶层

字段	类型	是否必返	说明	单位/精度
`size`	integer	必返	数据条数（天数）	—
`data`	array	必返	每日分析数据数组，字段随 type 变化	—

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	必返	日期	YYYY-MM-DD
`transfer_count`	integer	必返	转账次数	—
`token_count`	integer	必返	涉及代币种类数	—

data[] 元素 — type=2（能量消耗）

字段	类型	是否必返	说明	单位/精度
`day`	string	必返	日期	YYYY-MM-DD
`energy_usage`	integer	必返	质押/冻结获取的能量消耗	—
`energy_burn`	integer	必返	TRX 燃烧获取的能量消耗	—
`origin_energy_usage`	integer	必返	合约部署方提供的能量	—
`energy_usage_total`	integer	必返	能量消耗总计（= energy_usage + energy_burn + origin_energy_usage）	—
`energy_usage_as_deploy`	integer	必返	用于合约部署的能量消耗	—
`energy_total`	integer	必返	能量总计（= energy_usage + energy_burn，不含 origin_energy_usage）	—

data[] 元素 — type=3（带宽消耗）

字段	类型	是否必返	说明	单位/精度
`day`	string	必返	日期	YYYY-MM-DD
`net_usage`	integer	必返	免费/质押带宽消耗	—
`net_burn`	integer	必返	TRX 燃烧获取的带宽消耗	—
`net_usage_total`	integer	必返	带宽消耗总计	—

data[] 元素 — type=4（合约调用）

字段	类型	是否必返	说明	单位/精度
`day`	string	必返	日期	YYYY-MM-DD
`trigger_count`	integer	必返	调用次数	—
`account_count`	integer	必返	调用账户数量	—

data[] 元素 — type=5（费用）

字段	类型	是否必返	说明	单位/精度
`day`	string	必返	日期	YYYY-MM-DD
`burn_trx`	string	必返	通过 TRX 燃烧消耗的费用	TRX

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