{"uid":"cap_Qfm71OAiIHyAjPZbK_JKI","slug":"brainiac-token-holder-due-diligence-c887d90a","name":"BRAINIAC Token Holder Due Diligence","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/token-due-diligence/holders?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"toBlock":{"type":"integer","maximum":9007199254740991,"minimum":0},"fromBlock":{"type":"integer","maximum":9007199254740991,"minimum":0},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"deploymentBlock":{"type":"integer","maximum":9007199254740991,"minimum":0}}},"responseSchema":{"type":"json","example":{"status":"partial","holders":{"top10":[{"address":"0x1234567890123456789012345678901234567890","balance":"100000000000000000000000"},{"address":"0xabcdef1234567890abcdef1234567890abcdef12","balance":"50000000000000000000000"}],"top20":[{"address":"0x1234567890123456789012345678901234567890","balance":"100000000000000000000000"},{"address":"0xabcdef1234567890abcdef1234567890abcdef12","balance":"50000000000000000000000"}],"holderCount":842,"supplyMatch":true,"totalSupply":"1000000000000000000000000000","burnHoldings":"0","zeroMintCount":0,"totalTransfers":1523,"top10Percentage":15,"top20Percentage":22},"sources":[{"url":"https://mainnet.base.org","source":"Base JSON-RPC","retrievedAt":"2026-10-29T12:00:00.000Z"}],"toBlock":18001000,"fromBlock":18000000,"result_id":"a1b2c3d4e5f60718293a4b5c6d7e8f90","limitations":["Block range is limited to 10000 blocks.","Supply deployment block for complete holder history.","…"],"received_at":"2026-11-12T12:00:00.000Z","retrievedAt":"2026-10-29T12:00:00.000Z","currentBlock":18001000,"tokenAddress":"0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913","missing_items":[{"check":"logs_page_timeout","detail":"A Transfer logs page timed out. Holder counts from completed pages below still stand.","reason":"timeout"}],"scannedBlockRange":"18000000-18001000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3wUanAKyq5pqkBgFaNFnb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes ERC-20 token holder distribution on Base blockchain, returning top holder balances, holder count, supply statistics, and transfer history for a given token and block range.","exampleAgentPrompt":"Can you pull the holder distribution for the USDC token at address 0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913 on Base, scanning from block 18000000 to 18001000, and tell me what percentage the top 10 and top 20 wallets control?","exampleUseCases":[{"title":"Pre-investment token concentration check","prompt":"Before I buy into this new Base token at 0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913, can you check whether whales dominate the supply — specifically what percentage the top 10 and top 20 holders own, and how many total holders there are? Scan the last 10,000 blocks up to block 18001000."},{"title":"DeFi project due diligence report","prompt":"I'm writing a due diligence report on a DeFi project. Can you analyze the holder distribution for their token at 0xabcdef1234567890abcdef1234567890abcdef12 on Base from block 17990000 to 18000000, including the total number of holders, top 20 balances, and total transfer count?"},{"title":"Token launch distribution audit","prompt":"We just launched our token at 0x1234567890123456789012345678901234567890 on Base — can you audit the holder distribution starting from the deployment block 17980000 through block 18001000 to confirm the supply is spread out and not concentrated in a few wallets?"}],"resultDescription":"Returns a JSON object with top 10 and top 20 holder addresses and balances, total holder count, top10 and top20 percentage of supply, total supply, burn holdings, zero mint count, total transfers, a supply match boolean, the scanned block range, current block, data sources (Base JSON-RPC), retrieval timestamp, and any data limitations (e.g. block range capped at 10,000 blocks).","failureModes":["Invalid or malformed token address returns a validation error","Block range exceeding 10,000 blocks may be rejected or truncated","Missing deploymentBlock results in partial holder history that may not reflect complete distribution","Token address not deployed on Base returns empty or error response","RPC node unavailability causes timeout or upstream error"],"whenToPreferThis":"Use this endpoint when you need on-chain, trustless holder distribution data for any ERC-20 token on Base — especially for due diligence, investment screening, or compliance checks. Prefer it over off-chain analytics dashboards when you need programmatic access to raw holder stats within a specific block range, or when verifying supply concentration directly from the chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-15T06:38:25.656Z","isFirstParty":false,"canonicalSlug":"brainiac-token-holder-due-diligence-c887d90a"}