# Base Token Safety Snapshot (x402)

> Base Token Safety Snapshot (x402) is a paid API for AI agents from base-token-safety-x402.grokbot-hk.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-16).

Returns a heuristic on-chain safety analysis of a Base ERC-20 token contract, checking for proxy patterns, mint/blacklist/pause functions, fee mechanisms, ownership, and liquidity.

## Facts

- Endpoint: GET https://base-token-safety-x402.grokbot-hk.workers.dev/token?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-token-safety-snapshot-x402-91cb8b1b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GSSo2AkAnkLiA3DcVj4QS

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 base-token-safety-snapshot-x402-91cb8b1b
```

Example prompt: Can you run a safety snapshot on the Base token at 0xBA3F945812a83471d709BCe9C3CA699A19FB46f7 and tell me if there are any red flags like hidden fees, mint functions, or unrenounced ownership?

## When to prefer this

Choose this endpoint when you need a quick, cheap ($0.01 USDC) heuristic safety scan of a specific Base ERC-20 token contract address using only public on-chain RPC data — no API key required. Ideal for pre-trade due diligence, token listing checks, or DeFi portfolio risk audits on Base (chain 8453). Not suitable when you need audited security guarantees, Ethereum mainnet analysis, or off-chain/social signal checks.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or unknown statuses across checks
- Non-Base contract addresses (wrong chain) may return misleading or empty results
- Heuristic confidence is capped at 'medium' — custom proxy patterns or obfuscated selectors are not detected
- RPC rate limits or node unavailability may cause partial or failed responses
- Recently deployed contracts may have limited on-chain data, reducing check reliability

## How this service works

Heuristic safety snapshot of a Base ERC-20 from public RPC data. $0.01 USDC per call via x402 on Base.

## Output

A JSON object containing: token metadata (name, symbol, decimals, total supply), a list of safety checks each with a status (pass/info/warn/fail/unknown) and detail, a flagged_checks array, discovered liquidity pools with approximate USD liquidity, an overall confidence level (low or medium), a summary string, and a disclaimer with known limitations.

## 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": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{40}$",
       "description": "ERC-20 token contract address on Base (chain 8453)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "address",
      "heuristic",
      "confidence",
      "checks",
      "limitations",
      "disclaimer"
     ],
     "properties": {
      "meta": {
       "type": "object"
      },
      "chain": {
       "type": "string"
      },
      "pools": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "token": {
       "type": "object",
       "properties": {
        "name": {
         "type": [
          "string",
          "null"
         ]
        },
        "symbol": {
         "type": [
          "string",
          "null"
         ]
        },
        "decimals": {
         "type": [
          "number",
          "null"
         ]
        },
        "total_supply": {
         "type": [
          "string",
          "null"
         ]
        }
       }
      },
      "checks": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "id",
         "status",
         "detail"
        ],
        "properties": {
         "id": {
          "type": "string"
         },
         "data": {},
         "detail": {
          "type": "string"
         },
         "status": {
          "enum": [
           "pass",
           "info",
           "warn",
           "fail",
           "unknown"
          ],
          "type": "string"
         }
        }
       }
      },
      "address": {
       "type": "string"
      },
      "chainId": {
       "type": "number"
      },
      "summary": {
       "type": "string"
      },
      "heuristic": {
       "type": "boolean",
       "const": true
      },

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "note": "EXAMPLE snapshot captured once for illustration; not live",
   "took_ms": 250,
   "version": "0.1.0",
   "generated_at": "2026-10-10T00:00:00.000Z",
   "rpc_requests": 8
  },
  "chain": "base",
  "pools": [
   {
    "dex": "uniswap_v3",
    "pool": "0xBA3F945812a83471d709BCe9C3CA699A19FB46f7",
    "quote": "WETH",
    "pool_param": "10000",
    "approx_liquidity_usd": 1516851
   },
   {
    "dex": "aerodrome_slipstream",
    "pool": "0x4e829F8A5213c42535AB84AA40BD4aDCCE9cBa02",
    "quote": "WETH",
    "pool_param": "tickSpacing=200",
    "approx_liquidity_usd": 765005
   },
   {
    "dex": "uniswap_v3",
    "pool": "0x76Bf0abD20f1e0155Ce40A62615a90A709a6C3D8",
    "quote": "WETH",
    "pool_param": "3000",
    "approx_liquidity_usd": 80895
   }
  ],
  "token": {
   "name": "Brett",
   "symbol": "BRETT",
   "decimals": 18,
   "total_supply": "9999997544.340006",
   "total_supply_raw": "9999997544340006294456944163"
  },
  "checks": [
   {
    "id": "is_contract",
    "data": {
     "bytes": 23271
    },
    "detail": "Contract with 23271 bytes of runtime code.",
    "status": "pass"
   },
   {
    "id": "proxy",
    "detail": "No EIP-1967 / legacy-zOS / EIP-1167 proxy pattern detected (custom proxy patterns are not detected).",
    "status": "pass"
   },
   {
    "id": "erc20_interface",
    "detail": "Responds to decimals() and totalSupply() like an ERC-20.",
    "status": "pass"
   },
   {
    "id": "mint_functions",
    "data": [],
    "detail": "No common mint selectors found (heuristic).",
    "status": "pass"
   },
   {
    "id": "blacklist_functions",
    "data": [],
    "detail": "No common blacklist selectors found (heuristic).",
    "status": "pass"
   },
   {
    "id": "pause_trading_functions",
    "data": [
     "enableTrading()"
    ],
    "detail": "Pause/trading-toggle selectors present (enableTrading()).",
    "status": "warn"
   },
   {
    "id": "fee_tax_functions",
    "data": [
     "excludeFromFees(address,bool)"
    ],
    "detail": "Fee/tax setter or exemption selectors present (excludeFromFees(address,bool)); transfer fees may be configurable.",
    "status": "warn"
   },
   {
    "id": "limit_functions",
    "data": [
     "removeLimits()"
    ],
    "detail": "Max-tx/wallet/cooldown selectors present (removeLimits()).",
    "status": "warn"
   },
   {
    "id": "ownership",
    "data": {
     "owner": "0x0000000000000000000000000000000000000000",
     "renounced": true
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-token-safety-snapshot-x402-91cb8b1b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base-token-safety-x402.grokbot-hk.workers.dev](https://www.zero.xyz/host/base-token-safety-x402.grokbot-hk.workers.dev/llms.txt)
