📦UTXO

get

Get detailed Ordinals info (inscriptions, rare sats, Runes) for all confirmed UTXOs.

Authorizations

Path parameters

addressstring · BitcoinAddress · min: 10RequiredDefault: bc1q0egjvlcfq77cxd9kvpgppyuxckzvws46e3sxch

Query parameters

offsetnumberOptionalDefault: 0

limitnumber · min: 25 · max: 60OptionalDefault: 60

Responses

200

Ordinal information for all utxos belonging to the address

application/json

400

Invalid input

application/json

401

Unauthorized

application/json

404

Not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

HTTPcURLJavaScriptPython

GET /v1/ordinals/address/{address}/utxo HTTP/1.1
Host: api.secretkeylabs.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 1,
  "offset": 1,
  "total": 1,
  "rareSatsVersion": 1,
  "items": [
    {
      "txid": "text",
      "vout": 1,
      "value": 1,
      "blockHeight": 1,
      "satRanges": [
        {
          "range": {
            "start": "text",
            "end": "text"
          },
          "offset": 1,
          "sattributes": [
            "ALPHA",
            "BLOCK78",
            "FIRST_TRANSACTION",
            "PIZZA",
            "VINTAGE",
            "BLACK_UNCOMMON",
            "BLACK_RARE",
            "BLACK_EPIC",
            "BLACK_LEGENDARY",
            "BLOCK9",
            "BLOCK9_450",
            "BLOCK286",
            "JPEG",
            "LEGACY",
            "OMEGA",
            "FIBONACCI",
            "HITMAN",
            "NAKAMOTO",
            "SILK_ROAD",
            "PALINDROME",
            "1D_PALINDROME",
            "2D_PALINDROME",
            "3D_PALINDROME",
            "PALIBLOCK_PALINDROME",
            "PALINCEPTION",
            "PURE_PALINCEPTION",
            "PERFECT_PALINCEPTION",
            "SEQUENCE_PALINDROME",
            "NAME_PALINDROME",
            "COMMON",
            "UNCOMMON",
            "RARE",
            "EPIC",
            "LEGENDARY",
            "MYTHIC"
          ],
          "yearMined": 1,
          "block": 1,
          "inscriptions": [
            {
              "contentType": "text",
              "id": "text"
            }
          ]
        }
      ],
      "runes": [
        {
          "runeName": "text",
          "amount": "text",
          "divisibility": 1,
          "symbol": "text"
        }
      ]
    }
  ]
}