GET
/v1/nft/holders/{slug}
Collection holder list
AuthNone — works without a key
Request
GET
https://api.xrpl.to/v1/nft/holders/fuzzybears| Path parameter | Value | Description |
|---|---|---|
| slug | A collection slug, or its identity as issuer:taxon |
| Query parameter | Value | Description |
|---|---|---|
| offset | int | |
| limit | int (max 100) |
curl 'https://api.xrpl.to/v1/nft/holders/fuzzybears'
Response
200Example response2 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": 756, "top10Percent": 17.69, "updatedAt": "2026-11-01T07:04:55.250Z" }, "changes": { "since": "2026-11-01T05:25:54.751Z", "ownersChange": 0, "summary": { "gainers": 0, "losers": 0, "newOwners": 0, "exitedOwners": 0 }, "gainers": [], "losers": [], "newOwners": [], "exitedOwners": [] }, "pagination": { "offset": 0, "limit": 20, "pages": 38, "total": 756 }, "topHolders": [ { "address": "rs8AJUQcw9gL4Q3QbY5Hyy6nBQVBmpZ1pB", "count": 77, "percentage": "2.40" }, { "address": "rp5cbpF6peihKW4TuBJZbL8U9atgDFUJhi", "count": 69, "percentage": "2.15" }, { "address": "rPSQFQyf43vcj2ps2neDM1nD8k3qFk1EE4", "count": 60, "percentage": "1.87" }, { "address": "rEshbhHXj7qQ44eYMgwWyWB6v8QkeSAYS4", "count": 58, "percentage": "1.81" }, { "address": "rEfPFDEhuScHZXMzTKQzPmqxGwNqfp8STX", "count": 54, "percentage": "1.68" } ] }
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 →