# Base Verdict Facts Bundle

> Base Verdict Facts Bundle is a paid API for AI agents from api.arysphere.com, paid per call via x402, $0.012/call, status unknown (last checked 2026-10-25).

Returns combined on-chain token contract facts and AI-written verdict (grade, one-liner, roast, market data) for a Base token in a single paid call

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_bazaar_token_verdict_v2/base_verdict_facts_bundle?utm_source=zero.xyz
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-25
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-verdict-facts-bundle-44ed7ace
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_icuyPyiQUDNB3coJwl5LZ

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-verdict-facts-bundle-44ed7ace
```

Example prompt: Can you pull the full on-chain facts and verdict for the Base token at 0x4200000000000000000000000000000000000006 — I want the grade, roast, owner info, and any proxy or market data all at once?

## When to prefer this

Choose this bundle endpoint when you need both the quick preview facts AND the full AI verdict for a Base token in a single round-trip and payment. It costs $0.012 USDC but replaces two separate calls (base_token_verdict_preview + base_token_verdict_v3), saving latency and reducing per-call overhead. Prefer it over individual endpoints when building dashboards, bots, or reports that need complete token intelligence in one shot. Use the individual endpoints instead if you only need one of the two data sets to avoid paying for unused parts.

## Known failure modes

- Token address not a valid ERC-20 contract on Base → grade returns RADIOACTIVE with error field
- Invalid or malformed token address (not 0x + 40 hex) → 400 input validation error
- Either part fails → entire bundle call fails (ok: false), partial results not returned
- Payment not processed or insufficient USDC balance → 402 payment required
- RPC node timeout reading Base chain state → 5xx error

## How this service works

Arysphere sells AI-written token verdicts and on-chain reads to agents and apps. No account, no API key, no subscription. Pay $0.002–$0.01 in USDC per call over x402.

## Output

A JSON object keyed by part name. 'base_token_verdict_preview' contains basic contract facts (name, symbol, decimals, total_supply, owner, code bytes, proxy info, ERC-20 shape check). 'base_token_verdict_v3' contains the full AI-written verdict including grade (BASED/MID/COOKED/RADIOACTIVE), one-liner, roast (up to 220 chars), all contract state facts, and optional market data (Uniswap V3 deepest pool vs WETH/USDC: price_usd, reserve, pool depth). The top-level 'ok' is true only when both parts succeed.

## 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",
     "required": [
      "ok",
      "service",
      "parts"
     ],
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "parts": {
       "type": "object",
       "required": [
        "base_token_verdict_preview",
        "base_token_verdict_v3"
       ],
       "properties": {
        "base_token_verdict_v3": {
         "type": "object",
         "required": [
          "ok",
          "service"
         ],
         "properties": {
          "ok": {
           "type": "boolean"
          },
          "chain": {
           "type": "string"
          },
          "error": {
           "type": "string",
           "description": "present when ok is false"
          },
          "grade": {
           "enum": [
            "BASED",
            "MID",
            "COOKED",
            "RADIOACTIVE"
           ],
           "description": "the same grade as result.grade (ax1-compatible)"
          },
          "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",
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-verdict-facts-bundle-44ed7ace/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)