Get Account Transfer Amount Distribution
1. Overview & Typical Use
Returns a summarized analysis of fund inflows and outflows for a specified account, including transfer amounts (USD) and counts per associated address.
- Typical use: fund flow analysis, associated account tracking, deposit/withdrawal channel statistics.
- When not to use: to query a single transaction, use “Get Transaction Detail by Hash”; to query large transactions, use “Get Large Transactions”.
2. Endpoint & Authentication
GET /api/deep/account/transferAmount
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 |
|---|---|---|---|---|
address | string | Yes | — | Account address to query |
direction | integer | No | 0 | Transfer direction: 0 all, 1 incoming, 2 outgoing |
relatedToken | string | No | — | Filter by related token (Base58 address, or 0 for TRX, or TRC10 ID) |
sortBy | string | No | amountIn | Sort field: amountIn, amountOut, timesIn, timesOut |
limit | integer | No | 100 | Number of results |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
code | integer | Required | Status code; 0 means success | — |
transfer_in | object | Required | Incoming transfer summary | — |
transfer_out | object | Required | Outgoing transfer summary | — |
transfer_in / transfer_out object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Total number of associated addresses | — |
amountTotal | number | Required | Total amount | USD |
data | array | Required | Associated address list | — |
contractMap | object | Optional | Address → whether it is a contract | — |
contractInfo | object | Optional | Contract label info | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
address | string | Required | Associated address | — |
addressTag | string | Optional | Address label | — |
amountInUsd | number | Required | Amount | USD |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- API Key Required: returns 401 if not provided.
addressnot provided: returns empty data without an error.- Empty result is not an error: no matches returns
200+ emptydataas a normal response.
Last updated on: