Skip to Content
APIContractGet Contract Daily Unique Caller Count

Get Contract Daily Unique Caller Count

1. Overview & Typical Use

Query the number of unique caller addresses for a contract per day within a specified time range, used to analyze contract user growth trends.

  • Typical use: contract user activity trend analysis, DApp daily active user statistics, contract operations effectiveness evaluation.
  • When not to use: for daily call count use “Get Contract Daily Call Count List”; for caller ranking use “Get Contract Caller List”.

2. Endpoint & Authentication

GET /api/onecontractcallerstatistic

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

3. Request

ParameterTypeRequiredDefaultDescription
addressstringYesContract address (Base58, starts with T)
start_timestampintegerNoStart time, millisecond timestamp
end_timestampintegerNoEnd time, millisecond timestamp

4. Response

Top-level

FieldTypeRequiredDescriptionUnit/Precision
totalintegerRequiredNumber of data records (number of days)
totalCallerAmountintegerRequiredTotal unique caller addresses in the time range
dataarrayRequiredDaily statistics array

data[] elements

FieldTypeRequiredDescriptionUnit/Precision
dayintegerRequiredDateMillisecond timestamp
amountintegerRequiredNumber of unique caller addresses for the day

5. Errors

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

  • No data in the time range: returns 200 + data: [], total: 0.
  • Empty result is not an error: returns an empty array when the contract does not exist or has no calls in the time period; this is a normal response.
Last updated on: