{"uid":"cap_yBs-TonqbV23TiFJRBmd-","slug":"token-verdict-risk-scoring-for-base-erc-20-tokens-12d9044a","name":"Token Verdict / Risk Scoring for Base ERC-20 Tokens","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/api/token-verdict?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":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"Base ERC-20 contract"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","flags":["upgradeable_proxy"],"token":{"symbol":"USDC","decimals":6,"holder_count":11391096},"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","reasons":["upgradeable proxy (logic can change)"],"trading":{"buy_tax":0,"sell_tax":0,"honeypot_sim":{"is_honeypot":false},"top10_holder_pct":26.49},"verdict":"OK","can_sell":true,"contract":{"is_contract":true,"bytecode_bytes":1852,"verified_source":true},"risk_level":"low","risk_score":5,"should_buy":true}},"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__fFJXBWYLqOZNYv7VTMP7","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 risk score, verdict, and detailed safety flags for any Base ERC-20 token contract address, including honeypot detection, tax rates, holder concentration, and contract verification status.","exampleAgentPrompt":"Can you check if the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base is safe to buy — is it a honeypot, what's the risk score, and can I actually sell it after?","exampleUseCases":[{"title":"Pre-trade token safety check","prompt":"Before I swap into this token at 0x4200000000000000000000000000000000000006 on Base, check if it's a honeypot, what the sell tax is, and whether it's safe to buy."},{"title":"Rug pull screening for new Base listings","prompt":"I just saw a new token contract 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base — can you scan it for rug pull risks, check if the top holders are too concentrated, and tell me the overall risk verdict?"},{"title":"Portfolio token audit","prompt":"I'm holding a token at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base and want to know if the contract is verified, whether it has an upgradeable proxy risk, and what the current risk score is."}],"resultDescription":"A JSON object containing: a 'verdict' (e.g. 'OK'), a numeric 'risk_score' (0–100), a 'risk_level' string (e.g. 'low'), boolean flags 'can_sell' and 'should_buy', an array of 'flags' (e.g. 'upgradeable_proxy'), 'reasons' explaining each flag, token metadata (symbol, decimals, holder_count), trading data (buy_tax, sell_tax, honeypot simulation, top 10 holder percentage), and contract details (verified_source, bytecode_bytes, is_contract).","failureModes":["Invalid or non-ERC-20 address returns an error or empty result","Address not on Base chain may return no data or incorrect analysis","Unverified contracts may have incomplete risk signals","Payment failure via x402 (insufficient USDC balance) blocks the call","Rate limiting or worker downtime on the Cloudflare worker backend"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a fast, pay-per-use (no API key) risk verdict on a Base ERC-20 token before executing a swap or investment. It is purpose-built for autonomous agents operating on Base with x402 micropayment support, making it ideal when you cannot provision API keys ahead of time. Prefer it over on-chain-only checks when you need aggregated signals like honeypot simulation, tax analysis, and holder concentration in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:24.610Z","isFirstParty":false,"canonicalSlug":"token-verdict-risk-scoring-for-base-erc-20-tokens-12d9044a"}