👥NFT Holder Distribution
Top holders of any NFT collection with exact quantities, individual and cumulative ownership percentages, and concentration statistics — the distribution picture agents need before valuing or recommending a collection.
Worked examples
BAYC top 20 holders
GET /api/v1/nft/holder-distribution?contract=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&chain=ethereum&limit=20
Result: 50+ holders · top-10 own 10.5%
Machine API (x402)
$0.005 / callThis tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.
GET /api/v1/nft/holder-distribution?contract=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&chain=ethereum&limit=20 HTTP/1.1
Host: agenttools-hub.vercel.app
→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)
{
"tool": "nft/holder-distribution",
"input": {"contract":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D","chain":"ethereum","limit":20},
"result": { "value": 10.5, "answer": "50+ holders · top-10 own 10.5%" }
}Agent docs: /llms.txt · OpenAPI spec · integration guide
About this tool
Holder distribution is the core NFT risk metric: a collection where the top 10 wallets own half the supply can be dumped on any rally. This returns the ranked holder table with quantities, individual shares and cumulative concentration — straight from chain state.
Frequently asked questions
Do marketplace contracts show as holders?
Sometimes — items listed on custodial marketplaces appear under the marketplace contract. Large single-address holdings that look like marketplaces should be interpreted accordingly.
How concentrated is too concentrated?
Rules of thumb: top-10 under ~20% is well distributed, 30–50% elevated, above 50% means a handful of wallets control the floor.