Skip to Content
APIStatisticsGet Contract Call Statistics (with Min/Max)

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

ParameterTypeRequiredDefaultDescription
start_timestampintegerNoEarliest availableStart time, millisecond precision
end_timestampintegerNoCurrent timeEnd time, millisecond precision

4. Response

Top-level

FieldTypeRequiredDescriptionUnit/Precision
totalintegerRequiredNumber of data records
caller_amount_maxobjectRequiredData record with the maximum caller count
caller_amount_minobjectRequiredData record with the minimum caller count
triggers_amount_maxobjectRequiredData record with the maximum trigger count
triggers_amount_minobjectRequiredData record with the minimum trigger count
dataarrayRequiredDaily statistics list; see below

data[] elements

FieldTypeRequiredDescriptionUnit/Precision
dayintegerRequiredStatistics dateMillisecond timestamp
caller_amountintegerRequiredCaller count for the day
caller_amount_ratenumberRequiredDay-over-day change rate for caller count
triggers_amountintegerRequiredTrigger count for the day
triggers_amount_ratenumberRequiredDay-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: