# Token Security & Verdict API (x402)

> Token Security & Verdict API (x402) is a paid API for AI agents from seo-mcp-x402.abacusai.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-22).

Returns a comprehensive security verdict for an ERC-20 token on Base or Ethereum, including risk score, honeypot detection, liquidity, holder concentration, and a plain-language summary.

## Facts

- Endpoint: POST https://seo-mcp-x402.abacusai.app/verdict?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-security-verdict-api-x402-fff652ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PedLf8nW6AP9vWLq1HTnV

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-security-verdict-api-x402-fff652ba -d '<json body>'
```

Example prompt: Can you check whether the token at address 0x532f27101965dd16442e59d40670faf5ebb142e4 on Base is safe — give me its risk score, honeypot status, liquidity, and a verdict?

## When to prefer this

Choose this endpoint when you need a fast, multi-signal ERC-20 security assessment combining on-chain RPC data, GoPlus security flags, and DexScreener liquidity — all in one call. It is specifically suited for Base and Ethereum tokens and returns a structured verdict with a human-readable summary, making it ideal for pre-trade checks, DeFi bot guardrails, or token screening workflows. Prefer it over building your own aggregation when you need honeypot detection, tax analysis, holder concentration, and liquidity in a single $0.02 pay-per-call API.

## Known failure modes

- Invalid contract address format (must match ^0x[0-9a-fA-F]{40}$) — returns validation error
- Token not found on specified chain — may return empty flags with limited data
- Unsupported chain value (only 'base' and 'ethereum' accepted) — returns enum validation error
- Payment failure via x402 protocol — returns 402 Payment Required
- External data source (GoPlus, DexScreener, RPC) unavailable — partial results or timeout
- Very new or low-liquidity token may have incomplete holder or liquidity data

## How this service works

Paid SEO tools and the **Token Security & Verdict API** (`POST /verdict`, 0.02 USDC), exposed both as REST
endpoints and as an **MCP server** (`POST /mcp`, Streamable HTTP).

### Token Security & Verdict API
`POST /verdict` with `{"address": "0x...", "chain": "base" | "ethereum"}` returns a risk score (0-100), flags,
liquidity, holder concentration, honeypot indicators, top holders and a short summary. Data: GoPlus Security,
DexScreener and public JSON-RPC; if every source is down the result is an estimate marked `"source": "estimated"`.
Payments go to `0x4C5D82B27E857E4FCE5607b34041aD2d9c74eD1B`; its EIP-712 domain name is **"Token Verdict x402"** (all other domain fields are as below).
Every unpaid GET/HEAD/POST returns 402 with
`X-Payment: {"amount":"0.02","currency":"USDC","recipient":"0x4C5D82B27E857E4FCE5607b34041aD2d9c74eD1B","network":"base","mimeType":"application/json","resource":"token_verdict"}`.
Invalid input after a valid payment returns **400** and the payment proof is not consumed.

### Standard x402 payments (recommended - settled on-chain, indexed by x402scan)
Every 402 carries a base64 `PAYMENT-REQUIRED` header (x402 v2): scheme `exact`, network `eip155:8453`,
asset USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`. Retry with a `PAYMENT-SIGNATURE` header (v2 PaymentPayload, EIP-3009
`transferWithAuthorization`; v1 payloads in `X-PAYMENT` are also accepted). The server verifies via the PayAI facilitator,
runs the tool, then settles on-chain (facilitator pays gas) and returns the receipt in `PAYMENT-RESPONSE`.
Tool errors (e.g. 400 bad input) are **not** settled. Works out of the box with `@x402/fetch` + `@x402/evm`.

### Legacy payment flow (custom tx_hash proof)
1. Call a tool without payment -> **HTTP 402**. The `X-Payment` response header contains JSON:
   `{"amount","currency":"USDC","recipient","network":"base","mimeType","resource"}`.
