---
title: "Get balance history for a specific account"
method: GET
path: "/tokenization/tokens/{id}/balances/{accountAddress}/history"
tags: ["Tokenization"]
---

# Get balance history for a specific account

`GET /tokenization/tokens/{id}/balances/{accountAddress}/history`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/tokenization/tokens/{id}/balances/{accountAddress}/history`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/tokenization/tokens/:id/balances/:accountAddress/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns paginated balance history for the specified account address with optional time-range filtering.

## Path parameters

- `id` string, required
- `accountAddress` string, required

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time
- `interval` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH'
- `pageCursor` string
- `pageSize` integer
- `sortBy` 'blockTimestamp'
- `order` 'ASC' | 'DESC'

## Response `200`

Successfully retrieved the balance history

- BalanceHistoryPagedResponse
  - `data` BalanceHistoryItemDto[], required: Array of balance history data points
    - `timestamp` string, date-time, required: Timestamp of the data point
    - `balance` string, required: Balance at the given timestamp
  - `next` string: Cursor for next page
  - `prev` string: Cursor for previous page
  - `total` number: Total count of items

## Other responses

- `404`: Token not found
- `default`: Error Response

---

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