{"uid":"cap_pw4tIxCJ8sIpej4P-oyo3","slug":"token-verdict-4e526197","name":"Token Verdict","description":"Send a token contract address, get a risk verdict. Returns SOLID / CAUTION / DANGER with a 0-100 score, six weighted market-structure signals (liquidity depth, volume churn, sell pressure, price action, trader breadth, pair age) and a written analyst take. Built for AI agents screening tokens before touching them. Use this when an agent is about to buy, swap, or route funds into a token and needs a fast risk screen first.","url":"https://token-verdict-production.up.railway.app/v1/verdict?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","ethereum","solana"],"type":"string","default":"base","description":"Chain label: base | ethereum | solana"},"address":{"type":"string","description":"Token contract address (0x...)"}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["token","verdict","score","signals","take","market"],"properties":{"take":{"type":"string","description":"Written analyst summary"},"score":{"type":"number","maximum":100,"minimum":0,"description":"Risk score: 0 (safest) to 100 (riskiest)"},"token":{"type":"object","required":["address","symbol","name","chain"],"properties":{"name":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"}}},"market":{"type":"object","required":["price_usd","liquidity_usd","volume_24h_usd","price_change_24h_pct","txns_24h","dex","pair_url"],"properties":{"dex":{"type":["string","null"]},"pair_url":{"type":["string","null"]},"txns_24h":{"type":"object","properties":{"buys":{"type":"integer"},"sells":{"type":"integer"}}},"price_usd":{"type":["string","null"]},"liquidity_usd":{"type":["number","null"]},"volume_24h_usd":{"type":["number","null"]},"price_change_24h_pct":{"type":["number","null"]}}},"signals":{"type":"array","items":{"type":"object","required":["name","score","weight","detail"],"properties":{"name":{"type":"string"},"score":{"type":"integer","maximum":100,"minimum":0},"detail":{"type":"string"},"weight":{"type":"number"}}},"maxItems":6,"minItems":6},"verdict":{"enum":["SOLID","CAUTION","DANGER"],"type":"string"}}},"example":{"take":"BASE (Base King) trades at $0.0003238 on uniswap with $259.1k in liquidity. Trading has effectively stopped — $0 of volume across 3 transactions in 24h — so this is a dormant book, not a live market, whatever the liquidity figure says. Verdict: CAUTION — tradable at most in small size, and the signals above are why. Don't chase green candles. Not checked: contract honeypot simulation and holder concentration (need a paid indexer) — this verdict covers market structure only. Chart: https://dexscreener.com/base/0x2821d96b5fc81aec3763340b375a846a89a3ec1b","score":35,"token":{"name":"Base King","chain":"base","symbol":"BASE","address":"0x2821d96B5FC81aEC3763340b375a846a89A3Ec1b"},"market":{"dex":"uniswap","pair_url":"https://dexscreener.com/base/0x2821d96b5fc81aec3763340b375a846a89a3ec1b","txns_24h":{"buys":1,"sells":2},"price_usd":"0.0003238","liquidity_usd":259106,"volume_24h_usd":0.01,"price_change_24h_pct":0.55},"signals":[{"name":"Liquidity depth","score":5,"detail":"Deep liquidity ($259,106) — the book can absorb real selling.","weight":3},{"name":"Volume churn","score":60,"detail":"24h volume is just $0 — effectively no market.","weight":2},{"name":"Sell pressure","score":60,"detail":"67% sells vs 33% buys — clear distribution.","weight":2},{"name":"Price action","score":10,"detail":"24h price action (+0.6%) is unremarkable.","weight":2},{"name":"Trader breadth","score":70,"detail":"Only 3 transactions in 24h — a handful of wallets IS the market.","weight":1},{"name":"Pair age","score":5,"detail":"Pair has meaningful history.","weight":1}],"verdict":"CAUTION"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_doaiNDAU75LzlRNulsU6s","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a SOLID/CAUTION/DANGER risk verdict plus a 0-100 score and six weighted market-structure signals for any token contract address on Base, Ethereum, or Solana.","exampleAgentPrompt":"Before you swap any funds into it, can you run a risk screen on the Base token at 0x2821d96B5FC81aEC3763340b375a846a89a3ec1b — I want to know the verdict (SOLID, CAUTION, or DANGER), the score, and what the market signals look like?","exampleUseCases":[{"title":"Pre-swap token safety check","prompt":"Before my DeFi agent swaps 500 USDC into that new Ethereum token at 0xabc123…, can you get me a risk verdict on it — I need to know if it's SOLID, CAUTION, or DANGER and what the liquidity and sell pressure signals look like?"},{"title":"Solana memecoin screening","prompt":"There's a Solana token at address So11111111111111111111111111111111111111112 that's been getting hyped — can you screen it for risk and tell me the score and the analyst take before I touch it?"},{"title":"Autonomous agent pre-trade guardrail","prompt":"My trading bot is about to route funds into a Base token at 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — run a risk verdict on it first and block the trade if it comes back DANGER."}],"resultDescription":"A JSON object containing: the token identity (address, symbol, name, chain), a verdict enum (SOLID, CAUTION, or DANGER), a numeric risk score from 0 (safest) to 100 (riskiest), an array of six weighted market-structure signals each with a name, score, weight, and detail string (covering liquidity depth, volume churn, sell pressure, price action, trader breadth, and pair age), a written analyst take summarizing the market situation, and live market data including price, liquidity, 24h volume, 24h price change, buy/sell transaction counts, the DEX name, and a DexScreener pair URL.","failureModes":["Invalid or unrecognized contract address returns an error","Token not found on specified chain (wrong chain label for the address)","Token has no DEX pair data — insufficient market data to score","Chain enum value not matching supported values (base, ethereum, solana)","Network timeout if on-chain data sources are slow to respond","Payment failure or insufficient USDC balance (x402 payment required per call)"],"whenToPreferThis":"Use this endpoint when an AI agent needs a fast, pre-trade risk screen on a specific token contract before executing a swap, buy, or fund routing action. It is purpose-built for agentic workflows — returning a machine-readable verdict enum alongside a numeric score and six structured signals, making it easy to build automated guardrails. Prefer this over generic token info APIs when you need an opinionated risk assessment rather than raw market data, and when you need a written analyst take to surface to a human-in-the-loop. Best for Base, Ethereum, and Solana tokens with live DEX pairs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:30:16.962Z","isFirstParty":false,"canonicalSlug":"token-verdict-4e526197"}