---
title: "Get TRON account resources and resource delegations"
method: POST
path: "/api/v2/{coin}/wallet/{walletId}/getAccount"
tags: ["Wallet"]
---

# Get TRON account resources and resource delegations

`POST /api/v2/{coin}/wallet/{walletId}/getAccount`

Retrieves frozenV2 balances, resource delegation fields, network conversion
ratios, and spendable bandwidth/energy for TRON addresses from a single
getaccountresource call per address. Ratios are returned raw; callers
convert frozenV2 amounts to energy/bandwidth units.

per address — consequence: a second call can drift a block so usage would
not match energyRatio/bandwidthRatio
on each account — consequence: the resources page MUST NOT also call
getAccountResources

## Path parameters

- `coin` string, required — A cryptocurrency symbol or token ticker symbol
- `walletId` string, required

## Request body

- object — Addresses to query for TRON frozenV2, resource delegation, and spendable usage. Each address is looked up via TRON getaccount and getaccountresource in parallel so frozenV2, conversion ratios, and usage come from the same block. Addresses that do not belong to the wallet are returned in failedAddresses. The resources page SHOULD call this endpoint instead of also calling getAccountResources.
  - `addresses` string[], required
  - `destinationAddress` string — Optional destination address for resource deficit calculation (token transfers)

## Response `200`

OK

- GetAccountResponse
  - `accounts` object[], required
    - `frozenV2` object[], required
      - `type` 'BANDWIDTH' | 'ENERGY' | 'TRON_POWER', required
      - `amount` string, required — Frozen TRX amount in SUN (already SUN from IMS; not a TRX→SUN conversion). Decimal integer string, same as bandwidthSunRequired / maxResourcesDelegatable. Missing IMS amounts are returned as "0".
    - `delegatedFrozenV2BalanceForEnergy` string, required — SUN delegated to others for energy. Protobuf-omitted zeros are returned as "0".
    - `acquiredDelegatedFrozenV2BalanceForEnergy` string, required — SUN of energy delegated from others. Protobuf-omitted zeros are returned as "0".
    - `delegatedFrozenV2BalanceForBandwidth` string, required — SUN delegated to others for bandwidth. Protobuf-omitted zeros are returned as "0".
    - `acquiredDelegatedFrozenV2BalanceForBandwidth` string, required — SUN of bandwidth delegated from others. Protobuf-omitted zeros are returned as "0".
    - `energyRatio` number, required — TotalEnergyLimit / TotalEnergyWeight from the paired getaccountresource call. 0 when unavailable.
    - `bandwidthRatio` number, required — TotalNetLimit / TotalNetWeight from the paired getaccountresource call. 0 when unavailable.
    - `address` string, required — TRON address these resource and usage fields belong to
    - `freeBandwidthAvailable` number, required — Spendable free bandwidth remaining
    - `freeBandwidthUsed` number, required
    - `stakedBandwidthAvailable` number, required
    - `stakedBandwidthUsed` number, required
    - `energyAvailable` number, required
    - `energyUsed` number, required
    - `resourceDeficitForAssetTransfer` TronResourceDeficit — Shared TRON account-resource response codecs used by getAccount and getAccountResources. Request bodies stay in each route file so OpenAPI keeps per-operation @title / description.
      - `bandwidthDeficit` number, required
      - `bandwidthSunRequired` string, required
      - `energyDeficit` number
      - `energySunRequired` string
    - `maxResourcesDelegatable` MaxResourcesDelegatable
      - `bandwidthSun` string, required
      - `energySun` string, required
    - `TotalNetLimit` number — Live total network bandwidth limit (same value for all addresses)
    - `TotalNetWeight` number — Live total staked TRX for bandwidth (same value for all addresses)
    - `TotalEnergyLimit` number — Live total network energy limit (same value for all addresses)
    - `TotalEnergyWeight` number — Live total staked TRX for energy (same value for all addresses)
  - `failedAddresses` object[], required
    - `address` string, required
    - `error` string, required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-09-11** `021ae042735e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bitgo/apis/bitgo-api/changes/api/v2/:coin/wallet/:walletId/getAccount/post.md)

---

[API](https://skmtc.dev/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.dev/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitgo/apis/bitgo-api/revisions/d083f3244790?raw)