Get Holder Token Basic Info
1. Overview & Typical Use
Returns the amount, first-hold time, wallet/protocol distribution, and latest transfer time for a token held by an account.
- Typical use: view an account’s holding details and distribution for a specific token.
- When not to use: for transfer-count only, use “Get TRC20 Token Transfer Count”.
2. Endpoint & Authentication
GET /api/account/holderToken/basicInfo
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
accountAddress | string | Yes | — | Account address to query |
tokenAddress | string | Yes | — | TRC20 address or TRC10 token ID; use 0 for TRX |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
data | object | Required | Holding details | — |
refreshTimeInfo | object | Required | Data refresh time info; contains type (e.g. realtime) and lastUpdateTime (seconds timestamp) | — |
data object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
holdCount | string | Required | Holding amount (minimum unit) | — |
holdAmount | number | Required | Holding amount (converted) | — |
firstHoldTime | integer | Required | First hold time | seconds timestamp |
latestTransferTime | integer | Required | Latest transfer time | seconds timestamp |
tokenDecimal | integer | Required | Token decimal precision | — |
walletValue | string | Required | Value held in wallet | USD |
walletRatio | string | Required | Wallet share | decimal |
projectValue | string | Required | Value held in projects | USD |
projectRatio | string | Required | Project share | decimal |
projects | array | Required | Project distribution list | — |
projectNum | integer | Required | Number of involved projects | — |
transferIn | integer | Optional | Transfer-in count (returned only when tokenAddress=0, i.e. TRX) | — |
transferOut | integer | Optional | Transfer-out count (returned only when tokenAddress=0, i.e. TRX) | — |
projects[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
name | string | Required | Project name (e.g. wallet / JustLend DAO) | — |
value | number|string | Required | Value in this project | USD |
ratio | string | Required | Share of this account’s total holdings | decimal |
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: