{"uid":"cap_nsznEnwJ2Fe_f19MFf-0p","slug":"xx402-base-token-holder-sketch-api-ee84cc00","name":"xx402 Base Token Holder Sketch API","description":"Paid Base token, wallet, DeFi, chain-read, x402 buyer/seller discovery, and specialized Bitcoin 15-minute Up/Down prediction-market data packets for autonomous agents and risk tools.","url":"https://x402.xx402.icu/api/base-token-holder-sketch?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"keys":["summary","purchase_acceptance","buyer_next_action","next_paid_call","decision_evidence","repeat_purchase_guard","holder_concentration_decision","priority_queue","best_next_products","concentration_breakdown","review_queue","avoid_queue","top_observed_holders","active_whale_candidates","contract_holder_candidates","recent_transfer_sample","bucket_counts","risk_flags","risk","source_status","not_financial_advice","sources"],"type":"json"},"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":"down","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_SsVHauvygeJM8uXd0LBmh","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 a probabilistic sketch of ERC20 token holder concentration, whale candidates, and transfer activity on the Base chain for risk analysis.","exampleAgentPrompt":"Can you run a holder sketch on the USDC token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, looking back over 500 blocks and returning up to 15 top holder candidates, so I can see if there are any whale concentration risks?","exampleUseCases":[{"title":"Pre-investment whale concentration check","prompt":"Before I ape into this new Base token at 0xAbCd1234abcd1234abcd1234abcd1234abcd1234, can you pull a holder sketch over the last 200 blocks and show me whether whales dominate the supply? I want to see the concentration breakdown and any risk flags."},{"title":"DeFi protocol token risk screening","prompt":"I'm building a risk dashboard for Base DeFi tokens — can you run a holder sketch on 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 with up to 20 holder candidates over a 300-block window so I can flag any tokens with dangerous whale concentration?"},{"title":"Recent transfer activity monitoring","prompt":"Can you check the recent transfer sample and active whale candidates for this Base token at 0x4200000000000000000000000000000000000006 over the last 100 blocks? I want to know if there's been unusual large-wallet movement lately."}],"resultDescription":"Returns a JSON object containing: a summary, holder concentration decision, priority/review/avoid queues, top observed holders, active whale candidates, contract holder candidates, recent transfer samples, bucket counts, risk flags, risk score, source status, best next products, and a not-financial-advice disclaimer.","failureModes":["Invalid token_address format (not a valid 0x ERC20 address) returns error","window_blocks below minimum of 100 or above 1000 returns validation error","limit outside 1-20 range returns validation error","Payment not accepted or insufficient USDC returns 402","Token with no recent on-chain activity may return empty holder lists","Network congestion on Base may cause delayed or incomplete data"],"whenToPreferThis":"Use this endpoint when you need a fast probabilistic sketch of token holder concentration on the Base chain without running a full indexer query. It is well-suited for pre-trade risk checks, whale dominance screening, and autonomous agent workflows where a $0.01 per-call micropayment via x402 is acceptable. Prefer this over full indexer solutions when speed, cost, and autonomous payment are priorities over exhaustive accuracy.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T01:28:03.199Z","isFirstParty":false,"canonicalSlug":"xx402-base-token-holder-sketch-api-ee84cc00"}