GET /nft/holders/{slug}/distribution
GET

/v1/nft/holders/{slug}/distribution

Holder distribution by tier (whales/orcas/dolphins/fish/shrimp)

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/nft/holders/fuzzybears/distribution
Path parameterValueDescription
slugA collection slug, or its identity as issuer:taxon
curl 'https://api.xrpl.to/v1/nft/holders/fuzzybears/distribution'

Response

200Example response4 ms · just now · 3.7 KB · 160 lines
https://api.xrpl.to/v1/nft/holders/fuzzybears/distribution
{
  "slug": "fuzzybears",
  "name": "Fuzzybears",
  "totalOwners": 715,
  "totalNFTs": 3210,
  "summary": {
    "whales": "35 owners (4.90%) hold 1282 NFTs (39.94%)",
    "orcas": "45 owners (6.29%) hold 588 NFTs (18.32%)",
    "dolphins": "69 owners (9.65%) hold 482 NFTs (15.02%)",
    "fish": "183 owners (25.59%) hold 475 NFTs (14.80%)",
    "shrimp": "383 owners (53.57%) hold 383 NFTs (11.93%)"
  },
  "distribution": {
    "whales": {
      "threshold": "20+ NFTs",
      "owners": 35,
      "nfts": 1282,
      "holders": [
        {
          "address": "rs8AJUQcw9gL4Q3QbY5Hyy6nBQVBmpZ1pB",
          "count": 76
        },
        {
          "address": "rp5cbpF6peihKW4TuBJZbL8U9atgDFUJhi",
          "count": 72
        },
        {
          "address": "rPSQFQyf43vcj2ps2neDM1nD8k3qFk1EE4",
          "count": 60
        },
        {
          "address": "rEshbhHXj7qQ44eYMgwWyWB6v8QkeSAYS4",
          "count": 58
        },
        {
          "address": "rEfPFDEhuScHZXMzTKQzPmqxGwNqfp8STX",
          "count": 55
        }
      ],
      "ownersPct": "4.90",
      "nftsPct": "39.94"
    },
    "orcas": {
      "threshold": "10-19 NFTs",
      "owners": 45,
      "nfts": 588,
      "holders": [
        {
          "address": "rDnUDpCunsAg9kiW5uUBJnuuJPfDeG4E54",
          "count": 18
        },
        {
          "address": "rUFRQhiojg7VpZqF1ZAAQZyb4b6ZUuEbZa",
          "count": 18
        },
        {
          "address": "rBVm71EmupMGFpGZGqzAKCbfrLLeQ7xoXf",
          "count": 18
        },
        {
          "address": "rrhDuWYTsHzRGemQJJCjnSwr4EE9RyghDE",
          "count": 18
        },
        {
          "address": "rNxNH2be3T67ZZmSepv8DxjPqbpH7AwXsE",
          "count": 18
        }
      ],
      "ownersPct": "6.29",
      "nftsPct": "18.32"
    },
    "dolphins": {
      "threshold": "5-9 NFTs",
      "owners": 69,
      "nfts": 482,
      "holders": [
        {
          "address": "r4Xsri4DbDHGqjdSJx3tEvkxFq3mQR6JmG",
          "count": 9
        },
        {
          "address": "r3w9fRiFAKNcCZ9oqpVbHVNjsAgXHM9puM",
          "count": 9
        },
        {
          "address": "rMpeHRkWi6Za21Ss9zpp9zn5jWu16Cp1oV",
          "count": 9
        },
        {
          "address": "rGrnqJovoTZ3mgNP7jAJhPJjUm2YWhDqqo",
          "count": 9
        },
        {
          "address": "rJ58SoUU1srABkEwadQ6mD1GLMeu4vaXZs",
          "count": 9
        }
      ],
      "ownersPct": "9.65",
      "nftsPct": "15.02"
    },
    "fish": {
      "threshold": "2-4 NFTs",
      "owners": 183,
      "nfts": 475,
      "holders": [
        {
          "address": "rEyqYjuBhXE9DabWYuCwa4MgaTqetaQheN",
          "count": 4
        },
        {
          "address": "racBuhbYfL1wiypZFcXRoEP9FKdg1Gm9ZV",
          "count": 4
        },
        {
          "address": "rfZ4wctatnmNGp3ZifuyX5zi8VLi33kh7r",
          "count": 4
        },
        {
          "address": "rP6fYtTCstoAmYMXcT4roAhbD6NM5ocknv",
          "count": 4
        },
        {
          "address": "rHzWtXTBrArrGoLDixQAgcSD2dBisM19fF",
          "count": 4
        }
      ],
      "ownersPct": "25.59",
      "nftsPct": "14.80"
    },
    "shrimp": {
      "threshold": "1 NFT",
      "owners": 383,
      "nfts": 383,
      "holders": [
        {
          "address": "rNKKLZgoEEqV4F3qHX4yZtgr9pva6Vx7xa",
          "count": 1
        },
        {
          "address": "rPa5PDdZ2Eci9zLuRQBwd8B2wZgSjrW7ap",
          "count": 1
        },
        {
          "address": "raRkTmui7yYiZkx29eA8HgaHtaykesqeNW",
          "count": 1
        },
        {
          "address": "rN7JYEJHfj3Rm4ktX5CTGTPwPEs2G8aD9y",
          "count": 1
        },
        {
          "address": "ra1eJuDnC59YsixcUJQsB9u9R77B9qsBE2",
          "count": 1
        }
      ],
      "ownersPct": "53.57",
      "nftsPct": "11.93"
    }
  }
}

What it does

Holder distribution by tier (whales/orcas/dolphins/fish/shrimp)

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