---
title: "Get Account History"
method: GET
path: "/api/account/history/v1"
---

# Get Account History

`GET /api/account/history/v1`

Gives most recent coldkey balance (from the database)

## Query parameters

- `address` string, required
- `network` 'finney' | 'nakamoto' | 'kusanagi'
- `block_number` integer
- `block_start` integer
- `block_end` integer
- `timestamp_start` integer
- `timestamp_end` integer
- `order` 'block_number_asc' | 'block_number_desc' | 'timestamp_asc' | 'timestamp_desc'
- `page` integer
- `limit` integer

## Response `200`

200

- object
  - `pagination` object
    - `current_page` integer
    - `per_page` integer
    - `total_items` integer
    - `total_pages` integer
    - `next_page` integer
    - `prev_page` unknown
  - `data` object[]
    - `address` object
      - `ss58` string
      - `hex` string
    - `network` string
    - `block_number` integer
    - `timestamp` string
    - `rank` integer
    - `balance_free` string
    - `balance_staked` string
    - `balance_staked_alpha_as_tao` string
    - `balance_staked_root` string
    - `balance_total` string
    - `created_on_date` string
    - `created_on_network` string
    - `coldkey_swap` unknown

## Other responses

- `400` — 400

---

[API](https://skmtc.net/taostats/apis/taostats-1.md) · [All operations](https://skmtc.net/taostats/apis/taostats-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/taostats/taostats-1/revisions/eb3af702da52/schema)