# Base Token Verdict

> Base 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-31).

Returns a risk-graded report (RADIOACTIVE/COOKED/MID/BASED) for a Base chain ERC-20 token contract, including proxy/owner facts and Uniswap V3 market depth.

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_q_verdict_v1/base_token_verdict_v3?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-token-verdict-76a547a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DpWwzwdakyJTQIH_mB2MW

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 base-token-verdict-76a547a7
```

Example prompt: Can you run an Arysphere token verdict on the Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and tell me the risk grade, whether it's an upgradeable proxy, who owns it, and how deep the liquidity is?

## When to prefer this

Use this endpoint when you need a fast, payable-per-call risk verdict on a Base chain ERC-20 token without any account or subscription setup. It is ideal for DeFi agents, trading bots, or wallet UIs that need to gate trades behind a quick safety check. Prefer it over generic block explorers when you want a structured grade (BASED/MID/COOKED/RADIOACTIVE) plus proxy/owner analysis and live Uniswap V3 depth in a single call. Choose the Ethereum mainnet sibling endpoint instead for non-Base tokens.

## Known failure modes

- Invalid or malformed contract address (not 0x + 40 hex) returns a validation error
- Address is an EOA (not a contract) — grade returned as RADIOACTIVE with is_contract: false
- No Uniswap V3 pool found for the token — market section omitted or depth returned as none_or_dust
- Payment of $0.01 USDC not received or x402 handshake fails — 402 Payment Required response
- Token exists but has no ERC-20 methods — grade returned as RADIOACTIVE with erc20_shaped: false
- RPC timeout or Base node unreachable — 500 or upstream error response

## How this service works

Base ERC-20 verdict: AI grade and on-chain facts for one token contract. Not financial advice.  Returns: a rule-graded 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 (base), risk grade (RADIOACTIVE/COOKED/MID/BASED), a roast one-liner, contract facts (name, symbol, decimals, owner address, owner_renounced flag, proxy slot type, upgradeable_proxy flag, erc20_shaped, is_contract), and market data (Uniswap V3 price in USD, pool depth classification, deepest pool details including fee tier and reserve sizes in USD, ETH/USD from Chainlink). Cached flag indicates whether result was freshly fetched.

## 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": "base",
  "grade": "COOKED",
  "cached": false,
  "method": "verdict",
  "result": {
   "facts": {
    "name": "USD Coin",
    "owner": "0x3abd6f64a422225e61e435bae41db12096106df7",
    "symbol": "USDC",
    "decimals": 6,
    "proxy_slot": "zeppelinos",
    "is_contract": true,
    "erc20_shaped": true,
    "owner_renounced": false,
    "upgradeable_proxy": true
   },
   "grade": "COOKED",
   "roast": "USDC: COOKED. Proxy (zeppelinos slot set); a live owner holds the keys.",
   "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "market": {
    "dex": "uniswap_v3",
    "eth_usd": 2432.8015,
    "fee_tiers": [
     500,
     3000,
     10000
    ],
    "price_usd": 1.00209,
    "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": 3,
    "deepest_pool": {
     "fee": 3000,
     "pool": "0x6c561b446416e1a00e8e93e221854d6ea4171372",
     "quote": "WETH",
     "price_usd": 1.00209,
     "token_reserve": 58770808.350535,
     "quote_reserve_usd": 87721037.3
    },
    "quote_assets": [
     "WETH",
     "USDC"
    ],
    "eth_usd_source": "chainlink ETH/USD 0x71041dddad3595f9ced3dccfbe3d1f4b0a16bb70",
    "quote_reserve_usd": 87721037.3
   },
   "one_liner": "USDC is COOKED",
   "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": "template"
  },
  "service": "x402_bazaar_token_verdict_v2.base_token_verdict_v3",
  "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."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-token-verdict-76a547a7/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)