获取合约每日独立调用地址数量
1. 概述与典型用途
查询合约在指定时间段内每日独立调用地址的数量，用于分析合约用户增长趋势。
- 典型用途：合约用户活跃度趋势分析、DApp 日活统计、合约运营效果评估。
- 何时不要用：查看每日调用次数用「获取合约每日调用次数列表」；查看调用者排名用「获取合约所有调用方列表」。
2. 接口与鉴权
GET /api/onecontractcallerstatistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 合约地址（Base58，T 开头） |
start_timestamp | integer | 否 | — | 开始时间，毫秒时间戳 |
end_timestamp | integer | 否 | — | 结束时间，毫秒时间戳 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 数据条数（天数） | — |
totalCallerAmount | integer | 必返 | 时间段内独立调用地址总数 | — |
data | array | 必返 | 每日统计数组 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | integer | 必返 | 日期 | 毫秒时间戳 |
amount | integer | 必返 | 当日独立调用地址数 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 时间范围无数据：返回
200+data: []，total: 0。 - 空结果 ≠ 错误：合约不存在或时间段内无调用时返回空数组，属于正常响应。
最后更新于: