GET
/
addresses
/
{address}
/
balance
/
historical
Historical Satoshi Balance by Address
curl --request GET \
  --url https://xbt-mainnet.gomaestro-api.org/v0/addresses/{address}/balance/historical \
  --header 'api-key: <api-key>'
{
  "data": [
    {
      "confirmations": 932,
      "height": 899903,
      "sat_balance": "155191",
      "timestamp": "2025-06-05 12:34:23",
      "unix_timestamp": 1749126863,
      "usd_balance": "163.59"
    },
    {
      "confirmations": 931,
      "height": 899904,
      "sat_balance": "155191",
      "timestamp": "2025-06-05 12:34:52",
      "unix_timestamp": 1749126892,
      "usd_balance": "163.59"
    },
    {
      "confirmations": 930,
      "height": 899905,
      "sat_balance": "155191",
      "timestamp": "2025-06-05 12:35:24",
      "unix_timestamp": 1749126924,
      "usd_balance": "163.56"
    }
  ],
  "last_updated": {
    "block_hash": "000000000000000000014ba9b2d30d9c737423c753c5b6a27989815ed50afe04",
    "block_height": 900834
  },
  "next_cursor": null
}

Authorizations

api-key
string
header
required

Project API Key

Path Parameters

address
string
required

Bitcoin address or hex encoded script pubkey

Query Parameters

order
enum<string>
default:asc

The order in which the results are sorted. Supported values: asc, desc

Available options:
asc,
desc
count
integer
default:100

The max number of results per page

Required range: x >= 0
from
integer | null

Return only blocks included on or after a specific height or timestamps. If this parameter is not provided, the starting point will be the first block where the address has seen its balance increase or decrease.

Required range: x >= 0
to
integer | null

Return only blocks included on or before a specific height or timestamp

Required range: x >= 0
cursor
string | null

Pagination cursor string, use the cursor included in a page of results to fetch the next page

height_params
boolean | null

Whether the from and to integer query params should be read as timestamps or as block heights. True (the default) means from and to params should be read as block heights.

Response

200
application/json

Requested data

The response is of type object.