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": 720,
  "totalNFTs": 3210,
  "summary": {
    "whales": "36 owners (5.00%) hold 1290 NFTs (40.19%)",
    "orcas": "46 owners (6.39%) hold 586 NFTs (18.26%)",
    "dolphins": "69 owners (9.58%) hold 472 NFTs (14.70%)",
    "fish": "188 owners (26.11%) hold 481 NFTs (14.98%)",
    "shrimp": "381 owners (52.92%) hold 381 NFTs (11.87%)"
  },
  "distribution": {
    "whales": {
      "threshold": "20+ NFTs",
      "owners": 36,
      "nfts": 1290,
      "holders": [
        {
          "address": "rs8AJUQcw9gL4Q3QbY5Hyy6nBQVBmpZ1pB",
          "count": 76
        },
        {
          "address": "rp5cbpF6peihKW4TuBJZbL8U9atgDFUJhi",
          "count": 71
        },
        {
          "address": "rPSQFQyf43vcj2ps2neDM1nD8k3qFk1EE4",
          "count": 60
        },
        {
          "address": "rEshbhHXj7qQ44eYMgwWyWB6v8QkeSAYS4",
          "count": 58
        },
        {
          "address": "rEfPFDEhuScHZXMzTKQzPmqxGwNqfp8STX",
          "count": 55
        }
      ],
      "ownersPct": "5.00",
      "nftsPct": "40.19"
    },
    "orcas": {
      "threshold": "10-19 NFTs",
      "owners": 46,
      "nfts": 586,
      "holders": [
        {
          "address": "rBmtjtae5Kq8hd481u8MwdZe8cCXBZ6vXo",
          "count": 18
        },
        {
          "address": "rDnUDpCunsAg9kiW5uUBJnuuJPfDeG4E54",
          "count": 18
        },
        {
          "address": "rrhDuWYTsHzRGemQJJCjnSwr4EE9RyghDE",
          "count": 18
        },
        {
          "address": "rBVm71EmupMGFpGZGqzAKCbfrLLeQ7xoXf",
          "count": 18
        },
        {
          "address": "rUFRQhiojg7VpZqF1ZAAQZyb4b6ZUuEbZa",
          "count": 18
        }
      ],
      "ownersPct": "6.39",
      "nftsPct": "18.26"
    },
    "dolphins": {
      "threshold": "5-9 NFTs",
      "owners": 69,
      "nfts": 472,
      "holders": [
        {
          "address": "rp6ZCV6KMhi15X9zu2dTNPedKkCbZWrrLX",
          "count": 9
        },
        {
          "address": "rBxWA99Ma49JBjrmQGBTATi7e8HAAZCBnL",
          "count": 9
        },
        {
          "address": "rGrnqJovoTZ3mgNP7jAJhPJjUm2YWhDqqo",
          "count": 9
        },
        {
          "address": "rBEivyiqk2gbMQByDWXA7AscZfKjFdwrEi",
          "count": 9
        },
        {
          "address": "rpa399B7Fw5sAU5jRHbShhCs12XoJ8niYT",
          "count": 9
        }
      ],
      "ownersPct": "9.58",
      "nftsPct": "14.70"
    },
    "fish": {
      "threshold": "2-4 NFTs",
      "owners": 188,
      "nfts": 481,
      "holders": [
        {
          "address": "rsuZSEhPqGsLwbSaYAUP5R6mUWzfxmDAiw",
          "count": 4
        },
        {
          "address": "rQnAxLNeYcLnDetCXGZBhwrH91qWp9vk36",
          "count": 4
        },
        {
          "address": "rPqGGyc7QGvo2buJcDtq68yzxo9wovjDG1",
          "count": 4
        },
        {
          "address": "r3hMwjD8fbGNv8D4vecGDSURQdTM9it1UP",
          "count": 4
        },
        {
          "address": "rGgdjw1bBnbJ1m25yXHKgbJxJ9pE8Sn7NN",
          "count": 4
        }
      ],
      "ownersPct": "26.11",
      "nftsPct": "14.98"
    },
    "shrimp": {
      "threshold": "1 NFT",
      "owners": 381,
      "nfts": 381,
      "holders": [
        {
          "address": "rLBdgKVTpTgo2JNckpdw7hHGCsv82mPdTe",
          "count": 1
        },
        {
          "address": "rB8epbSjnqax6tYmCsW7nXLsgUecTXWXDa",
          "count": 1
        },
        {
          "address": "rMRS42vJxBnFK5a12dWY8B1b6U7Sq2QXUU",
          "count": 1
        },
        {
          "address": "rsx5QoN3DcA23F86GtJPwrCCXChbqHfGVm",
          "count": 1
        },
        {
          "address": "rDSAdoTuAsHXfMJV1S1xUy8YuZNheaCSuQ",
          "count": 1
        }
      ],
      "ownersPct": "52.92",
      "nftsPct": "11.87"
    }
  }
}

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