Holders by Collection

This endpoint is commonly used to pass an ordinal collection ID, and get the full list of wallets holding inscriptions in that collection, and the number of items of the collection they hold.

get

Get unique holders of an Ordinals collection.

Authorizations

Path parameters

collectionIdstringRequiredExample: {"value":"wzrds"}

Query parameters

offsetnumberOptionalDefault: 0

limitnumber · max: 25OptionalDefault: 10

Responses

200

Default Response

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/collections/{collectionId}/holders HTTP/1.1
Host: api.secretkeylabs.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "total": 1,
  "offset": 1,
  "limit": 1,
  "items": [
    {
      "inscriptionCount": 1,
      "address": "text"
    }
  ]
}