{"uid":"cap_EeNCgnTRByFyprZRe3sJ8","slug":"agenttools-nft-holder-distribution-aea8cba1","name":"AgentTools NFT Holder Distribution","description":"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. Use this when an agent needs to who owns the collection, and how concentrated is it.","url":"https://agentstoolshub.com/api/v1/nft/holder-distribution?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["contract"],"properties":{"chain":{"enum":["ethereum","base"],"type":"string","description":"Chain"},"limit":{"type":"number","description":"Holders to show"},"contract":{"type":"string","description":"Collection contract"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LRNIGgzBH829Qdkop-siD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns top holders of any NFT collection with ownership quantities, individual/cumulative percentages, and concentration statistics for a given contract address on Ethereum or Base.","exampleAgentPrompt":"Who are the top 20 holders of the Bored Ape Yacht Club NFT collection on Ethereum — I want to see how concentrated ownership is, with each wallet's quantity and percentage of supply.","exampleUseCases":[{"title":"Pre-investment whale concentration check","prompt":"Before I buy into the Azuki NFT collection, can you show me the top 50 holders on Ethereum with their ownership percentages and cumulative concentration stats? I want to know if whales dominate it."},{"title":"Due diligence on a new Base NFT project","prompt":"There's a new NFT project launching on Base with contract address 0xabc123... — can you pull the top 25 holder distribution so I can see how evenly spread ownership is before recommending it?"},{"title":"Rug pull risk assessment for a client","prompt":"My client is worried about centralization risk in their NFT portfolio — can you check the holder distribution for contract 0xdef456... on Ethereum and tell me if the top 10 wallets control more than half the supply?"}],"resultDescription":"Returns a ranked list of top NFT holders including each wallet address, the number of NFTs held, individual ownership percentage, cumulative ownership percentage, and overall concentration statistics (e.g. how much of the supply the top N holders control together).","failureModes":["Invalid or non-existent contract address returns an error or empty result","Unsupported chain (not ethereum or base) returns a validation error","Contract address belongs to an ERC-20 token rather than an NFT collection, yielding irrelevant or empty data","Very new collections with few holders may return limited data","Rate limiting or payment failure returns a 402 or 429 error","Network timeouts for contracts with extremely large holder counts"],"whenToPreferThis":"Use this endpoint when an agent needs on-chain NFT ownership distribution data — specifically top holders, their quantities, and concentration metrics — for a collection on Ethereum or Base. Prefer this over generic blockchain explorers when you need structured, ready-to-use holder statistics without parsing raw RPC data. Ideal for pre-investment due diligence, rug-pull risk assessment, or any workflow that requires understanding how concentrated or distributed an NFT collection's ownership is.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:48:45.055Z","isFirstParty":false,"canonicalSlug":"agenttools-nft-holder-distribution-aea8cba1"}