{"uid":"cap_2jq4IwELdCby4ry4dbG9V","slug":"xerxes-token-verdict-api-e56f2c11","name":"Xerxes Token Verdict API","description":"AI-written token verdict on one token contract: grade (BASED/MID/COOKED/RADIOACTIVE, a stated rule over the… 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_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","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.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Eh0aWwlaLBjQYnCwNoolr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","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) and roast for a Base token contract, based on on-chain facts like proxy slots, ownership, and ERC-20 shape.","exampleAgentPrompt":"Give me the Xerxes verdict on the Base token at 0x4200000000000000000000000000000000000006 — I want to know if it grades BASED or COOKED, who owns it, and whether it has any proxy slots set.","exampleUseCases":[{"title":"Due diligence on a new Base token","prompt":"Before I ape into this token, can you pull the Xerxes verdict on 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — I want the grade, whether the owner is renounced, and if there are any proxy slots active?"},{"title":"Roast a meme coin contract","prompt":"Roast this Base meme coin contract for me — run a Xerxes token verdict on 0x532f27101965dd16442E59d40670FaF5eBB142E4 and tell me what grade it gets and what the AI one-liner says."},{"title":"Verify ERC-20 shape before integration","prompt":"I need to integrate a token at 0xB6fe221Fe9EeF5aBa221c348bA20A1Bf5e73624c into our system — can you check the Xerxes verdict to confirm it's ERC-20 shaped with valid decimals and total supply, and not RADIOACTIVE?"}],"resultDescription":"Returns a JSON object with: ok (boolean), a result object containing the token address, grade (BASED/MID/COOKED/RADIOACTIVE), grade_rule (human-readable explanation of why the grade was assigned), one_liner (≤60 char summary), roast (≤220 char AI-written quip), written_by (model or template), and facts (is_contract, code_bytes, name, symbol, decimals, total_supply, owner, owner_renounced, proxy_slot, proxy_implementation, proxy_slots_checked, erc20_shaped). Also includes chain, cached flag, and service name. Does NOT include holder counts, liquidity, or price data.","failureModes":["Address is not a deployed contract → grade RADIOACTIVE, is_contract: false","Address is a contract but lacks decimals/totalSupply → grade RADIOACTIVE, erc20_shaped: false","Malformed token address (not 0x + 40 hex) → input validation error, ok: false","Contract is unreachable or RPC error → ok: false with error field populated","Rate limit or payment failure → 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need a fast, opinionated on-chain structural assessment of a Base token contract — specifically checking ERC-20 conformance, proxy upgrade slots, and owner renouncement — without needing price, holder, or liquidity data. Ideal for pre-integration checks, due diligence automation, or entertaining AI roasts of sus contracts. Not suitable when you need live market data, holder distribution, or a formal security audit.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:14:47.146Z","isFirstParty":false,"canonicalSlug":"xerxes-token-verdict-api-e56f2c11"}