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 response3 ms · just now · 3.7 KB · 160 lines
https://api.xrpl.to/v1/nft/holders/fuzzybears/distribution
{
  "slug": "fuzzybears",
  "name": "Fuzzybears",
  "totalOwners": 760,
  "totalNFTs": 3210,
  "summary": {
    "whales": "34 owners (4.47%) hold 1224 NFTs (38.13%)",
    "orcas": "43 owners (5.66%) hold 566 NFTs (17.63%)",
    "dolphins": "73 owners (9.61%) hold 505 NFTs (15.73%)",
    "fish": "191 owners (25.13%) hold 496 NFTs (15.45%)",
    "shrimp": "419 owners (55.13%) hold 419 NFTs (13.05%)"
  },
  "distribution": {
    "whales": {
      "threshold": "20+ NFTs",
      "owners": 34,
      "nfts": 1224,
      "holders": [
        {
          "address": "rs8AJUQcw9gL4Q3QbY5Hyy6nBQVBmpZ1pB",
          "count": 77
        },
        {
          "address": "rp5cbpF6peihKW4TuBJZbL8U9atgDFUJhi",
          "count": 69
        },
        {
          "address": "rPSQFQyf43vcj2ps2neDM1nD8k3qFk1EE4",
          "count": 60
        },
        {
          "address": "rEshbhHXj7qQ44eYMgwWyWB6v8QkeSAYS4",
          "count": 58
        },
        {
          "address": "r49AJFDZsXMFky53bgPTyLjNsa24234Dpu",
          "count": 54
        }
      ],
      "ownersPct": "4.47",
      "nftsPct": "38.13"
    },
    "orcas": {
      "threshold": "10-19 NFTs",
      "owners": 43,
      "nfts": 566,
      "holders": [
        {
          "address": "rQ9WqhFBPK1Abkb98m8WqBzebYpuBwatsg",
          "count": 19
        },
        {
          "address": "rsFCiU9xmPNgj7dUNRwFjcxBhpsFkd3Ggn",
          "count": 18
        },
        {
          "address": "rBmtjtae5Kq8hd481u8MwdZe8cCXBZ6vXo",
          "count": 18
        },
        {
          "address": "rUFRQhiojg7VpZqF1ZAAQZyb4b6ZUuEbZa",
          "count": 18
        },
        {
          "address": "rDnUDpCunsAg9kiW5uUBJnuuJPfDeG4E54",
          "count": 18
        }
      ],
      "ownersPct": "5.66",
      "nftsPct": "17.63"
    },
    "dolphins": {
      "threshold": "5-9 NFTs",
      "owners": 73,
      "nfts": 505,
      "holders": [
        {
          "address": "rBEivyiqk2gbMQByDWXA7AscZfKjFdwrEi",
          "count": 9
        },
        {
          "address": "rp6ZCV6KMhi15X9zu2dTNPedKkCbZWrrLX",
          "count": 9
        },
        {
          "address": "rM3uXmGpFcUovZMfSye9NXqSzXNh4MWB5i",
          "count": 9
        },
        {
          "address": "rnfXWdmcgbrkuC6H8K2YCaU3DDw2yUCTcc",
          "count": 9
        },
        {
          "address": "r3jJW3RWWwFFwoavR3xYYFo6vbYUi6A55b",
          "count": 9
        }
      ],
      "ownersPct": "9.61",
      "nftsPct": "15.73"
    },
    "fish": {
      "threshold": "2-4 NFTs",
      "owners": 191,
      "nfts": 496,
      "holders": [
        {
          "address": "rHnUrxzmD8A93N5NDVkLbmfecb5kg1PGGd",
          "count": 4
        },
        {
          "address": "rQnAxLNeYcLnDetCXGZBhwrH91qWp9vk36",
          "count": 4
        },
        {
          "address": "rhfEaCgcAEDTQLh45fSUobbn9cVFQLT3rN",
          "count": 4
        },
        {
          "address": "rE8PGcN5K1ZfLYUpaRTygFD3jr24F6GcAT",
          "count": 4
        },
        {
          "address": "rEyqYjuBhXE9DabWYuCwa4MgaTqetaQheN",
          "count": 4
        }
      ],
      "ownersPct": "25.13",
      "nftsPct": "15.45"
    },
    "shrimp": {
      "threshold": "1 NFT",
      "owners": 419,
      "nfts": 419,
      "holders": [
        {
          "address": "rnbBDVHFQ61NmKcfHk3iQNPtgEs6Rwt2f9",
          "count": 1
        },
        {
          "address": "rhQbZGy5gdYrJkCppn14XeVnYV3VddQzLr",
          "count": 1
        },
        {
          "address": "rK6r6yUjjB7wHbHZEvwxgtDpfRRHXM5nir",
          "count": 1
        },
        {
          "address": "rEbYGkEgEVqngfTbQtE2FhTQ4avbM7cWBk",
          "count": 1
        },
        {
          "address": "rne8yH7diXbKQQKATwRv1gohv2nq4qL3Ma",
          "count": 1
        }
      ],
      "ownersPct": "55.13",
      "nftsPct": "13.05"
    }
  }
}

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