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
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | Yes | — | Contract address (Base58, starts with T) |
start_timestamp | integer | No | — | Start time, millisecond timestamp |
end_timestamp | integer | No | — | End time, millisecond timestamp |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Number of data records (number of days) | — |
totalCallerAmount | integer | Required | Total unique caller addresses in the time range | — |
data | array | Required | Daily statistics array | — |
data[] elements
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
day | integer | Required | Date | Millisecond timestamp |
amount | integer | Required | Number 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: