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 response2 ms · just now · 3.7 KB · 160 lines
https://api.xrpl.to/v1/nft/holders/fuzzybears/distribution
{
  "slug": "fuzzybears",
  "name": "Fuzzybears",
  "totalOwners": 756,
  "totalNFTs": 3210,
  "summary": {
    "whales": "33 owners (4.37%) hold 1203 NFTs (37.48%)",
    "orcas": "44 owners (5.82%) hold 586 NFTs (18.26%)",
    "dolphins": "70 owners (9.26%) hold 492 NFTs (15.33%)",
    "fish": "199 owners (26.32%) hold 519 NFTs (16.17%)",
    "shrimp": "410 owners (54.23%) hold 410 NFTs (12.77%)"
  },
  "distribution": {
    "whales": {
      "threshold": "20+ NFTs",
      "owners": 33,
      "nfts": 1203,
      "holders": [
        {
          "address": "rs8AJUQcw9gL4Q3QbY5Hyy6nBQVBmpZ1pB",
          "count": 77
        },
        {
          "address": "rp5cbpF6peihKW4TuBJZbL8U9atgDFUJhi",
          "count": 69
        },
        {
          "address": "rPSQFQyf43vcj2ps2neDM1nD8k3qFk1EE4",
          "count": 60
        },
        {
          "address": "rEshbhHXj7qQ44eYMgwWyWB6v8QkeSAYS4",
          "count": 58
        },
        {
          "address": "rEfPFDEhuScHZXMzTKQzPmqxGwNqfp8STX",
          "count": 54
        }
      ],
      "ownersPct": "4.37",
      "nftsPct": "37.48"
    },
    "orcas": {
      "threshold": "10-19 NFTs",
      "owners": 44,
      "nfts": 586,
      "holders": [
        {
          "address": "rQ9WqhFBPK1Abkb98m8WqBzebYpuBwatsg",
          "count": 19
        },
        {
          "address": "rBmtjtae5Kq8hd481u8MwdZe8cCXBZ6vXo",
          "count": 18
        },
        {
          "address": "rDnUDpCunsAg9kiW5uUBJnuuJPfDeG4E54",
          "count": 18
        },
        {
          "address": "rUFRQhiojg7VpZqF1ZAAQZyb4b6ZUuEbZa",
          "count": 18
        },
        {
          "address": "rsFCiU9xmPNgj7dUNRwFjcxBhpsFkd3Ggn",
          "count": 18
        }
      ],
      "ownersPct": "5.82",
      "nftsPct": "18.26"
    },
    "dolphins": {
      "threshold": "5-9 NFTs",
      "owners": 70,
      "nfts": 492,
      "holders": [
        {
          "address": "r9cxaBARPSxd2zYNNMz5yrBxcbN9Fakz9s",
          "count": 9
        },
        {
          "address": "rM3uXmGpFcUovZMfSye9NXqSzXNh4MWB5i",
          "count": 9
        },
        {
          "address": "rnfXWdmcgbrkuC6H8K2YCaU3DDw2yUCTcc",
          "count": 9
        },
        {
          "address": "rpa399B7Fw5sAU5jRHbShhCs12XoJ8niYT",
          "count": 9
        },
        {
          "address": "rfSzs322pYeYFw47azZuhkrRYsx5gkpyft",
          "count": 9
        }
      ],
      "ownersPct": "9.26",
      "nftsPct": "15.33"
    },
    "fish": {
      "threshold": "2-4 NFTs",
      "owners": 199,
      "nfts": 519,
      "holders": [
        {
          "address": "rEyqYjuBhXE9DabWYuCwa4MgaTqetaQheN",
          "count": 4
        },
        {
          "address": "rRGCNPuPc4awk29HX98sBEkRB6w5JRp7o",
          "count": 4
        },
        {
          "address": "rQnAxLNeYcLnDetCXGZBhwrH91qWp9vk36",
          "count": 4
        },
        {
          "address": "rfucGDjEcseRE7dGZtwzRUwQDJkgj8t3Gk",
          "count": 4
        },
        {
          "address": "raw7oFXXMSQHPEZqtc5EoH6kqWzrRy41WB",
          "count": 4
        }
      ],
      "ownersPct": "26.32",
      "nftsPct": "16.17"
    },
    "shrimp": {
      "threshold": "1 NFT",
      "owners": 410,
      "nfts": 410,
      "holders": [
        {
          "address": "rDUfV1YS21eQiVcpRZJ3jGvgCcYrVKryRR",
          "count": 1
        },
        {
          "address": "rh9SHB9GU5jLDBncBeTpbQXYVvW46xEt6V",
          "count": 1
        },
        {
          "address": "rJXCrrvV3JwTQvdLvTxaSkfC3vfutWSXTV",
          "count": 1
        },
        {
          "address": "rGJZJTq53K19u8rGDwyBBnACQCGKC4kGB2",
          "count": 1
        },
        {
          "address": "rn7SQB1M3if595MKoqmuSTyhVZWr1a3MW8",
          "count": 1
        }
      ],
      "ownersPct": "54.23",
      "nftsPct": "12.77"
    }
  }
}

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