Inscriptions | xverse

get

List all confirmed inscriptions an address owns.Note: The Api response includes limit & offset for future pagination extension, but at the moment query parameters are ignored and the response is always the full list. So, limit equals the total items number, be sure to handle pagination as the limit can change once pagination is implemented.

Authorizations

Path parameters

addressstring · BitcoinAddress · min: 10RequiredDefault: bc1q0egjvlcfq77cxd9kvpgppyuxckzvws46e3sxch

Query parameters

offsetnumberOptionalDefault: 0

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

Responses

200

Inscriptions owned by 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}/inscriptions HTTP/1.1
Host: api.secretkeylabs.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 1,
  "offset": 1,
  "total": 1,
  "items": [
    {
      "id": "text",
      "number": 1,
      "address": "text",
      "genesisAddress": "text",
      "genesisBlockHeight": 1,
      "genesisBlockHash": "text",
      "genesisTxid": "text",
      "genesisFee": 1,
      "genesisTimestamp": 1,
      "location": "text",
      "output": "text",
      "offset": 1,
      "satOrdinal": "text",
      "satRarity": "text",
      "satCoinbaseHeight": 1,
      "mimeType": "text",
      "contentType": "text",
      "contentLength": 1,
      "txid": "text",
      "timestamp": 1,
      "value": 1
    }
  ]
}