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": 717,
  "totalNFTs": 3210,
  "summary": {
    "whales": "36 owners (5.02%) hold 1294 NFTs (40.31%)",
    "orcas": "45 owners (6.28%) hold 579 NFTs (18.04%)",
    "dolphins": "70 owners (9.76%) hold 482 NFTs (15.02%)",
    "fish": "182 owners (25.38%) hold 471 NFTs (14.67%)",
    "shrimp": "384 owners (53.56%) hold 384 NFTs (11.96%)"
  },
  "distribution": {
    "whales": {
      "threshold": "20+ NFTs",
      "owners": 36,
      "nfts": 1294,
      "holders": [
        {
          "address": "rs8AJUQcw9gL4Q3QbY5Hyy6nBQVBmpZ1pB",
          "count": 76
        },
        {
          "address": "rp5cbpF6peihKW4TuBJZbL8U9atgDFUJhi",
          "count": 72
        },
        {
          "address": "rPSQFQyf43vcj2ps2neDM1nD8k3qFk1EE4",
          "count": 60
        },
        {
          "address": "rEshbhHXj7qQ44eYMgwWyWB6v8QkeSAYS4",
          "count": 58
        },
        {
          "address": "rEfPFDEhuScHZXMzTKQzPmqxGwNqfp8STX",
          "count": 55
        }
      ],
      "ownersPct": "5.02",
      "nftsPct": "40.31"
    },
    "orcas": {
      "threshold": "10-19 NFTs",
      "owners": 45,
      "nfts": 579,
      "holders": [
        {
          "address": "rNxNH2be3T67ZZmSepv8DxjPqbpH7AwXsE",
          "count": 19
        },
        {
          "address": "rDnUDpCunsAg9kiW5uUBJnuuJPfDeG4E54",
          "count": 18
        },
        {
          "address": "rrhDuWYTsHzRGemQJJCjnSwr4EE9RyghDE",
          "count": 18
        },
        {
          "address": "rBVm71EmupMGFpGZGqzAKCbfrLLeQ7xoXf",
          "count": 18
        },
        {
          "address": "rUFRQhiojg7VpZqF1ZAAQZyb4b6ZUuEbZa",
          "count": 18
        }
      ],
      "ownersPct": "6.28",
      "nftsPct": "18.04"
    },
    "dolphins": {
      "threshold": "5-9 NFTs",
      "owners": 70,
      "nfts": 482,
      "holders": [
        {
          "address": "rBxWA99Ma49JBjrmQGBTATi7e8HAAZCBnL",
          "count": 9
        },
        {
          "address": "rEtMX8u1CYuFm11kYLSLWTkCp45yYLVwEr",
          "count": 9
        },
        {
          "address": "rM3uXmGpFcUovZMfSye9NXqSzXNh4MWB5i",
          "count": 9
        },
        {
          "address": "rBEivyiqk2gbMQByDWXA7AscZfKjFdwrEi",
          "count": 9
        },
        {
          "address": "rBHQyPpQfCxc3SKCsqhxkeFFCVAKLPfK1Y",
          "count": 9
        }
      ],
      "ownersPct": "9.76",
      "nftsPct": "15.02"
    },
    "fish": {
      "threshold": "2-4 NFTs",
      "owners": 182,
      "nfts": 471,
      "holders": [
        {
          "address": "racBuhbYfL1wiypZFcXRoEP9FKdg1Gm9ZV",
          "count": 4
        },
        {
          "address": "rfZ4wctatnmNGp3ZifuyX5zi8VLi33kh7r",
          "count": 4
        },
        {
          "address": "rsk81JwTYidqLwfb4RbKp4XsqgZi1KdzmA",
          "count": 4
        },
        {
          "address": "rGgdjw1bBnbJ1m25yXHKgbJxJ9pE8Sn7NN",
          "count": 4
        },
        {
          "address": "rsuZSEhPqGsLwbSaYAUP5R6mUWzfxmDAiw",
          "count": 4
        }
      ],
      "ownersPct": "25.38",
      "nftsPct": "14.67"
    },
    "shrimp": {
      "threshold": "1 NFT",
      "owners": 384,
      "nfts": 384,
      "holders": [
        {
          "address": "rnJF7Sygno8EjSBoxsvtNMW9bTasUgKWhu",
          "count": 1
        },
        {
          "address": "rBLw8LMMyKKxaMqsNU5V66SqxHKPPXxM4G",
          "count": 1
        },
        {
          "address": "rJjGYAAuET7zQkHpgqBMAPzMEsAYie53vN",
          "count": 1
        },
        {
          "address": "rBQcaeyLpoGccCvLWe9pjFG3mDSXqgXxU8",
          "count": 1
        },
        {
          "address": "rBefXYj3EAJDdjfQwpWE1Aw1xJoTQPAiuP",
          "count": 1
        }
      ],
      "ownersPct": "53.56",
      "nftsPct": "11.96"
    }
  }
}

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