GET /nft/holders/{slug}
GET

/v1/nft/holders/{slug}

Collection holder list

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/nft/holders/fuzzybears
Path parameterValueDescription
slugA collection slug, or its identity as issuer:taxon
Query parameterValueDescription
offsetint
limitint (max 100)
curl 'https://api.xrpl.to/v1/nft/holders/fuzzybears'

Response

200Example response6 ms · just now · 1.2 KB · 60 lines
https://api.xrpl.to/v1/nft/holders/fuzzybears
{
  "success": true,
  "slug": "fuzzybears",
  "name": "Fuzzybears",
  "account": "rw1R8cfHGMySmbj7gJ1HkiCqTY1xhLGYAs",
  "taxon": 1,
  "stats": {
    "totalNFTs": 3210,
    "totalOwners": 715,
    "top10Percent": 17.76,
    "updatedAt": "2026-09-21T07:31:24.753Z"
  },
  "changes": {
    "since": "2026-09-21T04:34:58.314Z",
    "ownersChange": 0,
    "summary": {
      "gainers": 0,
      "losers": 0,
      "newOwners": 0,
      "exitedOwners": 0
    },
    "gainers": [],
    "losers": [],
    "newOwners": [],
    "exitedOwners": []
  },
  "pagination": {
    "offset": 0,
    "limit": 20,
    "pages": 36,
    "total": 715
  },
  "topHolders": [
    {
      "address": "rs8AJUQcw9gL4Q3QbY5Hyy6nBQVBmpZ1pB",
      "count": 76,
      "percentage": "2.37"
    },
    {
      "address": "rp5cbpF6peihKW4TuBJZbL8U9atgDFUJhi",
      "count": 72,
      "percentage": "2.24"
    },
    {
      "address": "rPSQFQyf43vcj2ps2neDM1nD8k3qFk1EE4",
      "count": 60,
      "percentage": "1.87"
    },
    {
      "address": "rEshbhHXj7qQ44eYMgwWyWB6v8QkeSAYS4",
      "count": 58,
      "percentage": "1.81"
    },
    {
      "address": "rEfPFDEhuScHZXMzTKQzPmqxGwNqfp8STX",
      "count": 55,
      "percentage": "1.71"
    }
  ]
}

Long arrays and strings are shortened in the example; Send request for the full answer.

What it does

Collection holder list

A collection is its slug, or its on-chain identity as issuer:taxon. Each NFT in it comes back with its NFTokenID, the id every NFT endpoint takes. Go to NFT →
OpenAPI