UTxOs by Address

Retrieves all UTXOs associated with a Bitcoin address or script pubkey. Ideal for wallet views, dust filtering, or balance calculations. Can be tailored to exclude certain categories of UTXOs such as those used in metaprotocols.

GET /addresses/{address}/utxos

UTxOs by Address

cURL

curl --request GET \
  --url https://xbt-mainnet.gomaestro-api.org/v0/addresses/{address}/utxos \
  --header 'api-key: <api-key>'

200

{
  "data": [
    {
      "address": "bc1phyrmjs2jm5c98tldke2ykp0h66lsx3wy0ey8ug2fjj5mxsn8ftqsa24un8",
      "confirmations": 23,
      "height": 2815497,
      "inscriptions": [],
      "runes": [],
      "satoshis": "546",
      "script_pubkey": "00140df0d276eacd58b09a74d5e0288756e8505787f5",
      "txid": "cb9532641412a6fa6f329e8728a8f7554dcaa6cdaec1355bd2bd2903cd61c6eb",
      "vout": 1
    },
    {
      "address": "bc1phyrmjs2jm5c98tldke2ykp0h66lsx3wy0ey8ug2fjj5mxsn8ftqsa24un8",
      "confirmations": 20,
      "height": 2815500,
      "inscriptions": [
        {
          "inscription_id": "47bb5438d366863b25b4b1782af0d0cf0a89a922adce5da81253790d3e651501i0",
          "offset": 0
        }
      ],
      "runes": [
        {
          "amount": "1.00",
          "rune_id": "840000:1"
        }
      ],
      "satoshis": "546",
      "script_pubkey": "00140df0d276eacd58b09a74d5e0288756e8505787f5",
      "txid": "6312095baa2a42dec6aa41888c01fd74ecce2ab139c17a0a6d01d42a89b67953",
      "vout": 1
    }
  ],
  "last_updated": {
    "block_hash": "0000000088bee3b517745636443c8f11aff45209449300a5d8461c336e467925",
    "block_height": 2815520
  },
  "next_cursor": "AAAAAAAq9gxgU3m2iSrUAW0KesE5sSrO7HT9AYyIQarG3kIqqlsJEmNgAAAAAQ"
}

Authorizations

api-key · string · header · required

Project API Key

Path Parameters

address · string · required

Bitcoin address or hex encoded script pubkey

Query Parameters

filter_dust · boolean | null

Ignore UTxOs containing less than 100000 sats

filter_dust_threshold · integer<int64> | null

Ignore UTxOs containing less than specified satoshis

Required range: x >= 0

exclude_metaprotocols · boolean | null

Exclude UTxOs involved in metaprotocols (currently only runes and inscriptions will be discovered, more metaprotocols may be supported in future)

ignore_used_brc20 · boolean | null

When used with exclude_metaprotocols=true, still include UTXOs which only contain used BRC20 inscriptions

count · integer | null · default: 100

The max number of results per page

Required range: x >= 0

order · enum<string> | null · default: asc

The order in which the results are sorted (by height at which UTxO was produced)

Available options: asc, desc

from · integer<int64> | null

Return only UTxOs created on or after a specific height

Required range: x >= 0

to · integer<int64> | null

Return only UTxOs created on or before a specific height

Required range: x >= 0

cursor · string | null

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

Response

200

application/json

Requested data

data · object[] · required

Show child attributes

last_updated · object · required

Show child attributes

next_cursor · string | null