# Ethereum Token Verdict

> Ethereum Token Verdict is a paid API for AI agents from api.arysphere.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-22).

Returns an AI-written safety verdict (grade, one-liner, roast) plus on-chain facts and Uniswap V3 market data for any Ethereum mainnet ERC-20 token contract

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_eth_token_verdict_v1/eth_mainnet_token_verdict?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ethereum-token-verdict-da57df88
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y-eERQX2tiWNdFmFtYVgs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ethereum-token-verdict-da57df88
```

Example prompt: Give me the full verdict on Ethereum token 0xdAC17F958D2ee523a2206206994597C13D831ec7 — I want the grade, the roast, and the on-chain facts.

## When to prefer this

Choose this endpoint when you need a quick, all-in-one Ethereum mainnet ERC-20 safety signal combining on-chain contract analysis (owner, proxy, upgrade risk) with live Uniswap V3 market depth and an AI-generated human-readable verdict — without needing an API key or account. Prefer over raw RPC calls when you want a pre-packaged risk grade and entertaining summary in one paid-per-call request.

## Known failure modes

- Invalid or non-hex contract address returns a validation error
- Address is not a deployed contract (returns RADIOACTIVE grade)
- Token has no Uniswap V3 liquidity pools (market section may be absent or empty)
- Payment not sent or USDC balance insufficient on Base (402 Payment Required)
- RPC or on-chain read timeout for obscure or recently deployed tokens
- Token is not ERC-20 shaped (no decimals/totalSupply) — graded RADIOACTIVE

## How this service works

Check this CA: Ethereum mainnet ERC-20 verdict of a token contract address. Not financial advice.  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; plus the deepest Uniswap V3 pool's USD price and depth. No holders, no safety or legitimacy call.

## Output

A JSON object containing: ok status, chain identifier, grade (RADIOACTIVE/COOKED/MID/BASED), cached flag, contract facts (name, symbol, owner address, decimals, total supply, proxy slots, ERC-20 shape), Uniswap V3 market data (price USD, pool depth category, deepest pool details, ETH/USD rate from Chainlink), an AI-written one-liner, an AI-written roast, and the grade rule explanation. Also includes a disclaimer that results are entertainment, not financial advice.

## Request schema (JSON Schema)

```json
{
 "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",
     "properties": {
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "token contract, 0x + 40 hex"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "chain": "ethereum",
  "grade": "MID",
  "cached": false,
  "method": "verdict",
  "result": {
   "facts": {
    "name": "Tether USD",
    "owner": "0xc6cde7c39eb2f0f0095f41570af89efc2c1ea828",
    "symbol": "USDT",
    "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "decimals": 6,
    "code_bytes": 11075,
    "proxy_slot": null,
    "is_contract": true,
    "erc20_shaped": true,
    "total_supply": "88302633055.702652",
    "owner_function": true,
    "owner_renounced": false,
    "total_supply_raw": "88302633055702652",
    "upgradeable_proxy": false,
    "proxy_slots_checked": [
     "eip1967",
     "eip1967_beacon"
    ],
    "proxy_implementation": null
   },
   "grade": "MID",
   "roast": "A textbook ERC-20 with a live owner and no proxy tricks. It's the vanilla ice cream of tokens—technically fine, but nobody's writing home about it.",
   "token": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
   "market": {
    "dex": "uniswap_v3",
    "eth_usd": 2431.49722133,
    "fee_tiers": [
     500,
     3000
    ],
    "price_usd": 1.00052,
    "rpc_calls": 2,
    "depth_rule": "pool_depth from the deepest pool's quote-side reserve in USD: <$1k none_or_dust, <$100k thin, <$5M moderate, else deep. A description of on-chain state, not advice.",
    "pool_depth": "deep",
    "pools_found": 6,
    "deepest_pool": {
     "fee": 3000,
     "pool": "0x4e68ccd3e89f51c3074ca5072bbac773960dfa36",
     "quote": "WETH",
     "price_usd": 1.00052,
     "token_reserve": 28892113.616802,
     "quote_reserve_usd": 67298314.08
    },
    "quote_assets": [
     "WETH",
     "USDC"
    ],
    "eth_usd_source": "chainlink ETH/USD 0x5f4ec3df9cbd43714fe2740f5e3616155c5b8419",
    "quote_reserve_usd": 67298314.08
   },
   "one_liner": "USDT: Six decimals, one owner, zero drama.",
   "disclaimer": "Entertainment, not financial advice. Reads the contract and its deepest Uniswap V3 pool (spot price, quote-side depth): not holders, locks or future price.",
   "grade_rule": "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.",
   "written_by": "model"
  },
  "service": "x402_eth_token_verdict_v1.eth_mainnet_token_verdict",
  "disclaimer": "Entertainment, not financial advice. Reads the contract and its deepest Uniswap V3 pool (spot price, quote-side 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ethereum-token-verdict-da57df88/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arysphere.com](https://www.zero.xyz/host/api.arysphere.com/llms.txt)