{"uid":"cap_fa3AnuH-nTwrEXGsPOhim","slug":"basebuilder-trading-holder-distribution-61c9bd3b","name":"BaseBuilder Trading - Holder Distribution","description":"BaseBuilder Trading API hub - 20 paid endpoints","url":"https://bb-trading-gold.vercel.app/api/holder/distribution","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.160666","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.160666/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.160666","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.160666","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ukp1QesVpSGo0Fa77Om0W","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.160666","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the distribution of token holders for a given asset on Base, showing how holdings are spread across wallet addresses","exampleAgentPrompt":"Can you pull the holder distribution for the token at address 0xABCDEF... on Base and tell me how concentrated the holdings are — like how much is held by the top wallets versus smaller holders?","exampleUseCases":[{"title":"Whale concentration check before investment","prompt":"Before I buy this Base token at 0x1234567890abcdef, can you check the holder distribution and tell me if it's heavily concentrated in a few whale wallets or spread out more fairly?"},{"title":"DeFi project due diligence report","prompt":"I'm evaluating a new DeFi project on Base — can you pull the holder distribution for their token at 0xdeadbeef0000 and show me the breakdown of how holdings are spread across wallet tiers?"},{"title":"Monitor token decentralization over time","prompt":"Can you check the current holder distribution for our project token at 0xabc123 on Base and flag if more than 20% of supply is concentrated in fewer than 10 wallets?"}],"resultDescription":"Returns a breakdown of how a token's supply is distributed across holder wallet addresses, typically including bucket tiers (e.g. whales, mid-tier, small holders), counts of wallets per tier, and percentage of total supply held by each segment.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Token not deployed on Base network causes lookup failure","Rate limiting or payment failure returns 402 or 429 status","Newly deployed token with no holders may return sparse or empty distribution","Network congestion may cause timeout for tokens with extremely large holder counts"],"whenToPreferThis":"Use this endpoint when you need on-chain holder distribution analytics specifically for tokens on the Base blockchain. Prefer this over generic blockchain explorers when you want structured, segmented distribution data suitable for programmatic analysis. Best suited for DeFi due diligence, whale concentration checks, and decentralization audits.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:41:44.860Z","isFirstParty":false}