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: