{"uid":"cap_NxNjg4RQLu-l2IloJGNjD","slug":"token-risk-assessment-api-base-erc-20-88ef99b6","name":"Token Risk Assessment API (Base ERC-20)","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-risk?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_knFC98qTKpRuAqRpncAbN","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 risk flags for a Base ERC-20 token contract address, including honeypot detection, tax analysis, and holder concentration.","exampleAgentPrompt":"Can you check whether the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base is safe to trade — is it a honeypot, what's the risk score, and are there any red flags like high sell tax or upgradeable proxy?","exampleUseCases":[{"title":"Pre-trade honeypot check","prompt":"Before I swap into this token at 0x4200000000000000000000000000000000000006 on Base, can you run a risk check and tell me if it's a honeypot or has any sell restrictions?"},{"title":"DeFi bot token safety gate","prompt":"My trading bot is about to buy a new token at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base — check the risk score and verdict first and only proceed if it's rated low risk with no honeypot flag."},{"title":"Audit proxy risk before liquidity provision","prompt":"I'm thinking of providing liquidity for the token at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base — can you check if the contract is an upgradeable proxy and what the top-10 holder concentration looks like?"}],"resultDescription":"A JSON object with a risk verdict (OK/WARNING/DANGER), numeric risk score (0-100), risk level label (low/medium/high), boolean flags for can_sell and should_buy, honeypot simulation result, buy/sell tax percentages, top-10 holder percentage, contract metadata (verified source, bytecode size, is_contract), and a list of human-readable risk reason strings and flags such as 'upgradeable_proxy'.","failureModes":["Invalid or non-ERC-20 address returns error or empty result","Address not on Base chain may return incorrect or no data","Payment failure via x402 if insufficient USDC balance on Base","Rate limiting or worker downtime on the Cloudflare Workers backend","Newly deployed contracts with no on-chain data may return incomplete analysis"],"whenToPreferThis":"Use this endpoint when an AI trading agent or DeFi automation pipeline needs a quick, cheap ($0.01 USDC), no-API-key risk gate before executing a token swap or liquidity provision on Base. It is especially suited for autonomous agents that need to verify token safety programmatically via x402 micropayments without setting up OAuth or API key management. Prefer it over full smart contract audit services when you need a fast, lightweight signal rather than a deep manual review.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:27.216Z","isFirstParty":false,"canonicalSlug":"token-risk-assessment-api-base-erc-20-88ef99b6"}