Get All Contract Callers
1. Overview & Typical Use
Returns a paginated list of all addresses that have called a contract, along with their call counts, sorted by call count in descending order.
- Typical use: analyze the user composition of a contract, identify heavy callers, monitor abnormal calling behavior.
- When not to use: for a Top-caller and method overview use “Get Contract Call Statistics”; for daily call count trends use “Get Contract Daily Call Count List”.
2. Endpoint & Authentication
GET /api/onecontractcallers
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | Yes | — | Contract address (Base58, starts with T) |
start | integer | No | 0 | Starting offset |
limit | integer | No | 10 | Page size |
day | integer | No | Yesterday | Query date, millisecond timestamp |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Total number of callers | — |
totalCallerAmount | integer | Required | Total call count | — |
data | array | Required | List of callers | — |
contractMap | object | Required | Address → whether it is a contract | — |
contractInfo | object | Required | Contract address → label info | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
caller_address | string | Required | Caller address | — |
callerAddressTag | string | Optional | Caller address label | — |
amount | integer | Required | Call count | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- Invalid contract address: returns
200+data: [],total: 0. - Empty result is not an error: when there are no call records, an empty array is returned as a normal response.
Last updated on: