Sign in

v11

latestOpenAPI 3.1.0AGPL-3.0-onlyraw.githubusercontent.com2026-08-01307390.9 KB
Accounts

Get account balance history.

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.

get/api/v2/balancehistory/{descriptor}

Path parameters

descriptorstring required

Address, XPUB, or supported descriptor. URL-encode descriptors.

Query parameters

frominteger

Unix timestamp lower bound.

tointeger

Unix timestamp upper bound.

fiatcurrencystring
Example:usd

Optional fiat currency code to include in rates.

groupByinteger

Aggregation interval in seconds. Defaults to 3600.

gapinteger

XPUB/address derivation gap limit. Values are capped by the server.

Response

Balance history points.

timeinteger required
txsinteger required
receivedstring

Integer amount in the lowest chain denomination, encoded as a string.

sentstring

Integer amount in the lowest chain denomination, encoded as a string.

sentToSelfstring

Integer amount in the lowest chain denomination, encoded as a string.

ratesobject
txidstring

Example response

[
  {
    "received": "100000000",
    "sent": "100000000",
    "sentToSelf": "100000000"
  }
]