get_account
The get_account method returns a detailed object containing various attributes and resource metrics of a specific EOS blockchain account.
Example use cases
Fetching Account Details
Developers or users may need to retrieve specific details about an account, such as the account's balance, permissions, resource allocation (CPU, NET, and RAM usage), and other parameters.
Checking Resource Allocation & Consumption
get_account can be used to monitor the amount of network, CPU, and RAM resources an account has allocated and consumed. This can help users manage their resources more effectively to ensure their dApps run smoothly.
Monitoring Staked & Unstaked Tokens
Users can utilize this method to check the status of their tokens, whether they are staked or unstaked, and make decisions about staking and unstaking based on this information.
Parameters
parameter | type | description |
|---|---|---|
accountName | string (required) | A 12-character unique identifier for the account. Allowed characters: a-z, 1-5, and '.' |
Return Object
field | type | description |
|---|---|---|
account_name | string | The name of the requested account. |
head_block_num | integer | Latest block number at the time of the request. |
head_block_time | string | Timestamp of the latest block at the time of the request. |
last_code_update | string | Timestamp of the last smart contract update. |
created | string | Timestamp when the account was created. |
refund_request | object | Pending refund request from unstaking resources. |
ram_quota | integer | Total RAM allocated to the account. |
net_limit | object | Available network bandwidth resources. |
cpu_limit | object | Available CPU resources. |
total_resources | object | Summary of allocated RAM, CPU, and NET. |
core_liquid_balance | string | Available balance of the core token (EOS). |
self_delegated_bandwidth | object | Bandwidth the account delegated to itself. |
net_weight | integer | Staked network bandwidth weight. |
cpu_weight | integer | Staked CPU weight. |
ram_usage | integer | RAM currently consumed. |
privileged | boolean | Whether the account has privileged permissions. |
permissions | array | Permission structures, keys, and custom permissions. |
voter_info | object | Voting-related information such as proxies and staked amounts. |
Response Example
get_account Response