获取账户详细信息
1. 概述与典型用途
查询单个 TRON 账户的完整信息，包括余额、Stake 1.0/2.0 资源、带宽与能量汇总、权限配置、代币持仓等。
- 典型用途：账户概览页、资产总览、权限检查。
- 何时不要用：批量查询账户列表用「获取账户列表」；仅查代币持仓用「获取账户代币列表」。
2. 接口与鉴权
GET /api/accountv2
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key：无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 账户地址（Base58，T 开头） |
4. 响应
字段
响应较大，下面按逻辑分组展示。
基础信息、余额、计数器
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | 账户地址 | — |
name | string | 必返 | 账户名称（未设置时为空字符串） | — |
accountType | integer | 必返 | 账户类型（0：普通账户） | — |
balance | integer | 必返 | TRX 余额 | sun |
balanceStr | string | 必返 | TRX 余额字符串（防大数截断） | sun |
totalTransactionCount | integer | 必返 | 交易总数 | — |
transactions | integer | 必返 | 主交易笔数 | — |
transactions_in | integer | 必返 | 转入交易笔数 | — |
transactions_out | integer | 必返 | 转出交易笔数 | — |
date_created | integer | 必返 | 账户创建时间 | 毫秒时间戳 ms |
latest_operation_time | integer | 必返 | 最近操作时间 | 毫秒时间戳 ms |
activated | boolean | 必返 | 是否已激活 | — |
witness | integer | 必返 | 是否为超级代表（0：否） | — |
voteTotal | integer | 必返 | 投票总数 | — |
feedbackRisk | boolean | 必返 | 是否被标记为风险账户 | — |
reward | integer | 必返 | 待提取奖励标记（1 表示有奖励可提取） | — |
rewardNum | integer | 必返 | 待提取奖励数量 | sun |
freezing | integer | 必返 | 解冻中 TRX 数量（Stake 1.0） | sun |
canWithdrawAmountV2 | integer | 必返 | Stake 2.0 可提取解冻金额 | sun |
announcement | string | 必返 | 账户公告（未设置时为空字符串） | — |
标签
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
addressTag | string | 可选 | 账户标签；仅当该账户带有公开标签时出现（无标签账户该 key 不存在） | — |
addressTagLogo | string | 必返 | 标签 Logo URL（无标签时为空字符串） | — |
publicTag | string | 必返 | 公开标签文本（无标签时为空字符串） | — |
redTag | string | 必返 | 红色风险标签（无时为空字符串） | — |
greyTag | string | 必返 | 灰色标签（无时为空字符串） | — |
blueTag | string | 必返 | 蓝色认证标签（无时为空字符串） | — |
blueTagUrl | string | 必返 | 蓝色标签跳转 URL（无时为空字符串） | — |
超级代表
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
representative | object | 必返 | SR 相关信息（含 lastWithDrawTime/allowance/enabled/url） | — |
Stake 1.0（旧版冻结）
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
totalFrozen | integer | 必返 | Stake 1.0 冻结总额 | sun |
frozenForBandWidth | integer | 必返 | Stake 1.0 为带宽冻结的数量 | sun |
frozenForEnergy | integer | 必返 | Stake 1.0 为能量冻结的数量 | sun |
frozenForBandwidthValue | integer | 必返 | 为带宽冻结兑换的带宽量 | — |
frozenForEnergyValue | integer | 必返 | 为能量冻结兑换的能量量 | — |
totalFrozenBandwidthValue | integer | 必返 | 合计带宽冻结兑换值 | — |
totalFrozenEnergyValue | integer | 必返 | 合计能量冻结兑换值 | — |
frozen | object | 必返 | 冻结详情（含 total 和 balances[]） | — |
frozen_supply | array | 必返 | TRC10 发行方冻结代币列表（非发行方为空数组） | — |
delegateFrozenForBandWidth | integer | 必返 | 已代理给他人的带宽冻结量 | sun |
delegateFrozenForEnergy | integer | 必返 | 已代理给他人的能量冻结量 | sun |
acquiredDelegateFrozenForBandWidth | integer | 必返 | 他人代理给自己的带宽冻结量 | sun |
acquiredDelegateFrozenForEnergy | integer | 必返 | 他人代理给自己的能量冻结量 | sun |
acquiredDelegatedFrozenBalanceForBandwidthValue | integer | 必返 | 他人代理带宽兑换值 | — |
acquiredDelegatedFrozenBalanceForEnergyValue | integer | 必返 | 他人代理能量兑换值 | — |
Stake 2.0
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
totalFrozenV2 | integer | 必返 | Stake 2.0 冻结总额 | sun |
frozenForBandWidthV2 | integer | 必返 | Stake 2.0 为带宽冻结的数量 | sun |
frozenForEnergyV2 | integer | 必返 | Stake 2.0 为能量冻结的数量 | sun |
unfreezeV2 | integer | 必返 | Stake 2.0 解冻中数量 | sun |
frozenForBandwidthV2Value | integer | 必返 | Stake 2.0 带宽冻结兑换值 | — |
frozenForEnergyV2Value | integer | 必返 | Stake 2.0 能量冻结兑换值 | — |
frozenForBandwidthV2ValueSum | number | 必返 | Stake 2.0 带宽冻结兑换总值（含代理） | — |
frozenForEnergyV2ValueSum | number | 必返 | Stake 2.0 能量冻结兑换总值（含代理） | — |
totalFrozenBandwidthV2Value | integer | 必返 | Stake 2.0 合计带宽冻结兑换值 | — |
totalFrozenEnergyV2Value | integer | 必返 | Stake 2.0 合计能量冻结兑换值 | — |
delegatedFrozenV2BalanceForBandwidth | integer | 必返 | Stake 2.0 已代理带宽冻结量 | sun |
delegatedFrozenV2BalanceForEnergy | integer | 必返 | Stake 2.0 已代理能量冻结量 | sun |
delegatedFrozenV2BalanceForBandwidthValue | number | 必返 | Stake 2.0 已代理带宽兑换值 | — |
delegatedFrozenV2BalanceForEnergyValue | number | 必返 | Stake 2.0 已代理能量兑换值 | — |
acquiredDelegatedFrozenV2BalanceForBandwidth | integer | 必返 | Stake 2.0 他人代理给自己的带宽冻结量 | sun |
acquiredDelegatedFrozenV2BalanceForEnergy | integer | 必返 | Stake 2.0 他人代理给自己的能量冻结量 | sun |
acquiredDelegatedFrozenV2BalanceForBandwidthValue | number | 必返 | Stake 2.0 他人代理带宽兑换值 | — |
acquiredDelegatedFrozenV2BalanceForEnergyValue | number | 必返 | Stake 2.0 他人代理能量兑换值 | — |
delegated | object | 必返 | Stake 2.0 代理详情（无记录时为空对象） | — |
资源汇总
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
totalNet | integer | 必返 | 总带宽 | — |
totalNetRemaining | integer | 必返 | 剩余带宽 | — |
totalEnergy | integer | 必返 | 总能量 | — |
totalEnergyRemaining | integer | 必返 | 剩余能量 | — |
netCost | number | 必返 | 带宽成本估算 | TRX |
energyCost | number | 必返 | 能量成本估算 | TRX |
netRemainingCal | integer | 必返 | 带宽剩余计算值 | — |
accountResource | object | 必返 | 账户资源详情（含 frozen_balance_for_energy） | — |
allowExchange | array | 必返 | 可兑换列表（无时为空数组） | — |
bandwidth 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
freeNetLimit | integer | 必返 | 免费带宽上限 | — |
freeNetUsed | integer | 必返 | 已使用免费带宽 | — |
freeNetRemaining | integer | 必返 | 剩余免费带宽 | — |
freeNetPercentage | number | 必返 | 免费带宽使用率 | — |
netLimit | integer | 必返 | 质押兑换的带宽上限 | — |
netUsed | integer | 必返 | 已使用质押带宽 | — |
netRemaining | integer | 必返 | 剩余质押带宽 | — |
netPercentage | number | 必返 | 质押带宽使用率 | — |
energyLimit | integer | 必返 | 能量上限 | — |
energyUsed | integer | 必返 | 已使用能量 | — |
energyRemaining | integer | 必返 | 剩余能量 | — |
energyPercentage | number | 必返 | 能量使用率 | — |
totalNetLimit | integer | 必返 | 全网带宽上限 | — |
totalNetWeight | integer | 必返 | 全网带宽权重 | — |
totalEnergyLimit | integer | 必返 | 全网能量上限 | — |
totalEnergyWeight | integer | 必返 | 全网能量权重 | — |
storageLimit | integer | 必返 | 存储上限（通常为 0） | — |
storageUsed | integer | 必返 | 已使用存储 | — |
storageRemaining | integer | 必返 | 剩余存储 | — |
storagePercentage | number | 必返 | 存储使用率 | — |
assets | object | 必返 | TRC10 代币带宽明细（key 为代币 ID；无 TRC10 时为空对象） | — |
权限
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
activePermissions | array | 必返 | 活跃权限列表（含 keys/threshold/id/type/permission_name） | — |
ownerPermission | object | 可选 | 所有者权限（含 keys/threshold/permission_name）；accountType=0 且账户已在链上设置 permission 配置的 EOA 含此字段；contract 地址（accountType=2）通常无此字段 | — |
witnessPermission | object | 可选 | 超级代表权限；仅 SR 账户有 | — |
账户分析（条件字段）
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
avgBandwidthUsageRatio | number | 可选 | 近期平均带宽使用率；基于 Greason v5 代码扫描，实测样本在特定高活跃账户场景下返回（待补 reproducing sample） | — |
avgEnergyUsageRatio | number | 可选 | 近期平均能量使用率；基于 Greason v5 代码扫描，实测样本在特定高活跃账户场景下返回（待补 reproducing sample） | — |
nrOfTokenHolders | integer | 可选 | 该账户发行代币的持有人数量；仅代币发行方账户返回（待补 reproducing sample） | — |
publicTagDesc | string | 可选 | 公开标签描述；仅已认证的知名账户（如交易所、项目方）返回（待补 reproducing sample） | — |
transferCount | integer | 可选 | 账户的代币转账总次数；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
合约映射
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
contractMap | object | 可选 | 地址 → 是否为合约的布尔映射；有公开标签账户（如 Binance）不返回 | — |
withPriceTokens[] 元素
withPriceTokens[] 代币元信息字段（通用 tokenInfo 9 字段 + 本接口扩展字段）：
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币合约地址（Base58）；TRX 占位符为 _ | — |
tokenAbbr | string | 必返 | 代币缩写（如 USDT / TRX） | — |
tokenName | string | 必返 | 代币名称 | — |
tokenDecimal | integer | 必返 | 精度位数（amount 字段换算所需） | — |
tokenCanShow | integer | 必返 | 是否可展示（1 是 / 0 否） | — |
tokenType | string | 必返 | 代币类型（trc10 / trc20 / trc721 / trc1155） | — |
tokenLogo | string | 必返 | 代币 logo URL | — |
tokenLevel | string | 必返 | 代币等级（已观测值："0" / "1" / "2" / "4"，具体语义以后端定义为准） | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
balance | string | 必返 | 余额（原值字符串） | 需配合 tokenDecimal 换算 |
amount | string | 必返 | 已换算后的数量（小数字符串） | — |
tokenPriceInTrx | number | 可选 | 代币对 TRX 价格；无价格时不出现 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 需要 API Key：未携带返回 401（见公共网络与鉴权说明）。
- 地址无效：传入格式不正确的地址时可能返回空对象或默认值，不会返回显式错误。
- 空结果 ≠ 错误：未激活的地址返回
200+activated: false，属于正常响应。
最后更新于: