GET
/
addresses
/
{address}
/
utxos
UTxOs by Address
curl --request GET \
  --url https://xbt-mainnet.gomaestro-api.org/v0/addresses/{address}/utxos \
  --header 'api-key: <api-key>'
{
  "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 | 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)

count
integer
default:100

The max number of results per page

Required range: x >= 0
order
enum<string>
default:asc

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

Available options:
asc,
desc
from
integer | null

Return only UTxOs created on or after a specific height

Required range: x >= 0
to
integer | 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

The response is of type object.