Get Holder Token Value Info
1. Overview & Typical Use
Returns daily balance, price, and USD value for a specific address and token over a time range.
- Typical use: draw USD value trend charts for a holder’s token position over time.
- When not to use: for raw balance change trends use “Get Holder Token Change Balance”; for summary metrics use “Get Holder Token Basic Info”.
2. Endpoint & Authentication
GET /api/account/holderToken/asset/valueInfo
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 |
startTime | integer | No | — | Start time (milliseconds) |
endTime | integer | No | Current time | End time (milliseconds) |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
data | array | Required | Daily value info 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 | Value metrics for this date | — |
data[].statistics object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | string | Required | Date | — |
balance | string | Required | Balance at end of day (minimum unit) | minimum unit (divide by 10^tokenDecimal) |
price | string | Required | Token price in USD | USD |
value | string | Required | Position value in USD (balance × price / 10^decimal) | USD |
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: