Skip to Content
APIStatisticsGet Contract Call Distribution

Get Contract Call Distribution

1. Overview & Typical Use

Returns the contract call distribution for a specified date, including trigger count and caller count per contract.

  • Typical use: analyzing contract call heat distribution, viewing trigger count and caller count rankings.
  • When not to use: to view contract call trends aggregated over time periods use “Get Contract Call Statistics”.

2. Endpoint & Authentication

GET /api/triggeramountstatistic

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

3. Request

ParameterTypeRequiredDefaultDescription
dayintegerNoMost recent statistics periodData date, millisecond timestamp
limitintegerNo10Number of results to return, max 50

4. Response

Top-level

FieldTypeRequiredDescriptionUnit/Precision
totalTriggerintegerRequiredTotal trigger transactions for the day
totalCallerAmountintegerRequiredTotal unique callers for the day
totalEnergyintegerRequiredTotal energy consumed for the day
totalintegerRequiredTotal number of matched contracts
lastUpdateSecondsintegerRequiredData update timeUnix timestamp in seconds s
dataarrayRequiredContract call distribution list; see below

data[] elements

FieldTypeRequiredDescriptionUnit/Precision
contract_addressstringRequiredContract address
trigger_amountintegerRequiredNumber of triggers
caller_amountintegerRequiredNumber of callers
call_valueintegerRequiredCall value
namestringRequiredContract name
trigger_amount_percentnumberRequiredTrigger count proportion
caller_amount_percentnumberRequiredCaller count proportion
tag1stringOptionalContract tag
tag1UrlstringOptionalContract tag link
blueTagUrlstringOptionalContract official website link
isTokenbooleanRequiredWhether this is a token contract
publicTagDescstringOptionalPublic tag description
riskbooleanRequiredRisk flag
vipbooleanRequiredWhether this is a VIP contract

5. Errors

For HTTP status codes, see Common Errors. Notes for this endpoint:

  • Empty result is not an error: no matches returns 200 + data: [], which is a normal response.
Last updated on: