Get Contract Call Statistics (with Min/Max)
1. Overview & Typical Use
Returns contract call statistics for a specified time range, including daily trends for caller count and trigger count.
- Typical use: analyze time trends in contract caller count and trigger count, view extreme values.
- When not to use: for the distribution of calls across contracts on a single day use “Get Contract Call Distribution” (
/api/triggeramountstatistic).
2. Endpoint & Authentication
GET /api/contract_caller_statistic
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_timestamp | integer | No | Earliest available | Start time, millisecond precision |
end_timestamp | integer | No | Current time | End time, millisecond precision |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Number of data records | — |
caller_amount_max | object | Required | Data record with the maximum caller count | — |
caller_amount_min | object | Required | Data record with the minimum caller count | — |
triggers_amount_max | object | Required | Data record with the maximum trigger count | — |
triggers_amount_min | object | Required | Data record with the minimum trigger count | — |
data | array | Required | Daily statistics list; see below | — |
data[] elements
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
day | integer | Required | Statistics date | Millisecond timestamp |
caller_amount | integer | Required | Caller count for the day | — |
caller_amount_rate | number | Required | Day-over-day change rate for caller count | — |
triggers_amount | integer | Required | Trigger count for the day | — |
triggers_amount_rate | number | Required | Day-over-day change rate for trigger count | — |
5. Errors
For HTTP status codes, see Common Errors. Notes for this endpoint:
- Empty result is not an error: no matched records returns
200+data: [], which is a normal response.
Last updated on: