Skip to Content
APIStatisticsGet Contract Caller Count (with Min/Max)

Get Contract Caller Count (with Min/Max)

1. Overview & Typical Use

Returns the contract caller count for a specified number of days, including the maximum and minimum values.

  • Typical use: analyze trends in contract caller counts, view extreme values.
  • When not to use: for contract trigger count trends use “Get Contract Trigger Data”.

2. Endpoint & Authentication

GET /api/calleraddressstatistic

For Base URL and authentication, see Common Network & Authentication.

3. Request

ParameterTypeRequiredDefaultDescription
start_timestampintegerNoStart time, millisecond precision
end_timestampintegerNoEnd time, millisecond precision
limitintegerNo1000Number of records to return

4. Response

Top-level

FieldTypeRequiredDescriptionUnit/Precision
totalintegerRequiredNumber of data records
maxobjectRequiredData record with the maximum caller count
minobjectRequiredData record with the minimum caller count
dataarrayRequiredDaily caller data 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

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: