--- title: "Get account info by address" method: GET path: "/v1/accounts/{address}" --- # Get account info by address `GET /v1/accounts/{address}` ## Request - Base URL: `https://api.shasta.trongrid.io` - URL: `https://api.shasta.trongrid.io/v1/accounts/{address}` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `address` string, required ## Query parameters - `only_confirmed` boolean - `only_unconfirmed` boolean ## Response `200` 200 - object - `data` object[] - `address` string: Account address. (Format: hex) - `balance` integer: TRX balance. (Unit: `sun`) - `account_name` string: Account name. - `create_time` integer: The timestamp for when the account was created. (Unit: millisecond) - `is_witness` boolean: Indicates if the account is a Super Representative (SR), an SR Partner or an SR candidate. - `allowance` integer: The amount of rewards that can be withdrawn by the account. (Unit: `sun`) - `latest_withdraw_time` integer: The timestamp of the account's last withdrawal of rewards. (Unit: millisecond) - `latest_opration_time` integer: The timestamp of the account's last operation. (Unit: millisecond) - `latest_consume_time` integer: The timestamp of the account's last Bandwidth consumption. (Unit: millisecond) - `latest_consume_free_time` integer: The timestamp of the account's last free Bandwidth consumption. (Unit: millisecond) - `net_window_size` integer: The duration, in blocks, required for staked Bandwidth to fully recover.\ Note: The value has a decimal precision of 3 if `net_window_optimized` is `true`, otherwise 0. - `net_window_optimized` boolean: Whether the Bandwidth recovery window optimization is enabled. - `account_resource` object - `latest_consume_time_for_energy` integer: The timestamp of the account's last Energy consumption. (Unit: millisecond) - `acquired_delegated_frozen_balance_for_energy` integer: The total amount of TRX staked by other accounts for this account's energy. (Unit: sun, For Stake 1.0) - `delegated_frozen_balance_for_energy` integer: The total amount of TRX staked by this account for other accounts' energy. (Unit: sun, For Stake 1.0) - `energy_window_size` integer: The duration, in blocks, required for Energy to fully recover. Note: The value has a decimal precision of 3 if `energy_window_optimized` is `true`, otherwise 0. - `acquired_delegated_frozenV2_balance_for_energy` integer: The total amount of TRX staked by other accounts for this account's Energy. (Unit: sun, For Stake 2.0) - `delegated_frozenV2_balance_for_energy` integer: The total amount of TRX staked by this account for other accounts' Energy. (Unit: sun, For Stake 2.0) - `energy_window_optimized` boolean: Whether the Energy recovery window optimization is enabled. - `frozen_balance_for_energy` object - `frozen_balance` integer: The total amount of TRX staked for Energy by this account. (Unit: sun, For Stake 1.0) - `expire_time` integer: The timestamp when the `unstake` operation becomes available for the staked Energy. (Unit: millisecond, For Stake 1.0) - `energy_usage` integer: The amount of Energy used. - `frozen` object[] - `frozen_balance` integer: The total amount of TRX staked for Bandwidth by this account. (Unit: sun, For Stake 1.0) - `expire_time` integer: The timestamp when the `unstake` operation becomes available for the staked Bandwidth. (Unit: millisecond, For Stake 1.0) - `owner_permission` object - `permission_name` string: Owner permission name. - `threshold` integer: The minimum combined weight of signatures required to validate an operation using this permission. - `keys` object[] - `address` string: The address associated with the owner permission. - `weight` integer: The signature weight of the corresponding address. - `active_permission` object[] - `type` string: The type of the permission. (Value: `Active`) - `id` integer: Active Permission ID. (Automatically assigned from 2) - `permission_name` string: Permission name. - `threshold` integer: The minimum combined weight of signatures required to validate an operation using this permission. - `operations` string: A string representing the operations allowed by this permission. Note: This is a 32-byte hex string where each bit corresponds to a specific operation. See details [here](https://developers.tron.network/docs/multi-signature#active-permissions) . - `keys` object[] - `address` string: The address associated with this active permission. - `weight` integer: The signature weight of the address. - `witness_permission` object - `type` string: The type of the permission. (Value: `Witness`) - `id` integer: The fixed ID for the witness permission. (Value: `1`) - `permission_name` string: Permission name. - `threshold` integer: Witness Permission threshold. - `keys` object[] - `address` string: The address of the key associated with this witness permission. - `weight` integer: The signature weight of the address. - `frozenV2` object[] - `amount` integer: The total amount of TRX staked to obtain the resource type specified by `data.frozenV2[i].type`. (Unit: sun, For Stake 2.0) - `type` string: The type of resource obtained through staking. (Enum: `BANDWIDTH` or `ENERGY`) - `acquired_delegated_frozenV2_balance_for_bandwidth` integer: The total amount of TRX staked by other accounts for this account's Bandwidth. (Unit: sun, For Stake 2.0) - `delegated_frozenV2_balance_for_bandwidth` integer: The total amount of TRX staked by this account for other accounts' Bandwidth. (Unit: sun, For Stake 2.0) - `acquired_delegated_frozen_balance_for_bandwidth` integer: The total amount of TRX staked by other accounts for this account's Bandwidth. (Unit: sun, For Stake 1.0) - `delegated_frozen_balance_for_bandwidth` integer: The total amount of TRX staked by this account for other accounts' Bandwidth. (Unit: sun, For Stake 1.0) - `assetV2` object[] - `key` string: TRC-10 Token ID. - `value` integer: TRC-10 Token balance. - `net_usage` integer: The amount of Bandwidth used. - `free_net_usage` integer: The amount of free Bandwidth used. - `free_asset_net_usageV2` object[] - `key` string: The TRC-10 Token ID. - `value` integer: The total free Bandwidth usage attributed to this TRC-10 token. - `trc20` object[]: TRC-20 balance held by this account. - `votes` object[] - `vote_address` string: The address of the Super Representative (SR) that this account has voted for. - `vote_count` integer: The number of votes cast for the the SR address. - `unfrozenV2` object[]: Stake 2.0 unstaking details. Returned conditionally (only when the account has pending unstaked amounts). - `unfreeze_amount` integer: The amount of TRX being unstaked. (Unit: sun, For Stake 2.0) - `unfreeze_expire_time` integer: The timestamp when the unstaked TRX can be withdrawn. (Unit: millisecond, For Stake 2.0) - `success` boolean: Whether the request was successful. - `meta` object - `page_size` integer: The number of items returned on the current page. - `at` integer: The response timestamp. (Unit: millisecond) ## Other responses - `400`: 400 --- [API](https://skmtc.dev/trongrid/apis/trongrid-v1-api.md) - [All operations](https://skmtc.dev/trongrid/apis/trongrid-v1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trongrid/apis/trongrid-v1-api/revisions/22cc4dd60c4c?raw)