获取代币交易数据
1. 概述与典型用途
返回指定代币的交易分析数据，包括每日转账次数、转入/转出地址数、转账金额和持有者数量。
- 典型用途：分析单个代币的转账活跃度、监控持有者增长趋势、评估代币流动性。
- 何时不要用：查核心代币的 USD 转账金额趋势用「获取核心代币转账数据」；查代币总价值用「获取代币链上总价值（TVC）」。
2. 接口与鉴权
GET /api/token/analysis
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
token | string | 是 | — | 代币地址（必填） |
start_day | string | 否 | — | 开始日期，格式 yyyy-MM-dd |
end_day | string | 否 | — | 结束日期，格式 yyyy-MM-dd |
type | integer | 否 | — | 可选。默认：代币转账数据；1：代币持有者数据 |
from | string | 否 | — | 数据来源标识，传 issuance 时控制额外返回字段 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
date | array | 必返 | 日期范围（通常为空数组） | — |
size | integer | 必返 | 数据条数 | — |
avg_amount | string | 必返 | 平均每日转账总量 | 原始精度 |
avg_amount_ratio | string | 必返 | 平均转账量变化率 | — |
avg_account_transfer | string | 必返 | 平均每日转账地址数 | — |
avg_account_transfer_ratio | string | 必返 | 平均转账地址数变化率 | — |
data | array | 必返 | 每日交易数据列表，见下 | — |
data[] 元素（默认，type 未传或非 1）
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 统计日期，格式 yyyy-MM-dd | — |
from_count | integer | 必返 | 当日转出地址数 | — |
to_count | integer | 必返 | 当日转入地址数 | — |
amount | string | 必返 | 当日转账总量 | 原始精度 |
amount_usd | string | 必返 | 当日转账总量（USD） | USD |
transfer_count | integer | 必返 | 当日转账次数 | — |
transfer_address_count | integer | 必返 | 当日参与转账的独立地址数 | — |
holders | string | 必返 | 截至当日的持有者数量 | — |
data[] 元素（type=1，持有者数据模式）
请求参数 type=1 时，data[] 结构不同，返回代币每日持有者数据：
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 统计日期，格式 yyyy-MM-dd | — |
active_account | integer | 必返 | 当日活跃持有者数（有转账行为） | — |
holders_count | string | 必返 | 截至当日总持有者数量 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
token缺失时返回空结果data: []。- 空结果不是错误：无数据返回
200+data: []，属于正常响应。
最后更新于: