{"uid":"cap_CDFV059joTC84Wx4TNfB9","slug":"basebuilder2-token-holders-lookup-64162fa4","name":"BaseBuilder2 Token Holders Lookup","description":"BaseBuilder Trading API hub - 20 paid endpoints","url":"https://bbx-trading.vercel.app/api/token/holders","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.126939","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.126939/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.126939","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.126939","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PmBebbho2vLExxGSdmPnK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.126939","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of token holders for a given token on-chain, via the BaseBuilder Trading API hub","exampleAgentPrompt":"Can you pull the full list of token holders for the contract address 0xAbC123... on Base chain so I can see how concentrated ownership is?","exampleUseCases":[{"title":"Token Ownership Concentration Check","prompt":"Look up all the holders for this token contract 0xAbC123... on Base — I want to know if the top 10 wallets hold most of the supply or if it's well distributed."},{"title":"Whale Wallet Monitoring","prompt":"Fetch the current token holders for contract 0xDeF456... and tell me which wallets hold more than 1% of the total supply — I'm tracking whale activity."},{"title":"Pre-Investment Due Diligence","prompt":"Before I invest, can you grab the holder list for token 0x789GhI... on Base and tell me how many unique wallets are holding it and whether the dev wallet is still a top holder?"}],"resultDescription":"Returns a list of wallet addresses holding the specified token, along with their respective balances and percentage of total supply, enabling analysis of holder concentration and distribution.","failureModes":["Invalid or non-existent token contract address returns an error or empty result","Token on unsupported network returns a network mismatch error","Rate limiting or payment failure may result in 402 or 429 responses","Contract address that is not an ERC-20/token contract may return no holders","Network congestion may cause timeouts for tokens with very large holder counts"],"whenToPreferThis":"Use this endpoint when you need on-chain token holder data specifically within the BaseBuilder Trading API ecosystem, particularly for tokens on the Base network. Prefer this over general blockchain explorers when you need structured, programmatic access to holder lists for DeFi analytics, whale tracking, or investment due diligence workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:48:51.508Z","isFirstParty":false}