2. Pay `amount` USDC on Base to `recipient`, then sign the EIP-712 typed data below with the payer wallet.
3. Retry with header `X-PAYMENT: {"tx_hash":"0x..","payer":"0x..","amount":"0.01","signature":"0x.."}`
   (raw JSON or base64 JSON) -> **HTTP 200** with results and an `X-Payment-Response` receipt header.

EIP-712 domain: `{name: "SEO MCP x402", version: "1", chainId: 8453, verifyingContract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913}`;
type `Payment(address payer, address recipient, uint256 amount, bytes32 txHash)` with `amount` in USDC atomic units (6 decimals).
Each `tx_hash` can be redeemed once. Rate limit: 10 calls / 60s per payer (HTTP 429).
If a tool fails (4xx/5xx tool_error) the payment is **not** consumed and can be retried.

## Output

A JSON object containing: verdict label (e.g. LIKELY_SAFE), risk score 0-100, risk level, security flags array, honeypot analysis (buy/sell tax, cannot_sell_all, blacklist, transfer_pausable), token metadata (name, symbol, decimals, is_open_source, owner_address), liquidity info (total USD, main DEX pair, price, LP lock status), holder stats (top10 percent, largest holder percent, holder count), top holders list with addresses and balances, data sources used (RPC, GoPlus, DexScreener), and a plain-English summary sentence. Also includes payment metadata (payer, tx_hash, USDC amount, response time).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum"
   ],
   "type": "string",
   "default": "base",
   "description": "Chain the token lives on"
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "ERC-20 token contract address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "token_verdict",
  "result": {
   "chain": "base",
   "flags": [],
   "token": {
    "name": "Brett",
    "symbol": "BRETT",
    "decimals": 18,
    "is_proxy": false,
    "total_supply": 9999997544.34,
    "owner_address": null,
    "is_open_source": true,
    "creator_address": null
   },
   "source": "live",
   "address": "0x532f27101965dd16442e59d40670faf5ebb142e4",
   "holders": {
    "holder_count": 909678,
    "owner_percent": null,
    "top10_percent": 25.1,
    "creator_percent": 0,
    "largest_unlocked_holder_percent": 11.67,
    "top10_percent_excluding_burn_and_locked": 25.1
   },
   "sources": {
    "rpc": true,
    "goplus": true,
    "dexscreener": true
   },
   "summary": "Brett (BRETT) on Base scores 0/100 risk (low): verdict LIKELY_SAFE. No honeypot, tax or ownership red flags were detected. Not financial advice.",
   "verdict": "LIKELY_SAFE",
   "chain_id": 8453,
   "honeypot": {
    "blacklist": false,
    "cannot_buy": false,
    "is_honeypot": false,
    "tax_modifiable": false,
    "buy_tax_percent": 0,
    "cannot_sell_all": false,
    "sell_tax_percent": 0,
    "transfer_pausable": false,
    "transfer_tax_percent": 0,
    "creator_honeypot_history": false
   },
   "liquidity": {
    "main_pair": {
     "dex": "aerodrome",
     "price_usd": 0.004439,
     "liquidity_usd": 666465.67
    },
    "pair_count": 30,
    "lp_locked_percent": null,
    "total_liquidity_usd": 1500000
   },
   "risk_level": "low",
   "risk_score": 0,
   "top_holders": [
    {
     "tag": null,
     "address": "0x7061f0b28f5a95aae717905bb59aa4e08c165268",
     "balance": 1167415538.59,
     "percent": 11.67,
     "is_locked": false,
     "is_contract": false
    }
   ],
   "generated_at": "2026-11-01T12:00:00+00:00"
  },
  "payment": {
   "payer": "0x0000000000000000000000000000000000000001",
   "amount": "0.02",
   "tx_hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
   "currency": "USDC",
   "response_time_ms": 850
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-security-verdict-api-x402-fff652ba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from seo-mcp-x402.abacusai.app](https://www.zero.xyz/host/seo-mcp-x402.abacusai.app/llms.txt)
