🖼️Collections

This endpoint returns all Ordinal collections held by a given wallet address, along with the list of inscriptions owned within each collection.

get

Fetch inscriptions by collection for assets in a specific address.

Authorizations

apiKey

x-api-keystringRequired

Path parameters

addressstring · BitcoinAddress · min: 10RequiredDefault: bc1q0egjvlcfq77cxd9kvpgppyuxckzvws46e3sxch

Query parameters

offsetnumberOptionalDefault: 0

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

Responses

200

Collection info for 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

/v1/ordinals/address/{address}/collections

HTTPcURLJavaScriptPython

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

{
  "limit": 1,
  "offset": 1,
  "totalCollections": 1,
  "totalInscriptions": 1,
  "items": [
    {
      "id": "text",
      "symbol": "text",
      "name": "text",
      "description": "text",
      "supply": "text",
      "holderCount": "text",
      "floorPrice": {
        "valueInSats": "text",
        "valueInUsd": "text",
        "percentageChange24h": {
          "valueInSats": "text",
          "valueInUsd": "text"
        }
      },
      "marketCap": {
        "valueInSats": "text",
        "valueInUsd": "text"
      },
      "volume24h": {
        "valueInSats": "text",
        "valueInUsd": "text",
        "percentageChange": {
          "valueInSats": "text",
          "valueInUsd": "text"
        }
      },
      "links": {
        "coinMarketCap": "text",
        "telegram": "text",
        "twitter": "text",
        "discord": "text",
        "website": "text"
      },
      "total": 1,
      "inscriptionSubset": [
        {
          "id": "text",
          "number": 1,
          "contentType": "text"
        }
      ]
    }
  ]
}