Get Token Transaction Data
1. Overview & Typical Use
Returns transaction analysis data for a specified token, including daily transfer count, sender/receiver address count, transfer amount, and holder count.
- Typical use: analyze transfer activity for a single token, monitor holder growth trends, assess token liquidity.
- When not to use: for USD transfer amount trends of core tokens use “Get Core Token Transfer Data”; for total token on-chain value use “Get Token On-Chain Total Value (TVC)“.
2. Endpoint & Authentication
GET /api/token/analysis
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
token | string | Yes | — | Token address (required) |
start_day | string | No | — | Start date, format yyyy-MM-dd |
end_day | string | No | — | End date, format yyyy-MM-dd |
type | integer | No | — | Optional. Default: token transfer data; 1: token holder data |
from | string | No | — | Data source identifier; pass issuance to control additional return fields |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | array | Required | Date range (usually empty array) | — |
size | integer | Required | Number of data entries | — |
avg_amount | string | Required | Average daily total transfer amount | Raw precision |
avg_amount_ratio | string | Required | Average transfer amount change rate | — |
avg_account_transfer | string | Required | Average daily transfer address count | — |
avg_account_transfer_ratio | string | Required | Average transfer address count change rate | — |
data | array | Required | Daily transaction data list; see below | — |
data[] elements (default — type not passed or not 1)
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
day | string | Required | Statistics date, format yyyy-MM-dd | — |
from_count | integer | Required | Number of sender addresses on this day | — |
to_count | integer | Required | Number of receiver addresses on this day | — |
amount | string | Required | Total transfer amount on this day | Raw precision |
amount_usd | string | Required | Total transfer amount on this day (USD) | USD |
transfer_count | integer | Required | Number of transfers on this day | — |
transfer_address_count | integer | Required | Number of unique addresses involved in transfers on this day | — |
holders | string | Required | Cumulative holder count as of this day | — |
data[] elements (type=1 — holder data mode)
When type=1, data[] returns a different structure with daily holder data:
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
day | string | Required | Statistics date, format yyyy-MM-dd | — |
active_account | integer | Required | Active holders on this day (with transfer activity) | — |
holders_count | string | Required | Cumulative total holders as of this day | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- When
tokenis missing, an empty resultdata: []is returned. - Empty result is not an error: no data returns
200+data: []— this is a normal response.
Last updated on: