LogoLogo
  • Xverse API
  • โ–ถ๏ธGet Started
  • ๐Ÿ“šAPI reference
    • Bitcoin
      • ๐Ÿ“ฆOutputs
      • ๐Ÿ“ซAddress
        • UTXO
        • Balance
        • Transactions
          • Unconfirmed
      • ๐Ÿ“Transactions
        • History
    • ๐Ÿ–ผ๏ธOrdinals
      • Address
        • ๐Ÿ“ฆUTXO
        • ๐Ÿ–ผ๏ธInscriptions
        • ๐Ÿ”ณRunes
        • ๐Ÿช™BRC-20
      • โœ๏ธInscription Service
        • Estimate
        • Order
          • Execute
    • ๐Ÿ”ฒRunes
      • Rune balances
      • โ›๏ธMint Rune
        • Estimate
        • Order
          • Execute
      • ๐Ÿš€Etch Rune
        • Estimate
        • Order
          • Execute
      • ๐Ÿ”ฒRune Data
    • ๐Ÿช™BRC-20
      • ๐Ÿช™BRC-20 balances
      • โ›๏ธMint BRC-20
        • Estimate
        • Order
          • Execute
      • ๐Ÿš€Deploy BRC-20
        • Estimate
        • Order
          • Execute
    • ๐Ÿ”„Swaps
      • ๐Ÿช™Get destination tokens
      • ๐ŸงพGet quotes
      • ๐Ÿ”ฒRunes Swaps
        • Place order
        • Execute order
      • ๐Ÿ“ฆUTXO
        • Get utxos
        • Place order
        • Execute order
      • ๐Ÿ”ดStacks Swaps
        • Place order
        • Execute order
      • ๐Ÿ”€Crosschain Swaps
        • Place order
  • Specification
Powered by GitBook
On this page
Export as PDF
  1. API reference
  2. Ordinals
  3. Address

UTXO

PreviousAddressNextInscriptions
๐Ÿ“š
๐Ÿ–ผ๏ธ
๐Ÿ“ฆ
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
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"
        }
      ]
    }
  ]
}