# TokenVerdict Deep Token Safety Analysis

> TokenVerdict Deep Token Safety Analysis is a paid API for AI agents from api.youraitools.co, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-23).

Performs a comprehensive on-chain safety analysis of a Base ERC-20 token contract, returning a scored verdict with honeypot checks, liquidity data, holder distribution, ownership status, and buy/sell simulation results.

## Facts

- Endpoint: GET https://api.youraitools.co/tokenverdict/v1/deep?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenverdict-deep-token-safety-analysis-132b9a7e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jjfmDjOksDO2yGNxzjgqC

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 tokenverdict-deep-token-safety-analysis-132b9a7e
```

Example prompt: Can you do a deep safety check on the Base token at 0x532f27101965dd16442E59d40670FaF5eBB142E4 — I want to know if it's a honeypot, whether the contract is renounced, the safety score, and whether a simulated buy and sell actually worked?

## When to prefer this

Choose this endpoint when you need a comprehensive, scored safety assessment of a specific Base ERC-20 token before trading or recommending it — particularly when you need buy/sell simulation, holder analysis, ownership status, and contract verification in a single call. Prefer this over basic token lookups (price/volume APIs) when the question is 'is this safe?' rather than 'what is the price?'. This is the deep tier, so use it when thoroughness matters and you can accept slightly higher latency than a lightweight check.

## Known failure modes

- Token address not found on Base chain — returns empty or error if the contract doesn't exist on chain 8453
- Unverified contract — powers checks may be incomplete or missing if source code is not on Sourcify
- No DEX pool found — liquidity and simulation fields will be null if token has never traded
- Invalid contract address format — malformed hex address returns validation error
- GeckoTerminal data unavailable — gt_score and honeypot flag may be null for very new or low-volume tokens
- Rate limiting or payment failure — 402 payment required if USDC payment not attached

## How this service works

Token due diligence API for Base (deep honeypot and liquidity analysis). Deep Base ERC-20 token due diligence: everything in the quick report plus buy-transfer-sell simulations on up to 2 pools (different venues), a table of up to 10 pools (DexScreener plus on-chain Uniswap v2/v3/v4, Aerodrome and PancakeSwap lookups) with liquidity, the contract creation block and a GeckoTerminal cross-check (gt_score, honeypot flag, developer holding).

## Output

Returns a JSON object with a safety verdict (SAFE/WARN/DANGER), confidence level, and numeric score (0-100), plus detailed checks covering: token age, contract ownership (renounced/address), proxy/upgradeability, special powers (mint, pause, blacklist, fees), holder count and top-10 concentration, contract verification status, liquidity (USD, pool count, main DEX), and buy/sell simulation results including tax percentages and round-trip loss. Also includes reasons array with severity-tagged explanations and a GeckoTerminal honeypot flag.

## 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": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "description": "Base (chain 8453) ERC-20 contract address, e.g. 0x532f27101965dd16442E59d40670FaF5eBB142E4"
      }
     },
     "description": "Search intents: token due diligence, deep token audit, multi pool honeypot test, holder concentration, base token research, erc20 rug check"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "key": {
       "type": "string"
      },
      "deep": {
       "type": "object"
      },
      "name": {
       "type": "string"
      },
      "tier": {
       "type": "string"
      },
      "chain": {
       "type": "string"
      },
      "score": {
       "type": "number"
      },
      "token": {
       "type": "string"
      },
      "checks": {
       "type": "object"
      },
      "symbol": {
       "type": "string"
      },
      "reasons": {
       "type": "array"
      },
      "verdict": {
       "type": "string"
      },
      "confidence": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "deep": {
   "pools": [
    "top 10 pools"
   ],
   "simulations": [
    "one per pool, up to 2"
   ],
   "geckoterminal": {
    "gt_score": 76.8,
    "is_honeypot": false,
    "developer_holding_pct": null
   },
   "creation_block": 10983962
  },
  "name": "Brett",
  "tier": "deep",
  "chain": "base",
  "score": 97,
  "token": "0x532f27101965dd16442e59d40670faf5ebb142e4",
  "checks": {
   "age": {
    "days": 968,
    "source": "first DEX pool (DexScreener)",
    "created_at": "2024-02-27T00:00:00.000Z"
   },
   "owner": {
    "address": "0x0000000000000000000000000000000000000000",
    "renounced": true,
    "is_contract": false
   },
   "proxy": {
    "type": null,
    "upgradeable": false
   },
   "powers": {
    "fees": [],
    "mint": [],
    "pause": [],
    "limits": [],
    "source": "verified ABI (sourcify)",
    "balance": [],
    "trading": [],
    "upgrade": [],
    "blacklist": [],
    "access_control": false
   },
   "holders": {
    "count": 909566,
    "source": "GeckoTerminal",
    "top10_pct": 32.6,
    "in_pools_pct": 1.7,
    "top10_ex_pools_est_pct": 30.9
   },
   "contract": {
    "verified": true,
    "verified_by": "Sourcify"
   },
   "liquidity": {
    "lp": null,
    "usd": 721405,
    "pools": 1,
    "main_pool": {
     "dex": "aerodrome",
     "quote": "WETH"
    }
   },
   "sellability": {
    "dex": "aerodrome",
    "buy_ok": true,
    "sell_ok": true,
    "pool_type": "v3",
    "simulated": true,
    "buy_tax_pct": 0,
    "transfer_ok": true,
    "sell_tax_pct": 0,
    "transfer_tax_pct": 0,
    "round_trip_loss_pct": 0.42
   }
  },
  "symbol": "BRETT",
  "reasons": [
   {
    "code": "top10",
    "text": "Top 10 holders own 30.9% (estimate excluding pools and burn).",
    "severity": "info"
   },
   {
    "code": "sellable",
    "text": "Simulated buy and sell both worked with no token tax (round trip lost 0.42% to pool/hook fees and price impact).",
    "severity": "good"
   },
   {
    "code": "renounced",
    "text": "Ownership renounced.",
    "severity": "good"
   },
   {
    "code": "verified",
    "text": "Source verified (Sourcify).",
    "severity": "good"
   }
  ],
  "verdict": "SAFE",
  "confidence": "high"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenverdict-deep-token-safety-analysis-132b9a7e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.youraitools.co](https://www.zero.xyz/host/api.youraitools.co/llms.txt)