{"uid":"cap_xBc7dSYRCCDcIPsZ-zlad","slug":"token-risk-assessment-api-x402-fc567cc8","name":"Token Risk Assessment API (x402)","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/v1/crypto/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_P9dJeS8sKvLbc2lGF6zLB","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":"Analyzes a Base ERC-20 token contract for honeypot risk, tax rates, holder concentration, and contract safety, returning a risk score and trading verdict.","exampleAgentPrompt":"Check if the Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 is safe to buy — I need its risk score, whether it's a honeypot, and any contract red flags like upgradeable proxies.","exampleUseCases":[{"title":"Pre-trade safety check for DeFi bot","prompt":"Before my agent buys this new Base token at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA, can you run a risk check on it — tell me if it's a honeypot, what the sell tax is, and whether the verdict is OK to buy?"},{"title":"Rug-pull screening for new listings","prompt":"A new token just launched on Base at 0x4200000000000000000000000000000000000006 — can you check if it's upgradeable, who the top holders are, and whether I should be worried about a rug pull?"},{"title":"Token due diligence before portfolio allocation","prompt":"I'm thinking of adding the token at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base to my portfolio — what's its risk score, can it be sold freely, and are there any contract verification issues I should know about?"}],"resultDescription":"Returns a JSON object with: chain (base), token symbol and decimals, holder_count, risk_score (0-100), risk_level (low/medium/high), verdict (OK/WARN/FAIL), should_buy and can_sell booleans, honeypot simulation result, buy_tax and sell_tax percentages, top10_holder_pct, contract flags (e.g. upgradeable_proxy), verified_source status, bytecode size, and human-readable reasons for any risk flags.","failureModes":["Invalid or non-ERC-20 contract address returns error","Address not on Base network returns no data","Unverified contract may have limited analysis","Rate limiting or payment failure via x402 protocol","Network timeout from Base RPC unavailability"],"whenToPreferThis":"Choose this endpoint when you need rapid, pay-per-call token safety analysis for Base ERC-20 contracts without API key setup. Ideal for autonomous trading agents that need to screen tokens before executing swaps, or for onchain AI workflows that require USDC micropayment-based access via the x402 protocol. Prefer this over general blockchain explorers when you need a structured risk verdict (honeypot, tax, 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:38:52.137Z","isFirstParty":false,"canonicalSlug":"token-risk-assessment-api-x402-fc567cc8"}