# Canisell Batch Verdict API

> Canisell Batch Verdict API is a paid API for AI agents from api.canisell.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-02).

Returns SAFE/CAUTION/DANGER risk verdicts for up to 10 Base ERC-20 tokens at once, covering sellability, taxes, owner powers, liquidity, and token age

## Facts

- Endpoint: POST https://api.canisell.xyz/v1/verdict/batch?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/canisell-batch-verdict-api-de801cb3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eMxbnlb7f6oJTOctoTnsg

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 canisell-batch-verdict-api-de801cb3 -d '<json body>'
```

Example prompt: Before my trading bot buys into this new Base token at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed, can you run a Canisell verdict on it to check if it's a honeypot, what the sell tax is, and whether there's enough liquidity to get out?

## When to prefer this

Choose Canisell when your agent or trading bot needs automated, pay-per-call (no API key, no subscription) on-chain risk screening for Base ERC-20 tokens before executing a trade. It is uniquely suited for real-time sniper bot pre-flight checks, batch screening of newly launched tokens, or any workflow where you need a structured SAFE/CAUTION/DANGER verdict with specific mechanical risk flags (honeypot detection, tax rates, liquidity depth) rather than a general news or sentiment signal. Prefer this over manual contract audits or social-sentiment tools when you need on-chain, deterministic, machine-readable risk verdicts at low per-call cost.

## Known failure modes

- Invalid address format (non-0x hex) returns validation error
- Token not deployed on Base mainnet returns no results or error
- Exceeding 10 addresses in a single batch returns 400 error
- Payment not provided or insufficient USDC via x402 returns 402 Payment Required
- Very new token with no liquidity pool may return partial flags
- Network congestion on Base may increase latency beyond typical ~1.3s
- Contract address is valid but not an ERC-20 token may yield incomplete flags

## How this service works

Pay-per-call API (x402, USDC) that returns a SAFE / CAUTION / DANGER verdict with reasons for new ERC-20 tokens on Base: sellability, taxes, owner powers, liquidity, token age. No accounts, no API keys. Also an MCP tool.

## Output

A JSON array of results, one per token address, each containing: a SAFE/CAUTION/DANGER verdict, detected flags (age, creator powers, trading mechanics like buy/sell tax percentages, canBuy/canSell booleans, round-trip loss %), liquidity pools with USD depth, engine version, block number checked, and a disclaimer. Also includes latency and any partial-check warnings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "addresses": {
   "type": "array",
   "items": {
    "type": "string",
    "example": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "pattern": "^0x[0-9a-fA-F]{40}$",
    "description": "ERC-20 token contract address on Base mainnet (chain id 8453)"
   },
   "maxItems": 10,
   "minItems": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "meta": {
     "block": 53369630,
     "engine": "0.1.0",
     "partial": [],
     "checkedAt": "2026-11-01T10:23:28.499Z",
     "latencyMs": 1274,
     "disclaimer": "Automated on-chain risk signals for Base, not financial advice. A SAFE verdict means no mechanical trap was detected, not that the price will hold."
    },
    "chain": "base",
    "flags": {
     "age": {
      "olderThanDays": 30
     },
     "creator": {},
     "trading": {
      "pool": "0xBA3F945812a83471d709BCe9C3CA699A19FB46f7",
      "stage": 0,
      "buyGas": 127092,
      "canBuy": true,
      "canSell": true,
      "quoteIn": 0.00882234,
      "sellGas": 68084,
      "poolKind": "uniswap-v3",
      "attempted": true,
      "buyTaxPct": 0,
      "quoteInUsd": 20,
      "sellTaxPct": 0,
      "roundTripLossPct": 1.99
     },
     "liquidity": {
      "pools": [
       {
        "id": "0xBA3F945812a83471d709BCe9C3CA699A19FB46f7",
        "lp": {
         "status": "unknown"
        },
        "kind": "uniswap-v3",
        "quote": "0x4200000000000000000000000000000000000006",
        "source": "factory",
        "depthUsd": 688673,
        "depthQuote": 303.785329,
        "quoteSymbol": "WETH"
       },
       {
        "id": "0x4e829F8A5213c42535AB84AA40BD4aDCCE9cBa02",
        "lp": {
         "status": "unknown"
        },
        "kind": "aerodrome-cl",
        "quote": "0x4200000000000000000000000000000000000006",
        "source": "factory",
        "depthUsd": 317511,
        "depthQuote": 140.059346,
        "quoteSymbol": "WETH"
       },
       {
        "id": "0x76Bf0abD20f1e0155Ce40A62615a90A709a6C3D8",
        "lp": {
         "status": "unknown"
        },
        "kind": "uniswap-v3",
        "quote": "0x4200000000000000000000000000000000000006",
        "source": "factory",
        "depthUsd": 28002,
        "depthQuote": 12.352248,
        "quoteSymbol": "WETH"
       },
       {
        "id": "0x27402edf3c6a6d6b5a279dfc7a2c8cbacebbfdfc3559f7c03d6971b09126a9f3",
        "lp": {
         "status": "unknown"
        },
        "fee": 3000,
        "kind": "uniswap-v4",
        "hooks": "0x0000000000000000000000000000000000000000",
        "quote": "0x0000000000000000000000000000000000000000",
        "source": "standard-key",
        "depthUsd": 1471,
        "depthQuote": 0.64899,
        "quoteSymbol": "ETH",
        "tickSpacing": 60
       },
       {
        "id": "0x36a46dFF597C5A444bbC521D26787F57867D221
… (truncated)
```

## More

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