获取账户持有代币基本信息
1. 概述与典型用途
返回账户持有某代币的数量、首次持有时间、钱包/项目占比及最近转账时间。
- 典型用途：查看账户某代币的持仓详情和分布。
- 何时不要用：仅查看转入转出数量请用「获取 TRC20 代币转账数量」。
2. 接口与鉴权
GET /api/account/holderToken/basicInfo
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
accountAddress | string | 是 | — | 查询的账户地址 |
tokenAddress | string | 是 | — | TRC20 地址或 TRC10 代币 ID，TRX 使用 0 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
data | object | 必返 | 持仓详情 | — |
refreshTimeInfo | object | 必返 | 数据刷新时间信息，含 type（如 realtime）和 lastUpdateTime（秒时间戳） | — |
data 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
holdCount | string | 必返 | 持有数量（最小单位） | — |
holdAmount | number | 必返 | 持有数量（换算后） | — |
firstHoldTime | integer | 必返 | 首次持有时间 | 秒时间戳 |
latestTransferTime | integer | 必返 | 最近转账时间 | 秒时间戳 |
tokenDecimal | integer | 必返 | 代币精度 | — |
walletValue | string | 必返 | 钱包中的价值 | 美元 |
walletRatio | string | 必返 | 钱包占比 | 小数 |
projectValue | string | 必返 | 项目中的价值 | 美元 |
projectRatio | string | 必返 | 项目占比 | 小数 |
projects | array | 必返 | 项目分布列表 | — |
projectNum | integer | 必返 | 涉及项目数量 | — |
transferIn | integer | 可选 | 转入次数（仅 tokenAddress=0，即 TRX 时返回） | — |
transferOut | integer | 可选 | 转出次数（仅 tokenAddress=0，即 TRX 时返回） | — |
projects[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
name | string | 必返 | 项目名称（如 wallet / JustLend DAO） | — |
value | number|string | 必返 | 项目中的价值 | 美元 |
ratio | string | 必返 | 占该账户持仓总比 | 小数 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 通用错误处理规则适用，无特殊错误场景。
最后更新于: