# Token Verdict API

> Token Verdict API is a paid API for AI agents from token-verdict.restockalarm.workers.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-29).

Runs a multi-factor token risk analysis on a Base ERC-20 address and returns a single verdict (avoid/high_risk/caution/low_risk) with a summary, risk score, rug-pull flags, holder concentration, momentum, and contract flags.

## Facts

- Endpoint: GET https://token-verdict.restockalarm.workers.dev/v1/verdict?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-verdict-api-f69c1be1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A27CSh_n6DSSVdL1b_Bui

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 token-verdict-api-f69c1be1
```

Example prompt: Can you run a full token risk check on contract 0x940181a94a35a4569e4529a3cdfb74e38fd98631 on Base and tell me if it's safe to buy — I want the verdict, rug-pull status, risk score, and any contract red flags like blacklists or pause functions.

## When to prefer this

Choose this endpoint when you need a single-call, all-in-one token safety verdict for Base ERC-20 tokens combining rug-pull heuristics, contract flag detection, holder concentration, and momentum — especially useful for agents that need a fast go/no-go signal before a trade or listing decision. Prefer it over manual on-chain queries when you want labeled holder exclusions (exchanges, bridges, lockers) and a normalized risk score in one response at low cost ($0.05).

## Known failure modes

- Invalid address format (not 0x + 40 hex) returns HTTP 400
- Missing or malformed address returns example response with example=true flag
- Token not indexed or insufficient on-chain data may yield low-confidence verdict
- Rate limits or payment failures via x402 protocol return payment-required errors
- Contract data unavailable from DexScreener or on-chain sources may produce incomplete flags

## How this service works

Token Verdict API for Base: one call runs token risk, rug-pull, holder and momentum checks plus contract flags (proxy, blacklist, pause, selfdestruct) and returns one verdict (avoid / high_risk / caution / low_risk) with a one-line English summary; top holders carry known labels (exchanges, bridges, lockers) that are excluded from concentration. $0.05 per call via x402 (USDC on Base or Polygon). Not investment advice.

## Output

Returns a JSON object with: a one-word verdict (avoid/high_risk/caution/low_risk), a one-line English summary, a risk score (0-100), rug_pull boolean with confidence, holder distribution label and top-10 wallet percentage (excluding known contracts/exchanges), momentum score and direction, pooled liquidity in USD, and contract flags (proxy, blacklist, pause, selfdestruct, mintable, honeypot, anti_whale, delegatecall). Also includes a disclaimer and verdict_confidence level.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC-20 contract address on Base (0x + 40 hex). If omitted, the AERO example is returned with example=true; an invalid address is 400."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "token": {
   "name": "Aerodrome",
   "symbol": "AERO"
  },
  "cached": false,
  "address": "0x940181a94a35a4569e4529a3cdfb74e38fd98631",
  "reasons": [],
  "summary": "AERO: low_risk — risk 20/100, rug_pull false (3/5 signals measured), top-10 wallets 15.13% (distributed), liquidity $49.65M pooled / top pool $35.11M (dexscreener), momentum 78 (down); contract flags: mintable.",
  "verdict": "low_risk",
  "components": {
   "rug": {
    "rug_pull": false
   },
   "risk": {
    "score": 20
   },
   "holders": {
    "distribution": "distributed"
   },
   "momentum": {
    "momentum": 78,
    "direction": "down"
   }
  },
  "disclaimer": "Not investment advice. Automated verdict from public on-chain and DEX data, combining four heuristics; it can be incomplete or wrong. Do your own research.",
  "key_metrics": {
   "bundling": "none",
   "momentum": 78,
   "rug_pull": false,
   "direction": "down",
   "liquidity": {
    "source": "dexscreener",
    "pooled_all_pools_usd": 49650000,
    "top_pool_liquidity_usd": 35110000
   },
   "risk_score": 20,
   "distribution": "distributed",
   "contract_flags": {
    "pause": false,
    "proxy": {
     "value": false
    },
    "honeypot": false,
    "mintable": true,
    "blacklist": false,
    "anti_whale": false,
    "paused_now": false,
    "delegatecall": false,
    "selfdestruct": false
   },
   "rug_confidence": "medium",
   "top10_wallets_pct": 15.13,
   "top10_excluding_contracts_pct": 15.13
  },
  "verdict_rule": "…",
  "verdict_confidence": "medium"
 }
}
```

## More

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