Documentation / New API reference / Accounts
Get Accounts Address
Reference
Last reviewed 2026-10-07
Single account detail with 24hr-ago comparison. Returns a single-element data array (no pagination). A valid address with no stored row gets a zero row, except a protocol account, which gets a 404 (see [unseen_account_detail]).
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | path | string | Yes | SS58 or 0x-hex account address |
Responses
200 — Account detail
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].address | string | Yes | SS58 address. |
data[].alpha_balances | array, nullable | Yes | Per-subnet alpha positions, read live from chain. null when the live read is unavailable (chain unconfigured or read failed), or for an address with no stored row, whose positions are not known (#1304). |
data[].alpha_balances[].balance | string | Yes | Alpha balance (RAO, u64 as string). |
data[].alpha_balances[].balance_as_tao | string | Yes | Alpha as TAO equivalent (RAO, u64 as string). |
data[].alpha_balances[].coldkey | string | Yes | Coldkey (SS58). |
data[].alpha_balances[].hotkey | string | Yes | Validator hotkey (SS58). |
data[].alpha_balances[].netuid | integer (int32) | Yes | Subnet ID. |
data[].alpha_balances_24hr_ago | array, nullable | Yes | Per-subnet alpha positions 24hr ago (chain @ head − 7200, priced from subnet_pool_v1). null if the 24h-ago read is unavailable, or for an address with no stored row (#1304). |
data[].alpha_balances_24hr_ago[].balance | string | Yes | Alpha balance (RAO, u64 as string). |
data[].alpha_balances_24hr_ago[].balance_as_tao | string | Yes | Alpha as TAO equivalent (RAO, u64 as string). |
data[].alpha_balances_24hr_ago[].coldkey | string | Yes | Coldkey (SS58). |
data[].alpha_balances_24hr_ago[].hotkey | string | Yes | Validator hotkey (SS58). |
data[].alpha_balances_24hr_ago[].netuid | integer (int32) | Yes | Subnet ID. |
data[].balance_free | string | Yes | Free balance (RAO, u64 as string). |
data[].balance_free_24hr_ago | string, nullable | Yes | Free balance 24hr ago (RAO, u64 as string), read from chain at block head − 7200. null only if the 24h-ago read is unavailable (see [account_detail]). For an address with no stored row, this and every other *_24hr_ago balance is "0" from the snapshot, not the chain (see [unseen_account_detail]). |
data[].balance_reserved | string | Yes | Reserved balance (RAO, u64 as string). |
data[].balance_reserved_24hr_ago | string, nullable | Yes | Reserved balance 24hr ago (RAO, u64 as string). |
data[].balance_staked | string | Yes | Total staked (RAO, u64 as string). |
data[].balance_staked_24hr_ago | string, nullable | Yes | Total staked 24hr ago (RAO, u64 as string). |
data[].balance_staked_alpha_as_tao | string | Yes | Alpha-staked as TAO equivalent (RAO, u64 as string). |
data[].balance_staked_alpha_as_tao_24hr_ago | string, nullable | Yes | Alpha-staked as TAO 24hr ago (RAO, u64 as string). |
data[].balance_staked_root | string | Yes | Root-staked (RAO, u64 as string). |
data[].balance_staked_root_24hr_ago | string, nullable | Yes | Root-staked 24hr ago (RAO, u64 as string). |
data[].balance_total | string | Yes | Total balance (RAO, u64 as string). |
data[].balance_total_24hr_ago | string, nullable | Yes | Total balance 24hr ago (RAO, u64 as string). |
data[].block_number | integer (int32) | Yes | Block number. |
data[].coldkey_swap | object, nullable | Yes | The executed coldkey swap this account was involved in, as the old or the new coldkey, from coldkey_swap_v1. null if it was never swapped. |
data[].coldkey_swap.block_number | integer (int32) | Yes | Swap block. |
data[].coldkey_swap.network | string | Yes | Network. |
data[].coldkey_swap.new_coldkey | string | Yes | New coldkey (SS58). |
data[].coldkey_swap.old_coldkey | string | Yes | Old coldkey (SS58). |
data[].coldkey_swap.timestamp | string | Yes | Swap time (ISO 8601). |
data[].created_on_date | string, nullable | Yes | Account creation date (YYYY-MM-DD) from account_created_at_v1. null only when the account has no created-at row. |
data[].created_on_network | string, nullable | Yes | Network the account was created on (from account_created_at_v1). null only when the account has no created-at row. |
data[].network | string | Yes | Network name. Always "finney". |
data[].rank | integer (int32) | Yes | Leaderboard rank. |
data[].root_basket_claimable_tao | string, nullable | Yes | TAO this coldkey could realize right now by redeeming its root beta-basket shares across every validator it stakes to (RAO, u64 as string) — read live from the chain's own BetaBasketRuntimeApi::get_root_basket_owed, at the same finalized head as the balances above. null means unknown, never zero: no chain client, the live read failed, the runtime predates Root Reborn (the API does not exist below release 450), or the address has no stored row (#1304). A coldkey that genuinely has nothing owed returns "0". The daily historical series is on /v1/accounts/{address}/history, computed by the indexer rather than read live. Not part of balance_total — it is an entitlement held by the funds, not a balance the coldkey holds. |
data[].root_claim_type | string, nullable | Yes | Always null: the root-claim preference was deleted from the chain at spec 441 and is no longer served (#774, see module docs). |
data[].timestamp | string | Yes | ISO 8601 timestamp. |
400 — Invalid address
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
404 — A protocol account (subnet reserve and other pallet accounts), which the snapshot leaves out
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
500 — Internal server error
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.