{"uid":"cap_m_sFTftWS1XrqLn6LLRup","slug":"token-analysis-api-e729cea8","name":"Token Analysis API","description":"AI-driven token verdict API: returns a grade (BASED/MID/COOKED/RADIOACTIVE), a one-liner, a roast, and facts read… Returns: an AI-written token verdict on one token contract: grade (BASED/MID/COOKED/RADIOACTIVE, a stated rule over the contract's own state), a one-liner and a roast, and the facts read: code size, name, symbol, decimals, supply, owner(), proxy slots. It does not read holders, liquidity or price and makes no safety or legitimacy call. Query: token (token contract, 0x + 40 hex).","url":"https://ari001.tailb4ac3a.ts.net/v1/ventures/token_verdict_api/token_analysis_api?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"token":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"token contract, 0x + 40 hex"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean"},"chain":{"type":"string"},"error":{"type":"string","description":"present when ok is false"},"cached":{"type":"boolean"},"method":{"const":"verdict"},"result":{"type":"object","required":["token","grade","one_liner","roast","written_by","facts"],"properties":{"facts":{"type":"object","description":"the contract state read: is_contract, code_bytes, name, symbol, decimals, total_supply, owner, owner_renounced, proxy_slot, proxy_implementation, proxy_slots_checked, erc20_shaped"},"grade":{"enum":["BASED","MID","COOKED","RADIOACTIVE"],"description":"RADIOACTIVE: not a contract, or not ERC-20 shaped (no decimals/totalSupply). COOKED: a proxy implementation slot is set (EIP-1967, its beacon, or ZeppelinOS) AND owner() names a live owner. MID: either one. BASED: neither found."},"roast":{"type":"string","maxLength":220},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"one_liner":{"type":"string","maxLength":60},"disclaimer":{"type":"string"},"grade_rule":{"type":"string"},"written_by":{"enum":["model","template"]}}},"service":{"type":"string"}}}}}}},"responseSchema":null,"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__7s3YL2jFGwRZbRWSsnBX","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 an AI-written grade (BASED/MID/COOKED/RADIOACTIVE), one-liner, roast, and on-chain facts for a given ERC-20 token contract address","exampleAgentPrompt":"Can you run the token verdict on 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and tell me its grade and roast?","exampleUseCases":[{"title":"Screening a new meme coin contract","prompt":"I just found this new token at 0xdAC17F958D2ee523a2206206994597C13D831ec7 — can you give it a verdict and tell me if it's BASED, COOKED, or something worse?"},{"title":"Checking if a token is a proxy","prompt":"Is the contract 0x6B175474E89094C44Da98b954EedeAC495271d0F a proxy with a live owner, and what grade does that give it?"},{"title":"Due diligence on an unfamiliar ERC-20","prompt":"Before I interact with this token contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984, can you pull its on-chain facts and give me the AI roast and one-liner?"}],"resultDescription":"Returns a JSON object containing: a grade enum (BASED, MID, COOKED, or RADIOACTIVE) with its derivation rule, a short one-liner (≤60 chars), an AI-written roast (≤220 chars), the author flag (model or template), and a facts object with code_bytes, name, symbol, decimals, total_supply, owner, owner_renounced, proxy slot values, and erc20_shaped flag. Does not include holder counts, liquidity, or price data.","failureModes":["Address not a contract (returns RADIOACTIVE grade with is_contract: false)","Address not ERC-20 shaped — missing decimals or totalSupply — returns RADIOACTIVE","Invalid address format (not 0x + 40 hex) returns 400 validation error","Network or RPC read failure returns ok: false with error field","Payment not attached or insufficient USDC returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a quick AI-generated qualitative verdict on a token contract's on-chain structure — specifically its proxy upgradeability and owner status — expressed as a memorable grade and roast. Prefer it over raw RPC calls when you want a human-readable summary with a grade and wit rather than raw state data. Note: it does not assess liquidity, holder distribution, or price — for those signals, use a dedicated on-chain analytics or DEX data endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:13:53.259Z","isFirstParty":false,"canonicalSlug":"token-analysis-api-e729cea8"}