# Ethereum Token Verdict Preview

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

Fetches raw on-chain contract facts for an Ethereum ERC-20 token address — code size, name, symbol, decimals, total supply, owner, and proxy slots — without scoring or analysis.

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_eth_token_verdict_v1/eth_mainnet_token_verdict_preview?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ethereum-token-verdict-preview-e80f51a5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VPmRB9kFw3rxNLf_kJis4

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-preview-e80f51a5
```

Example prompt: Can you pull the raw on-chain contract facts for the Ethereum ERC-20 token at address 0xdAC17F958D2ee523a2206206994597C13D831ec7 — I want to see its name, symbol, decimals, total supply, owner, and whether it's a proxy?

## When to prefer this

Use this endpoint when you need cheap, fast, raw on-chain contract facts for an Ethereum mainnet ERC-20 token without needing a safety grade, price data, holder counts, or AI-generated verdict. Ideal as a lightweight first-pass check before calling more expensive analysis endpoints, or when you specifically need proxy slot inspection, ownership status, or basic ERC-20 shape validation straight from the chain.

## Known failure modes

- Invalid or non-checksummed contract address returns a 400 or validation error
- Address is an EOA (externally owned account), not a contract — is_contract returns false
- Token contract does not implement standard ERC-20 interface — erc20_shaped may return false
- Network connectivity or RPC node issues may cause timeouts
- Calling with a non-Ethereum address format (e.g. Base or other chain address) may return unexpected results

## How this service works

Token Quick Check: Ethereum mainnet contract facts -- name, supply, owner, code. Not financial advice.  Returns: a token verdict preview on one token contract: the contract facts the full verdict reads -- code size, name, symbol, decimals, total supply, owner(), proxy slots -- read from the chain. No grade, no model, no pool price, no holders, no safety or legitimacy call.

## Output

Returns a JSON object with the token's on-chain contract facts: name, symbol, decimals, total supply (raw and formatted), owner address, owner_renounced flag, code size in bytes, is_contract and erc20_shaped booleans, proxy slot values checked (eip1967, eip1967_beacon), proxy_implementation address if found, and upgradeable_proxy flag. No safety grade, no price, no holder data, no model-generated verdict — purely chain-read state.

## 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,
  "note": "A preview: the contract's own state read from the chain. No grade, no model, no pool price, no holders, no safety or legitimacy call. Not financial advice.",
  "chain": "ethereum",
  "cached": false,
  "method": "preview",
  "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": "88301265725.970534",
    "owner_function": true,
    "owner_renounced": false,
    "total_supply_raw": "88301265725970534",
    "upgradeable_proxy": false,
    "proxy_slots_checked": [
     "eip1967",
     "eip1967_beacon"
    ],
    "proxy_implementation": null
   },
   "token": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
  },
  "service": "x402_eth_token_verdict_v1.eth_mainnet_token_verdict_preview"
 }
}
```

## More

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