获取合约所有调用方列表
1. 概述与典型用途
查询合约所有调用方地址的列表及调用次数统计，按调用次数降序排列，支持分页。
- 典型用途：分析合约用户构成、识别大户调用者、监控异常调用行为。
- 何时不要用：只看 Top 调用地址和方法概览用「获取合约调用统计数据」；查看每日调用趋势用「获取合约每日调用次数列表」。
2. 接口与鉴权
GET /api/onecontractcallers
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 合约地址（Base58，T 开头） |
start | integer | 否 | 0 | 起始编号 |
limit | integer | 否 | 10 | 每页数量 |
day | integer | 否 | 昨天 | 查询天数，毫秒时间戳 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 调用方总数 | — |
totalCallerAmount | integer | 必返 | 调用总次数 | — |
data | array | 必返 | 调用方列表 | — |
contractMap | object | 必返 | 地址 → 是否为合约的映射 | — |
contractInfo | object | 必返 | 合约地址 → 标签信息 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
caller_address | string | 必返 | 调用方地址 | — |
callerAddressTag | string | 可选 | 调用方地址标签 | — |
amount | integer | 必返 | 调用次数 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 合约地址无效：返回
200+data: []，total: 0。 - 空结果 ≠ 错误：无调用记录时返回空数组，属于正常响应。
最后更新于: