Get Holder TRC20 Transfer Statistics
1. Overview & Typical Use
Returns aggregate inflow and outflow transfer counts for a specific address and TRC20 token. This endpoint requires an API Key; calls without a Key return 401.
- Typical use: check a holder’s inbound and outbound transfer-count activity for one TRC20 token.
- When not to use: for individual transfer records use the TRC20 transfers endpoint.
transferInandtransferOutare counts, not amounts. Do not use the count difference as a fund-flow or buy/sell signal. Fund flow needs amount data, and buy/sell analysis also needs the transaction type.
2. Endpoint & Authentication
GET /api/deep/account/holderToken/basicInfo/trc20/transfer
For Base URL and authentication, see Common Network & Authentication.
This endpoint requires an API Key; calls without a Key return 401.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
accountAddress | string | Yes | — | Holder address (Base58 format, starts with T) |
tokenAddress | string | Yes | — | TRC20 contract address |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
transferIn | integer | Required | Total inbound transfer count | count |
transferOut | integer | Required | Total outbound transfer count | count |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- API Key Required: returns 401 if
TRON-PRO-API-KEYheader is not provided.