HomeGuidesAPI ReferenceChangelog
GuidesAPI ReferenceCommunityDiscordBlogFAQBug BountyAnnouncementsChange Log
API Reference

Get account info by address

Returns

Field

Type

Description

data.address

String

Account address. (Format: hex)

data.balance

Long

TRX balance. (Unit: sun)

data.account_name

String

Account name.

data.create_time

Long

The timestamp for when the account was created. (Unit: millisecond)

data.is_witness

Boolean

Indicates if the account is a Super Representative (SR), an SR Partner or an SR candidate.

data.allowance

Long

The amount of rewards that can be withdrawn by the account. (Unit: sun)

data.latest_withdraw_time

Long

The timestamp of the account's last withdrawal of rewards. (Unit: millisecond)

data.latest_opration_time

Long

The timestamp of the account's last operation. (Unit: millisecond)

data.latest_consume_time

Long

The timestamp of the account's last Bandwidth consumption. (Unit: millisecond)

data.latest_consume_free_time

Long

The timestamp of the account's last free Bandwidth consumption. (Unit: millisecond)

data.net_window_size

Long

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.

data.net_window_optimized

Boolean

Whether the Bandwidth recovery window optimization is enabled.

data.account_resource.latest_consume_time_for_energy

Long

The timestamp of the account's last Energy consumption. (Unit: millisecond)

data.account_resource.acquired_delegated_frozen_balance_for_energy

Long

The total amount of TRX staked by other accounts for this account's energy. (Unit: sun, For Stake 1.0)

data.account_resource.delegated_frozen_balance_for_energy

Long

The total amount of TRX staked by this account for other accounts' energy. (Unit: sun, For Stake 1.0)

data.account_resource.energy_window_size

Long

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.

data.account_resource.acquired_delegated_frozenV2_balance_for_energy

Long

The total amount of TRX staked by other accounts for this account's Energy. (Unit: sun, For Stake 2.0)

data.account_resource.delegated_frozenV2_balance_for_energy

Long

The total amount of TRX staked by this account for other accounts' Energy. (Unit: sun, For Stake 2.0)

data.account_resource.energy_window_optimized

Boolean

Whether the Energy recovery window optimization is enabled.

data.frozen[0].frozen_balance

Long

The total amount of TRX staked for Bandwidth by this account. (Unit: sun, For Stake 1.0)

data.frozen[0].expire_time

Long

The timestamp when the unstake operation becomes available for the staked Bandwidth. (Unit: millisecond, For Stake 1.0)

data.account_resource.frozen_balance_for_energy.frozen_balance

Long

The total amount of TRX staked for Energy by this account. (Unit: sun, For Stake 1.0)

data.account_resource.frozen_balance_for_energy.expire_time

Long

The timestamp when the unstake operation becomes available for the staked Energy. (Unit: millisecond, For Stake 1.0)

data.account_resource.energy_usage

Long

The amount of Energy used.

data.owner_permission.permission_name

String

Owner permission name.

data.owner_permission.threshold

Integer

The minimum combined weight of signatures required to validate an operation using this permission.

data.owner_permission.keys.address

String

The address associated with the owner permission.

data.owner_permission.keys.weight

Integer

The signature weight of the corresponding address.

data.active_permission.type

String

The type of the permission. (Value: Active)

data.active_permission.id

Integer

Active Permission ID. (Automatically assigned from 2)

data.active_permission.permission_name

String

Permission name.

data.active_permission.threshold

Integer

The minimum combined weight of signatures required to validate an operation using this permission.

data.active_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 .

data.active_permission.keys.address

String

The address associated with this active permission.

data.active_permission.keys.weight

Integer

The signature weight of the address.

data.witness_permission.type

String

The type of the permission. (Value: Witness)

data.witness_permission.id

Integer

The fixed ID for the witness permission. (Value: 1)

data.witness_permission.permission_name

String

Permission name.

data.witness_permission.threshold

Integer

Witness Permission threshold.

data.witness_permission.keys.address

String

The address of the key associated with this witness permission.

data.witness_permission.keys.weight

Integer

The signature weight of the address.

data.frozenV2.[i].amount

Long

The total amount of TRX staked to obtain the resource type specified by data.frozenV2[i].type. (Unit: sun, For Stake 2.0)

data.frozenV2.[i].type

String

The type of resource obtained through staking. (Enum: BANDWIDTH or ENERGY)

data.acquired_delegated_frozenV2_balance_for_bandwidth

Long

The total amount of TRX staked by other accounts for this account's Bandwidth. (Unit: sun, For Stake 2.0)

data.delegated_frozenV2_balance_for_bandwidth

Long

The total amount of TRX staked by this account for other accounts' Bandwidth. (Unit: sun, For Stake 2.0)

data.acquired_delegated_frozen_balance_for_bandwidth

Long

The total amount of TRX staked by other accounts for this account's Bandwidth. (Unit: sun, For Stake 1.0)

data.delegated_frozen_balance_for_bandwidth

Long

The total amount of TRX staked by this account for other accounts' Bandwidth. (Unit: sun, For Stake 1.0)

data.assetV2[i].key

String

TRC-10 Token ID.

data.assetV2[i].value

Long

TRC-10 Token balance.

data.net_usage

Long

The amount of Bandwidth used.

data.free_net_usage

Long

The amount of free Bandwidth used.

data.free_asset_net_usageV2[i].key

String

The TRC-10 Token ID.

data.free_asset_net_usageV2[i].value

Long

The total free Bandwidth usage attributed to this TRC-10 token.

data.trc20

List

TRC-20 balance held by this account.

data.votes.vote_address

String

The address of the Super Representative (SR) that this account has voted for.

data.votes.vote_count

Long

The number of votes cast for the the SR address.

success

Boolean

Whether the request was successful.

meta.page_size

Integer

The number of items returned on the current page.

meta.at

Long

The response timestamp. (Unit: millisecond)

Language
Click Try It! to start a request and see the response here!