{"uid":"cap_A27CSh_n6DSSVdL1b_Bui","slug":"token-verdict-api-f69c1be1","name":"Token Verdict API","description":"Token Verdict API for Base: one call runs token risk, rug-pull, holder and momentum checks plus contract flags (proxy, blacklist, pause, selfdestruct) and returns one verdict (avoid / high_risk / caution / low_risk) with a one-line English summary; top holders carry known labels (exchanges, bridges, lockers) that are excluded from concentration. $0.05 per call via x402 (USDC on Base or Polygon). Not investment advice.","url":"https://token-verdict.restockalarm.workers.dev/v1/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":[],"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","token":{"name":"Aerodrome","symbol":"AERO"},"cached":false,"address":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","reasons":[],"summary":"AERO: low_risk — risk 20/100, rug_pull false (3/5 signals measured), top-10 wallets 15.13% (distributed), liquidity $49.65M pooled / top pool $35.11M (dexscreener), momentum 78 (down); contract flags: mintable.","verdict":"low_risk","components":{"rug":{"rug_pull":false},"risk":{"score":20},"holders":{"distribution":"distributed"},"momentum":{"momentum":78,"direction":"down"}},"disclaimer":"Not investment advice. Automated verdict from public on-chain and DEX data, combining four heuristics; it can be incomplete or wrong. Do your own research.","key_metrics":{"bundling":"none","momentum":78,"rug_pull":false,"direction":"down","liquidity":{"source":"dexscreener","pooled_all_pools_usd":49650000,"top_pool_liquidity_usd":35110000},"risk_score":20,"distribution":"distributed","contract_flags":{"pause":false,"proxy":{"value":false},"honeypot":false,"mintable":true,"blacklist":false,"anti_whale":false,"paused_now":false,"delegatecall":false,"selfdestruct":false},"rug_confidence":"medium","top10_wallets_pct":15.13,"top10_excluding_contracts_pct":15.13},"verdict_rule":"…","verdict_confidence":"medium"}},"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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2drwV6e0Oj_BcHdBHLbVy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a multi-factor token risk analysis on a Base ERC-20 address and returns a single verdict (avoid/high_risk/caution/low_risk) with a summary, risk score, rug-pull flags, holder concentration, momentum, and contract flags.","exampleAgentPrompt":"Can you run a full token risk check on contract 0x940181a94a35a4569e4529a3cdfb74e38fd98631 on Base and tell me if it's safe to buy — I want the verdict, rug-pull status, risk score, and any contract red flags like blacklists or pause functions.","exampleUseCases":[{"title":"Pre-buy safety check on new token","prompt":"Before I buy any of this new token at 0x1234567890abcdef1234567890abcdef12345678 on Base, can you run a safety verdict on it and tell me if it's a rug pull risk, what the risk score is, and whether top holders are too concentrated?"},{"title":"DeFi bot contract flag screening","prompt":"I'm building a trading bot and need to screen tokens automatically — can you check 0xAbCd1234AbCd1234AbCd1234AbCd1234AbCd1234 for honeypot, blacklist, mintable, proxy, or selfdestruct flags before we add it to the whitelist?"},{"title":"Portfolio token risk audit","prompt":"I hold a bunch of tokens on Base and want to audit them for risk — can you start with 0x940181a94a35a4569e4529a3cdfb74e38fd98631 and give me its verdict, momentum direction, and liquidity numbers so I know if I should be worried?"}],"resultDescription":"Returns a JSON object with: a one-word verdict (avoid/high_risk/caution/low_risk), a one-line English summary, a risk score (0-100), rug_pull boolean with confidence, holder distribution label and top-10 wallet percentage (excluding known contracts/exchanges), momentum score and direction, pooled liquidity in USD, and contract flags (proxy, blacklist, pause, selfdestruct, mintable, honeypot, anti_whale, delegatecall). Also includes a disclaimer and verdict_confidence level.","failureModes":["Invalid address format (not 0x + 40 hex) returns HTTP 400","Missing or malformed address returns example response with example=true flag","Token not indexed or insufficient on-chain data may yield low-confidence verdict","Rate limits or payment failures via x402 protocol return payment-required errors","Contract data unavailable from DexScreener or on-chain sources may produce incomplete flags"],"whenToPreferThis":"Choose this endpoint when you need a single-call, all-in-one token safety verdict for Base ERC-20 tokens combining rug-pull heuristics, contract flag detection, holder concentration, and momentum — especially useful for agents that need a fast go/no-go signal before a trade or listing decision. Prefer it over manual on-chain queries when you want labeled holder exclusions (exchanges, bridges, lockers) and a normalized risk score in one response at low cost ($0.05).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:39:49.391Z","isFirstParty":false,"canonicalSlug":"token-verdict-api-f69c1be1"}