Skip to main content
GET
/
addresses
/
{address}
/
runes
/
utxos
Rune UTxOs by Address
curl --request GET \
  --url https://xbt-mainnet.gomaestro-api.org/v0/addresses/{address}/runes/utxos \
  --header 'api-key: <api-key>'
{
  "data": [
    {
      "confirmations": 13636,
      "height": 876954,
      "runes": [
        {
          "amount": "2500000",
          "rune_id": "876947:7"
        }
      ],
      "satoshis": "546",
      "txid": "67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b",
      "vout": 3
    },
    {
      "confirmations": 13636,
      "height": 876954,
      "runes": [
        {
          "amount": "2500000",
          "rune_id": "876947:7"
        }
      ],
      "satoshis": "546",
      "txid": "67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b",
      "vout": 4
    },
    {
      "confirmations": 13636,
      "height": 876954,
      "runes": [
        {
          "amount": "2500000",
          "rune_id": "876947:7"
        }
      ],
      "satoshis": "546",
      "txid": "67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b",
      "vout": 5
    },
    {
      "confirmations": 13636,
      "height": 876954,
      "runes": [
        {
          "amount": "2500000",
          "rune_id": "876947:7"
        }
      ],
      "satoshis": "546",
      "txid": "67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b",
      "vout": 6
    },
    {
      "confirmations": 13636,
      "height": 876954,
      "runes": [
        {
          "amount": "2500000",
          "rune_id": "876947:7"
        }
      ],
      "satoshis": "546",
      "txid": "67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b",
      "vout": 7
    },
    {
      "confirmations": 13636,
      "height": 876954,
      "runes": [
        {
          "amount": "2500000",
          "rune_id": "876947:7"
        }
      ],
      "satoshis": "546",
      "txid": "67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b",
      "vout": 8
    },
    {
      "confirmations": 13636,
      "height": 876954,
      "runes": [
        {
          "amount": "2500000",
          "rune_id": "876947:7"
        }
      ],
      "satoshis": "546",
      "txid": "67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b",
      "vout": 9
    }
  ],
  "last_updated": {
    "block_hash": "00000000000000000000e0b35ac5973cb61e9994c78b83d20f75f4b8f8d54fff",
    "block_height": 890589
  },
  "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

​
rune
string | null

Return only UTxOs containing a specific Rune, specified either by the Rune ID (etching block number and transaction index) or name (spaced or un-spaced)

​
order_by
enum<string>
default:height

The property by which response items should be sorted. Supported values: height (height of block which produced the UTxO - default), amount (amount of runes in UTxO)

Available options:
height,
amount
​
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
​
cursor
string | null

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

​
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

Response

Requested data

​
data
object[]
required
​
last_updated
object
required
​
next_cursor
string | null
⌘I