---
title: "Get account balance history."
method: GET
path: "/api/v2/balancehistory/{descriptor}"
tags: ["Accounts"]
---

# Get account balance history.

`GET /api/v2/balancehistory/{descriptor}`

Returns balance history points for an address, XPUB, or descriptor.
from and to are Unix timestamps. groupBy is an aggregation interval in
seconds and defaults to 3600. When fiatcurrency is omitted, rates can
contain all available currencies. sentToSelf is the amount sent from an
address to itself or within addresses of the same XPUB.

Load estimate: High; grows with account transaction history, time span,
grouping cardinality, fiat rate lookups, and XPUB/descriptor gap.

## Path parameters

- `descriptor` string, required

## Query parameters

- `from` integer
- `to` integer
- `fiatcurrency` string
- `groupBy` integer
- `gap` integer

## Response `200`

Balance history points.

- BalanceHistory[]
  - `time` integer, required
  - `txs` integer, required
  - `received` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `sent` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `sentToSelf` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `rates` object
  - `txid` string

## Other responses

- `default` — Public API error. Public validation errors are HTTP 400; internal errors are HTTP 500.

---

[API](https://skmtc.dev/trezor/apis/blockbook-api.md) · [All operations](https://skmtc.dev/trezor/apis/blockbook-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trezor/blockbook-api/revisions/01c375da86bc/schema)