Documentation / API reference / RPC Live
Live: Get Free TAO Balance
Reference
Last reviewed 2026-09-18
Returns an account's live chain balance information, including free, reserved and frozen balances, locks and nonce.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | path | string | Yes | coldkey address |
Responses
200 — Response
| Field | Type | Required |
|---|---|---|
at | object | Yes |
at.hash | string | Yes |
at.height | string | Yes |
feeFrozen | string | Yes |
free | string | Yes |
frozen | string | Yes |
locks | array | Yes |
locks[].amount | string | Yes |
locks[].id | string | Yes |
locks[].reasons | string | Yes |
miscFrozen | string | Yes |
nonce | string | Yes |
reserved | string | Yes |
tokenSymbol | string | Yes |
Example response
json
{}Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.