Get Account

Endpoint

GET /api/account/latest/v1

Description

Gives most recent coldkey balance (from the database)

Parameters

Name	In	Type	Required	Description
address	query	string		Address String to query.
network	query	string		Finney is the current network. Nakamoto and kusanagi added for historical data.
balance_free_min	query	string		Min free balance in rao
balance_free_max	query	string		in rao
balance_staked_min	query	string		in rao
balance_staked_max	query	string		in rao
balance_total_min	query	string		in rao
balance_total_max	query	string		in rao
order	query	string
page	query	integer		Page of entries to retrieve.
limit	query	integer		Number of entries to return. Max value is 200.

Responses

200 — 200

Media: application/json

{
  "type": "object",
  "properties": {
    "pagination": {
      "type": "object",
      "properties": {
        "current_page": {
          "type": "integer",
          "example": 1,
          "default": 0
        },
        "per_page": {
          "type": "integer",
          "example": 50,
          "default": 0
        },
        "total_items": {
          "type": "integer",
          "example": 205362,
          "default": 0
        },
        "total_pages": {
          "type": "integer",
          "example": 4108,
          "default": 0
        },
        "next_page": {
          "type": "integer",
          "example": 2,
          "default": 0
        },
        "prev_page": {}
      }
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "type": "object",
            "properties": {
              "ss58": {
                "type": "string",
                "example": "5GBnPzvPghS8AuCoo6bfnK7JUFHuyUhWSFD4woBNsKnPiEUi"
              },
              "hex": {
                "type": "string",
                "example": "0xb656ef6d8fa3ae7a7800906b6ea83a7c1320041290002c3ae7b1e4c68b1e4a67"
              }
            }
          },
          "network": {
            "type": "string",
            "example": "finney"
          },
          "block_number": {
            "type": "integer",
            "example": 5011596,
            "default": 0
          },
          "timestamp": {
            "type": "string",
            "example": "2025-02-26T13:52:48Z"
          },
          "rank": {
            "type": "integer",
            "example": 1,
            "default": 0
          },
          "balance_free": {
            "type": "string",
            "example": "777150581296935"
          },
          "balance_staked": {
            "type": "string",
            "example": "0"
          },
          "balance_staked_alpha_as_tao": {
            "type": "string",
            "example": "0"
          },
          "balance_staked_root": {
            "type": "string",
            "example": "0"
          },
          "balance_total": {
            "type": "string",
            "example": "777150581296935"
          },
          "created_on_date": {
            "type": "string",
            "example": "2024-04-09"
          },
          "created_on_network": {
            "type": "string",
            "example": "finney"
          },
          "coldkey_swap": {}
        }
      }
    }
  }
}

400 — 400

Media: application/json

{
  "type": "object",
  "properties": {}
}

Authentication

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