Live: Get Free Tao Balance

Endpoint

GET /api/v1/live/accounts/{address}/balance-info

Parameters

Name	In	Type	Required	Description
address	path	string	✅	coldkey address

Responses

200 —

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "at",
    "feeFrozen",
    "free",
    "frozen",
    "locks",
    "miscFrozen",
    "nonce",
    "reserved",
    "tokenSymbol"
  ],
  "properties": {
    "at": {
      "type": "object",
      "required": [
        "hash",
        "height"
      ],
      "properties": {
        "hash": {
          "type": "string"
        },
        "height": {
          "type": "string"
        }
      }
    },
    "feeFrozen": {
      "type": "string"
    },
    "free": {
      "type": "string"
    },
    "frozen": {
      "type": "string"
    },
    "locks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "amount",
          "reasons"
        ],
        "properties": {
          "amount": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "reasons": {
            "type": "string"
          }
        }
      }
    },
    "miscFrozen": {
      "type": "string"
    },
    "nonce": {
      "type": "string"
    },
    "reserved": {
      "type": "string"
    },
    "tokenSymbol": {
      "type": "string"
    }
  }
}

Examples

{
  "Result": {
    "value": "{}"
  }
}

Try it

Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).

Authentication

All Taostats API requests require an Authorization header containing your API key. See Getting Started.