{"uid":"cap_PZlh-zK-qlO2V99KFIBg5","slug":"token-risk-score-api-for-base-ad086c89","name":"Token Risk Score API for Base","description":"Token Risk Score API for Base: one call returns a 0-100 risk score (higher = riskier) for any ERC-20 on Base, with a derived liquidity view, known-address supply breakdown, our own on-chain sell simulation (buy/sell/transfer tax) and contract flags (owner, proxy, blacklist, pause, selfdestruct, delegatecall). Base only; Polygon/Ethereum analysis is paused (503 before payment, never charged). $0.01 per call via x402 (USDC on Base), or $0.005 for the slim /v1/risk-lite. No charge for…","url":"https://token-risk.restockalarm.workers.dev/v1/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":[],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 contract address on Base (0x + 40 hex). If omitted, the AERO example is returned with example=true; an invalid address is 400."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","score":20,"token":{"name":"Aerodrome","symbol":"AERO"},"cached":false,"address":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","sources":["https://api.dexscreener.com/latest/dex/tokens/… (input for pool discovery and liquidity; only derived values are returned)","Base JSON-RPC (https://mainnet.base.org): …"],"liquidity":{"band":"$10M-$100M","level":"deep","top_pool":{"address":"0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d","share_pct":53.3},"derived_from":"dexscreener","pools_counted":30},"disclaimer":"Ikke investeringsråd / not investment advice. Automated indicator from public on-chain and DEX data; it can be incomplete or wrong. Do your own research.","contract_flags":{"flags":[],"owner":{"note":"no owner() function","type":null,"address":null},"pause":false,"proxy":{"value":false},"mintable":true,"blacklist":false,"anti_whale":false,"paused_now":false,"buy_tax_pct":0,"delegatecall":false,"selfdestruct":false,"sell_blocked":false,"sell_tax_pct":null,"sell_simulation":{"pool":"0x3d5d143381916280ff91407febeb52f2b60f33cf","status":"ok","pool_type":"v3_style","buy_tax_pct":0,"transfer_tax_pct":0,"round_trip_loss_pct":0.6},"transfer_tax_pct":0},"liquidity_risk":{"band":"$10M-$100M","level":"low","pools":30,"reason":"$10M-$100M pooled liquidity across 30 pools, deepest pool 53.3% of it, oldest pool 800 days","oldest_pool_age_days":800},"news_sentiment":{"level":"no_data","measured":false,"sentence":"No news data: no news source is connected, so nothing is inferred (v1 reported this as 'neutral').","legacy_level":"neutral"},"score_breakdown":{"pool_age":0,"liquidity":5,"news_sentiment":0,"contract_trading":3,"holder_concentration":5},"holder_concentration":{"top5":[{"pct":1.9,"type":"lp","label":"DEX pool","address":"0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d"}],"level":"low","reason":"known addresses hold …% of supply: DEX pools …%, burned …%, owner …%, token contract …%, labeled …%","owner_pct":0,"burned_pct":0,"insider_pct":0,"labeled_pct":1.2,"in_pools_pct":3.1,"top5_total_pct":4.3,"unobserved_pct":95.7,"token_contract_pct":0}}},"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_Y1DOlQ_gD6E6A30tMIovB","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 0-100 risk score for any ERC-20 token on Base, with liquidity depth, holder concentration, honeypot/tax checks, and contract flags.","exampleAgentPrompt":"Can you check the risk score for the token at 0x940181a94a35a4569e4529a3cdfb74e38fd98631 on Base — I want to know if it's a honeypot, what the holder concentration looks like, and how much liquidity it has?","exampleUseCases":[{"title":"Pre-swap token safety check","prompt":"Before I swap into this token on Base at 0x4200000000000000000000000000000000000042, can you pull its risk score and tell me if it has any honeypot flags, high sell tax, or suspicious contract functions?"},{"title":"DeFi portfolio risk screening","prompt":"I'm building a DeFi portfolio on Base. Can you check the risk scores for these three tokens — 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913, 0x940181a94a35a4569e4529a3cdfb74e38fd98631, and 0x50c5725949a6f0c72e6c4a641f24049a917db0cb — and flag any with a score above 50 or with blacklist/pause flags?"},{"title":"New token launch due diligence","prompt":"A new token just launched on Base at 0xabc123def456abc123def456abc123def456ab12 — can you run a risk assessment on it and tell me who the top 5 holders are, whether it's open source, and if there's any honeypot or mint risk?"}],"resultDescription":"A JSON object containing: a 0-100 composite risk score (higher = riskier), a score breakdown by category (liquidity, holder concentration, contract/trading, pool age, news sentiment), token metadata (name, symbol, holder count), liquidity info (total pooled USD across all pools, top pool name and address, pool count), top-5 holder addresses with ownership percentages and type, a set of boolean contract flags (honeypot, proxy, blacklist, pause, selfdestruct, delegatecall, mintable, open_source, anti_whale), buy/sell tax percentages, news sentiment level, liquidity risk level, and a disclaimer.","failureModes":["Invalid address format (not 0x + 40 hex) returns HTTP 400","Token not found on Base or no DEX data available may return incomplete scores or null fields","Network/upstream failures from DexScreener or on-chain data providers may cause errors","Cached responses may be slightly stale for rapidly changing tokens","Missing news data returns news_sentiment.level as 'no_data'"],"whenToPreferThis":"Use this endpoint when you need a fast, structured, quantified risk assessment of a specific ERC-20 token on the Base network before trading, investing, or integrating it — especially when you need contract flag checks (honeypot, blacklist, pause, selfdestruct), holder concentration data, and liquidity depth in a single API call. Prefer this over manual on-chain inspection when you need a normalized 0-100 score suitable for automated decision-making or filtering in agent workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T00:36:00.456Z","isFirstParty":false,"canonicalSlug":"token-risk-score-api-for-base-ad086c89"}