获取活跃账户统计数据
1. 概述与典型用途
返回每天的活跃账户数据,包括活跃数量、交易量及环比变化。
- 典型用途:分析网络活跃度趋势、展示 DAU 图表。
- 何时不要用:查看新增用户数用「获取每日新增用户数」。
2. 接口与鉴权
GET /api/account/active_statistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
type | string | 否 | DAY | 查询类型,可选值:DAY、WEEK、MONTH(大小写不敏感) |
start_timestamp | integer | 否 | — | 开始时间,精确到毫秒 |
end_timestamp | integer | 否 | — | 结束时间,精确到毫秒 |
days | integer | 否 | — | 查询天数,最大跨度 1000 天 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
last_month | string | 必返 | 最近月份 | yyyy-MM |
pre_month | string | 必返 | 上一个月份 | yyyy-MM |
last_mom | string | 必返 | 月环比变化率 | 百分比 |
avg_active_count | integer | 必返 | 平均活跃账户数 | — |
total | integer | 必返 | 数据条数 | — |
data | array | 必返 | 活跃账户数据列表,见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day_string | string | 必返 | 统计日期 | yyyy-MM-dd |
day_time | integer | 必返 | 统计日期时间戳 | 毫秒时间戳 |
active_count | integer | 必返 | 当日活跃账户数 | — |
transactions | integer | 必返 | 当日交易数 | — |
owner_address_count | integer | 必返 | 发起交易的地址数 | — |
amount | number | 必返 | 交易金额(float,量级约 2×10¹⁰,疑为 sun) | sun |
proportion | number | 必返 | 活跃账户占比 | — |
mom | number | 必返 | 环比变化 | — |
type | string | 必返 | 统计类型 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 空结果不是错误:无命中返回
200+data: [],属于正常响应。
最后更新于: