---
title: "Get balance history"
method: GET
path: "/v1/accounts/{address}/balance_history"
tags: ["Accounts"]
---

# Get balance history

`GET /v1/accounts/{address}/balance_history`

## Request

- Base URL: `https://api.tzkt.io`
- URL: `https://api.tzkt.io/v1/accounts/{address}/balance_history`
- Auth: none declared

Returns time series with historical balances* (only changes, without duplicates).  
\* - for non-baker tz-accounts historical balances do not include staked tez,
because stakers do not really have staked tez on their balance, they have staking pseudotokens instead.
If you want to get a full historical balance, including staked tez, use the Tezos node RPC:
`/chains/main/blocks/{level}/context/contracts/{address}/full_balance`.

## Path parameters

- `address` string, required

## Query parameters

- `step` integer, nullable
- `select` SelectParameter
  - `fields` string[], nullable: **Fields** selection mode (optional, i.e. `select.fields=balance` is the same as `select=balance`). \ Specify a comma-separated list of fields to include into response. Example: `?select=address,balance` => `[ { "address": "asd", "balance": 10 } ]`.
  - `values` string[], nullable: **Values** selection mode. \ Specify a comma-separated list of fields to include their values into response. Example: `?select.values=address,balance` => `[ [ "asd", 10 ] ]`.
- `sort` SortParameter
  - `asc` string, nullable: **Ascending** sort mode (optional, i.e. `sort.asc=id` is the same as `sort=id`). \ Specify a field name to sort by. Example: `?sort=balance`.
  - `desc` string, nullable: **Descending** sort mode. \ Specify a field name to sort by descending. Example: `?sort.desc=id`.
- `offset` integer
- `limit` integer
- `quote` 'None' | 'Btc' | 'Eur' | 'Usd' | 'Cny' | 'Jpy' | 'Krw' | 'Eth' | 'Gbp'

## Response `200`

- HistoricalBalance[]
  - `level` integer: Height of the block at which the account balance was calculated
  - `timestamp` string, date-time: Timestamp of the block at which the account balance was calculated
  - `balance` integer: Historical balance
  - `quote` QuoteShort
    - `btc` number, double, nullable: XTZ/BTC price
    - `eur` number, double, nullable: XTZ/EUR price
    - `usd` number, double, nullable: XTZ/USD price
    - `cny` number, double, nullable: XTZ/CNY price
    - `jpy` number, double, nullable: XTZ/JPY price
    - `krw` number, double, nullable: XTZ/KRW price
    - `eth` number, double, nullable: XTZ/ETH price
    - `gbp` number, double, nullable: XTZ/GBP price

---

[API](https://skmtc.dev/tzkt/apis/tzkt-api.md) - [All operations](https://skmtc.dev/tzkt/apis/tzkt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tzkt/apis/tzkt-api/revisions/a2e2aba5e534?raw)