获取合约调用统计数据
1. 概述与典型用途
查询合约的 Top 调用地址、Top 调用方法以及历史累计调用次数汇总。
- 典型用途：分析合约的主要调用者分布、了解合约最常被调用的方法、评估合约活跃度。
- 何时不要用：按时间段查看每日独立调用地址数用「获取合约每日独立调用地址数量」；查看所有调用方列表用「获取合约所有调用方列表」。
2. 接口与鉴权
GET /api/contracts/top_call
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
contract_address | string | 是 | — | 合约地址（Base58，T 开头） |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
recentCallTimes | integer | 必返 | 近期调用总次数 | — |
timeLong | integer | 必返 | 统计时间起点 | 毫秒时间戳 |
totalAddress | integer | 必返 | 累计独立调用地址数 | — |
totalCallTimes | integer | 必返 | 累计调用总次数 | — |
topAddress | array | 必返 | 调用量 Top 地址列表 | — |
topMethods | array | 必返 | 调用量 Top 方法列表 | — |
contractMap | object | 必返 | 地址 → 是否为合约的映射（查询合约自身时可为空对象） | — |
contractInfo | object | 必返 | 合约地址 → 标签信息（查询合约自身时可为空对象） | — |
topAddress[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | 调用者地址 | — |
addressTag | string | 可选 | 地址标签 | — |
count | integer | 必返 | 调用次数 | — |
ratio | number | 必返 | 调用占比 | — |
topMethods[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
methodId | string | 必返 | 方法选择器 | — |
times | integer | 必返 | 调用次数 | — |
ratio | number | 必返 | 调用占比 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 合约地址不存在：返回
200+ 空数组与零计数。 - 空结果 ≠ 错误：合约无调用记录时属于正常响应。
最后更新于: