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 response3 ms · just now · 2.2 KB · 109 lines
https://api.xrpl.to/v1/nft/holders/fuzzybears
{
  "success": true,
  "slug": "fuzzybears",
  "name": "Fuzzybears",
  "account": "rw1R8cfHGMySmbj7gJ1HkiCqTY1xhLGYAs",
  "taxon": 1,
  "stats": {
    "totalNFTs": 3210,
    "totalOwners": 717,
    "top10Percent": 17.76,
    "updatedAt": "2026-10-12T01:04:37.912Z"
  },
  "changes": {
    "since": "2026-10-11T04:58:39.416Z",
    "ownersChange": -1,
    "summary": {
      "gainers": 3,
      "losers": 2,
      "newOwners": 2,
      "exitedOwners": 3
    },
    "gainers": [
      {
        "address": "rQ9WqhFBPK1Abkb98m8WqBzebYpuBwatsg",
        "change": "+1",
        "now": 21
      },
      {
        "address": "rK1MDDENXURPfputW93V8UCGKTXkLP2X7Z",
        "change": "+1",
        "now": 5
      },
      {
        "address": "rLmPMcWuavx8tdrhRGs7XRhoby4NdbYe52",
        "change": "+1",
        "now": 2
      }
    ],
    "losers": [
      {
        "address": "rp8KLn4zD4HSPvD8h4MCbSVpuVnyWKRVh1",
        "change": -1,
        "now": 11
      },
      {
        "address": "rnoUNM93PVodLqMYC1mZUoccJePGxhWboW",
        "change": -1,
        "now": 6
      }
    ],
    "newOwners": [
      {
        "address": "rJgJtPkEWTj4LyGoPXaRctMKooUdrKaotJ",
        "count": 1
      },
      {
        "address": "r7JyCUq2VeWjsiWYkcHpGUPnjchdaoKQG",
        "count": 1
      }
    ],
    "exitedOwners": [
      {
        "address": "rPdL3XyYBmiSzn9A6EU5b2K8GFvyMiAYY3",
        "had": 1
      },
      {
        "address": "rsV418dZvRYxyGjqy6Xp5zKNZbN6jwRHSk",
        "had": 1
      },
      {
        "address": "rMkTn9dHN9k3Zokx5skASN2Fyu3aPapivF",
        "had": 1
      }
    ]
  },
  "pagination": {
    "offset": 0,
    "limit": 20,
    "pages": 36,
    "total": 717
  },
  "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