Documentation / API reference / Stake Balance
Get Stake Balance Sum In TAO
Reference
Last reviewed 2026-09-18
Returns the latest total staked balance per coldkey, valued in TAO, with its rank. Use this endpoint for wallet-level totals rather than individual hotkey and subnet positions.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
coldkey | query | string | SS58 or hex format | |
total_balance_as_tao_min | query | string | in rao | |
total_balance_as_tao_max | query | string | in rao | |
page | query | integer (int32) | The page number of the response. | |
limit | query | integer (int32) | The number of responses. max is 200, | |
order | query | string | One of total_balance_as_tao_asc, total_balance_as_tao_desc. |
Responses
200 — Stake balances retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].block_number | integer (int32) | Yes | |
data[].coldkey | object | Yes | |
data[].coldkey.hex | string | Yes | The hex format of the hot key |
data[].coldkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].rank | integer (int32) | Yes | |
data[].timestamp | string (date-time) | Yes | |
data[].total_balance_as_tao | string | Yes | |
pagination | object | Yes | |
pagination.current_page | integer (int32) | Yes | |
pagination.next_page | integer (int32), nullable | ||
pagination.per_page | integer (int32) | Yes | |
pagination.prev_page | integer (int32), nullable | ||
pagination.total_items | integer (int32) | Yes | |
pagination.total_pages | integer (int32) | Yes |
Example response
json
{
"data": [
{
"block_number": 5329782,
"coldkey": {
"hex": "0x8aadfd659682487db6cb8e41e827056374743295cfad120270bc151e20883324",
"ss58": "5FCY9iJYwghetXjE6xiYTj9g3HVW2K7E6JswWnR7PosJCRK9"
},
"rank": 1,
"timestamp": "2025-04-11T18:30:00Z",
"total_balance_as_tao": "237118176177808"
},
{
"block_number": 5329782,
"coldkey": {
"hex": "0x94d412dc09782a38b2dd3fef97b96b8245b1b96843559fe89592c88ed3bb6531",
"ss58": "5FRqwexkxqXLg4frDhGKM6rCw2y32JWojQ6JV6zBgzhnhq7r"
},
"rank": 2,
"timestamp": "2025-04-11T18:30:00Z",
"total_balance_as_tao": "205001033601602"
}
],
"pagination": {
"current_page": 1,
"next_page": 2,
"per_page": 50,
"prev_page": null,
"total_items": 37318,
"total_pages": 747
}
}Response details
text
{
"block_number": 5329782,
"rank": 2,wallet rank
"timestamp": "2025-04-11T18:30:00Z",
"coldkey": {
"ss58": "5FRqwexkxqXLg4frDhGKM6rCw2y32JWojQ6JV6zBgzhnhq7r",
"hex": "0x94d412dc09782a38b2dd3fef97b96b8245b1b96843559fe89592c88ed3bb6531"
},
"total_balance_as_tao": "205001033601602" in rao
},Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Stake balances not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.