Get Holder Token Change Balance
1. Overview & Typical Use
Returns the daily balance change and cumulative balance for a specific address and token up to a given end date.
- Typical use: draw a balance change trend chart for an address’s holdings.
- When not to use: for summary holding metrics use “Get Holder Token Basic Info”; for USD value trends use “Get Holder Token Value Info”.
2. Endpoint & Authentication
GET /api/account/holderToken/asset/changeBalance
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
accountAddress | string | Yes | — | Holder address (Base58 format, starts with T) |
tokenAddress | string | Yes | — | TRC20 contract address; TRC10 token ID; or 0 for TRX |
endTime | integer | No | Current time | Query up to this time (milliseconds) |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
data | array | Required | Daily balance change list | — |
tokenDecimal | integer | Required | Token decimal precision | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | string | Required | Date (format: YYYY-MM-DD) | — |
statistics | object | Required | Balance metrics for this date | — |
data[].statistics object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | string | Required | Date | — |
change | string | Required | Net change on this date (minimum unit) | minimum unit (divide by 10^tokenDecimal) |
balance | string | Required | Cumulative balance at end of day (minimum unit) | minimum unit (divide by 10^tokenDecimal) |
type | integer | Required | Direction: 1 = inflow, 2 = outflow | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- General error handling rules apply; no special error scenarios.
Last updated on: