Get Account Detail

1. Overview & Typical Use

Query the complete information for a single TRON account, including balance, Stake 1.0/2.0 resources, bandwidth and energy summary, permission configuration, and token holdings.

Typical use: account overview page, asset summary, permission check.
When not to use: for batch account queries use “Get Account List”; for token holdings only use “Get Account Token List”.

2. Endpoint & Authentication

GET /api/accountv2

For Base URL and authentication, see Common Network & Authentication. This endpoint requires an API Key: calls without a Key return 401.

3. Request

Fields

Parameter	Type	Required	Default	Description
`address`	string	Yes	—	Account address (Base58, starts with T)

4. Response

Fields

The response is large; fields are grouped logically below.

Basic info, balance, counters

Field	Type	Required	Description	Unit/Precision
`address`	string	Required	Account address	—
`name`	string	Required	Account name (empty string if not set)	—
`accountType`	integer	Required	Account type (0: normal account)	—
`balance`	integer	Required	TRX balance	sun
`balanceStr`	string	Required	TRX balance as string (prevents large-number truncation)	sun
`totalTransactionCount`	integer	Required	Total transaction count	—
`transactions`	integer	Required	Main transaction count	—
`transactions_in`	integer	Required	Inbound transaction count	—
`transactions_out`	integer	Required	Outbound transaction count	—
`date_created`	integer	Required	Account creation time	ms timestamp
`latest_operation_time`	integer	Required	Most recent operation time	ms timestamp
`activated`	boolean	Required	Whether the account is activated	—
`witness`	integer	Required	Whether a Super Representative (0: no)	—
`voteTotal`	integer	Required	Total votes cast	—
`feedbackRisk`	boolean	Required	Whether flagged as a risky account	—
`reward`	integer	Required	Pending reward flag (1 means rewards available)	—
`rewardNum`	integer	Required	Pending reward amount	sun
`freezing`	integer	Required	TRX unfreezing amount (Stake 1.0)	sun
`canWithdrawAmountV2`	integer	Required	Stake 2.0 withdrawable unfrozen amount	sun
`announcement`	string	Required	Account announcement (empty string if not set)	—

Labels

Field	Type	Required	Description	Unit/Precision
`addressTag`	string	Optional	Account label; only present when the account has a public label (key absent for accounts without a label)	—
`addressTagLogo`	string	Required	Label logo URL (empty string if no label)	—
`publicTag`	string	Required	Public label text (empty string if none)	—
`redTag`	string	Required	Red risk label (empty string if none)	—
`greyTag`	string	Required	Grey label (empty string if none)	—
`blueTag`	string	Required	Blue verification label (empty string if none)	—
`blueTagUrl`	string	Required	Blue label redirect URL (empty string if none)	—

Super Representative

Field	Type	Required	Description	Unit/Precision
`representative`	object	Required	SR-related info (includes `lastWithDrawTime`/`allowance`/`enabled`/`url`)	—

Stake 1.0 (legacy freeze)

Field	Type	Required	Description	Unit/Precision
`totalFrozen`	integer	Required	Total frozen amount (Stake 1.0)	sun
`frozenForBandWidth`	integer	Required	Stake 1.0 frozen for bandwidth	sun
`frozenForEnergy`	integer	Required	Stake 1.0 frozen for energy	sun
`frozenForBandwidthValue`	integer	Required	Bandwidth exchanged from bandwidth freeze	—
`frozenForEnergyValue`	integer	Required	Energy exchanged from energy freeze	—
`totalFrozenBandwidthValue`	integer	Required	Total bandwidth freeze exchange value	—
`totalFrozenEnergyValue`	integer	Required	Total energy freeze exchange value	—
`frozen`	object	Required	Freeze details (includes `total` and `balances[]`)	—
`frozen_supply`	array	Required	TRC10 issuer frozen token list (empty array for non-issuers)	—
`delegateFrozenForBandWidth`	integer	Required	Bandwidth freeze delegated to others	sun
`delegateFrozenForEnergy`	integer	Required	Energy freeze delegated to others	sun
`acquiredDelegateFrozenForBandWidth`	integer	Required	Bandwidth freeze delegated to this account by others	sun
`acquiredDelegateFrozenForEnergy`	integer	Required	Energy freeze delegated to this account by others	sun
`acquiredDelegatedFrozenBalanceForBandwidthValue`	integer	Required	Exchange value of delegated bandwidth from others	—
`acquiredDelegatedFrozenBalanceForEnergyValue`	integer	Required	Exchange value of delegated energy from others	—

Stake 2.0

Field	Type	Required	Description	Unit/Precision
`totalFrozenV2`	integer	Required	Total frozen amount (Stake 2.0)	sun
`frozenForBandWidthV2`	integer	Required	Stake 2.0 frozen for bandwidth	sun
`frozenForEnergyV2`	integer	Required	Stake 2.0 frozen for energy	sun
`unfreezeV2`	integer	Required	Stake 2.0 amount currently unfreezing	sun
`frozenForBandwidthV2Value`	integer	Required	Stake 2.0 bandwidth freeze exchange value	—
`frozenForEnergyV2Value`	integer	Required	Stake 2.0 energy freeze exchange value	—
`frozenForBandwidthV2ValueSum`	number	Required	Stake 2.0 total bandwidth freeze exchange value (including delegated)	—
`frozenForEnergyV2ValueSum`	number	Required	Stake 2.0 total energy freeze exchange value (including delegated)	—
`totalFrozenBandwidthV2Value`	integer	Required	Stake 2.0 total bandwidth freeze exchange value	—
`totalFrozenEnergyV2Value`	integer	Required	Stake 2.0 total energy freeze exchange value	—
`delegatedFrozenV2BalanceForBandwidth`	integer	Required	Stake 2.0 bandwidth freeze delegated to others	sun
`delegatedFrozenV2BalanceForEnergy`	integer	Required	Stake 2.0 energy freeze delegated to others	sun
`delegatedFrozenV2BalanceForBandwidthValue`	number	Required	Stake 2.0 delegated bandwidth exchange value	—
`delegatedFrozenV2BalanceForEnergyValue`	number	Required	Stake 2.0 delegated energy exchange value	—
`acquiredDelegatedFrozenV2BalanceForBandwidth`	integer	Required	Stake 2.0 bandwidth delegated to this account by others	sun
`acquiredDelegatedFrozenV2BalanceForEnergy`	integer	Required	Stake 2.0 energy delegated to this account by others	sun
`acquiredDelegatedFrozenV2BalanceForBandwidthValue`	number	Required	Stake 2.0 delegated bandwidth exchange value from others	—
`acquiredDelegatedFrozenV2BalanceForEnergyValue`	number	Required	Stake 2.0 delegated energy exchange value from others	—
`delegated`	object	Required	Stake 2.0 delegation details (empty object if no records)	—

Resource summary

Field	Type	Required	Description	Unit/Precision
`totalNet`	integer	Required	Total bandwidth	—
`totalNetRemaining`	integer	Required	Remaining bandwidth	—
`totalEnergy`	integer	Required	Total energy	—
`totalEnergyRemaining`	integer	Required	Remaining energy	—
`netCost`	number	Required	Estimated bandwidth cost	TRX
`energyCost`	number	Required	Estimated energy cost	TRX
`netRemainingCal`	integer	Required	Calculated remaining bandwidth	—
`accountResource`	object	Required	Account resource details (includes `frozen_balance_for_energy`)	—
`allowExchange`	array	Required	Exchangeable list (empty array if none)	—

bandwidth object

Field	Type	Required	Description	Unit/Precision
`freeNetLimit`	integer	Required	Free bandwidth cap	—
`freeNetUsed`	integer	Required	Used free bandwidth	—
`freeNetRemaining`	integer	Required	Remaining free bandwidth	—
`freeNetPercentage`	number	Required	Free bandwidth usage rate	—
`netLimit`	integer	Required	Staked bandwidth cap	—
`netUsed`	integer	Required	Used staked bandwidth	—
`netRemaining`	integer	Required	Remaining staked bandwidth	—
`netPercentage`	number	Required	Staked bandwidth usage rate	—
`energyLimit`	integer	Required	Energy cap	—
`energyUsed`	integer	Required	Used energy	—
`energyRemaining`	integer	Required	Remaining energy	—
`energyPercentage`	number	Required	Energy usage rate	—
`totalNetLimit`	integer	Required	Network-wide bandwidth cap	—
`totalNetWeight`	integer	Required	Network-wide bandwidth weight	—
`totalEnergyLimit`	integer	Required	Network-wide energy cap	—
`totalEnergyWeight`	integer	Required	Network-wide energy weight	—
`storageLimit`	integer	Required	Storage cap (typically 0)	—
`storageUsed`	integer	Required	Used storage	—
`storageRemaining`	integer	Required	Remaining storage	—
`storagePercentage`	number	Required	Storage usage rate	—
`assets`	object	Required	TRC10 token bandwidth details (key = token ID; empty object if no TRC10)	—

Permissions

Field	Type	Required	Description	Unit/Precision
`activePermissions`	array	Required	Active permissions list (includes `keys`/`threshold`/`id`/`type`/`permission_name`)	—
`ownerPermission`	object	Optional	Owner permission (includes `keys`/`threshold`/`permission_name`); present for EOAs with `accountType=0` that have on-chain permission configuration; contract addresses (`accountType=2`) typically do not have this field	—
`witnessPermission`	object	Optional	SR permission; only present for SR accounts	—

Account analytics (conditional fields)

Field	Type	Required	Description	Unit/Precision
`avgBandwidthUsageRatio`	number	Optional	Average recent bandwidth usage ratio; code-derived from Greason v5 scan, expected in high-activity account scenarios (reproducing sample pending)	—
`avgEnergyUsageRatio`	number	Optional	Average recent energy usage ratio; code-derived from Greason v5 scan, expected in high-activity account scenarios (reproducing sample pending)	—
`nrOfTokenHolders`	integer	Optional	Number of holders of tokens issued by this account; only returned for token-issuing accounts (reproducing sample pending)	—
`publicTagDesc`	string	Optional	Public label description; only returned for verified well-known accounts such as exchanges and project accounts (reproducing sample pending)	—
`transferCount`	integer	Optional	Total number of token transfers for this account; code-derived from Greason v5 scan (reproducing sample pending)	—

Contract map

Field	Type	Required	Description	Unit/Precision
`contractMap`	object	Optional	Address → boolean map of whether it is a contract; not returned for accounts with public labels (e.g. Binance)	—

withPriceTokens[] elements

Field	Type	Required	Description	Unit/Precision
`tokenId`	string	Required	Token contract address (Base58); TRX placeholder is `_`	—
`tokenAbbr`	string	Required	Token abbreviation (e.g. `USDT` / `TRX`)	—
`tokenName`	string	Required	Token name	—
`tokenDecimal`	integer	Required	Decimal precision (required to convert the `amount` field)	—
`tokenCanShow`	integer	Required	Whether displayable (`1` yes / `0` no)	—
`tokenType`	string	Required	Token type (`trc10` / `trc20` / `trc721` / `trc1155`)	—
`tokenLogo`	string	Required	Token logo URL	—
`tokenLevel`	string	Required	Token level	—
`vip`	boolean	Required	Whether it is a VIP token	—
`balance`	string	Required	Balance (raw value string)	Requires tokenDecimal to convert
`amount`	string	Required	Converted quantity (decimal string)	—
`tokenPriceInTrx`	number	Optional	Token price in TRX; absent if no price	—

Example

Example is a representative excerpt; the full field contract (including all “Always” fields) is in §5 above.


{
  "address": "TSTVYwFDp7SBfZk7Hrz3tucwQVASyJdwC7",
  "name": "",
  "accountType": 0,
  "balance": 0,
  "balanceStr": "0",
  "totalTransactionCount": 8,
  "transactions": 7,
  "transactions_in": 4,
  "transactions_out": 2,
  "date_created": 1625827644000,
  "latest_operation_time": 1670818821000,
  "activated": true,
  "witness": 0,
  "voteTotal": 0,
  "feedbackRisk": false,
  "reward": 1,
  "rewardNum": 0,
  "freezing": 0,
  "canWithdrawAmountV2": 0,
  "announcement": "",
  "addressTagLogo": "",
  "publicTag": "",
  "redTag": "",
  "greyTag": "",
  "blueTag": "",
  "blueTagUrl": "",
  "representative": {
    "lastWithDrawTime": 0,
    "allowance": 0,
    "enabled": false,
    "url": ""
  },
  "totalFrozen": 0,
  "frozenForBandWidth": 0,
  "frozenForEnergy": 0,
  "frozenForBandwidthValue": 0,
  "frozenForEnergyValue": 0,
  "delegateFrozenForBandWidth": 0,
  "delegateFrozenForEnergy": 0,
  "acquiredDelegateFrozenForBandWidth": 0,
  "acquiredDelegateFrozenForEnergy": 0,
  "frozen": { "total": 0, "balances": [] },
  "frozen_supply": [],
  "totalFrozenV2": 0,
  "frozenForBandWidthV2": 0,
  "frozenForEnergyV2": 0,
  "unfreezeV2": 0,
  "frozenForBandwidthV2Value": 0,
  "frozenForEnergyV2Value": 0,
  "delegatedFrozenV2BalanceForBandwidth": 0,
  "delegatedFrozenV2BalanceForEnergy": 0,
  "acquiredDelegatedFrozenV2BalanceForBandwidth": 0,
  "acquiredDelegatedFrozenV2BalanceForEnergy": 0,
  "totalNet": 600,
  "totalNetRemaining": 600,
  "totalEnergy": 0,
  "totalEnergyRemaining": 0,
  "netCost": 0.0,
  "energyCost": 0.0,
  "accountResource": { "frozen_balance_for_energy": {} },
  "allowExchange": [],
  "bandwidth": {
    "freeNetLimit": 600,
    "freeNetUsed": 0,
    "freeNetRemaining": 600,
    "freeNetPercentage": 0.0,
    "netLimit": 0,
    "netUsed": 0,
    "netRemaining": 0,
    "netPercentage": 0.0,
    "energyLimit": 0,
    "energyUsed": 0,
    "energyRemaining": 0,
    "energyPercentage": 0.0,
    "totalNetLimit": 43200000000,
    "totalNetWeight": 0,
    "totalEnergyLimit": 180000000000,
    "totalEnergyWeight": 0,
    "storageLimit": 0,
    "storageUsed": 0,
    "storageRemaining": 0,
    "storagePercentage": 0.0,
    "assets": {}
  },
  "activePermissions": [
    {
      "keys": [{ "address": "TSTVYwFDp7SBfZk7Hrz3tucwQVASyJdwC7", "weight": 1 }],
      "threshold": 1,
      "id": 2,
      "type": "Active",
      "permission_name": "active"
    }
  ],
  "ownerPermission": {
    "keys": [{ "address": "TSTVYwFDp7SBfZk7Hrz3tucwQVASyJdwC7", "weight": 1 }],
    "threshold": 1,
    "permission_name": "owner"
  },
  "contractMap": {
    "TSTVYwFDp7SBfZk7Hrz3tucwQVASyJdwC7": false
  },
  "withPriceTokens": [
    {
      "tokenId": "_",
      "tokenName": "trx",
      "tokenAbbr": "trx",
      "tokenDecimal": 6,
      "tokenType": "trc10",
      "tokenCanShow": 1,
      "tokenLogo": "https://static.tronscan.org/production/logo/trx.png",
      "balance": "0",
      "amount": "0.000000",
      "tokenPriceInTrx": 1,
      "vip": false
    }
  ]
}

5. Errors

For HTTP status codes, see Common Errors. Notes for this endpoint:

API Key Required: returns 401 if not provided (see Common Network & Authentication).
Invalid address: passing a malformed address may return an empty object or default values rather than an explicit error.
Empty result is not an error: an unactivated address returns 200 + activated: false, which is a normal response.