# Token Risk Assessment API (Base ERC-20)

> Token Risk Assessment API (Base ERC-20) is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Returns a risk score, verdict, and detailed risk flags for a Base ERC-20 token contract address, including honeypot detection, tax analysis, and holder concentration.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/token-risk?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-risk-assessment-api-base-erc-20-88ef99b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NxNjg4RQLu-l2IloJGNjD

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-risk-assessment-api-base-erc-20-88ef99b6
```

Example prompt: Can you check whether the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base is safe to trade — is it a honeypot, what's the risk score, and are there any red flags like high sell tax or upgradeable proxy?

## When to prefer this

Use this endpoint when an AI trading agent or DeFi automation pipeline needs a quick, cheap ($0.01 USDC), no-API-key risk gate before executing a token swap or liquidity provision on Base. It is especially suited for autonomous agents that need to verify token safety programmatically via x402 micropayments without setting up OAuth or API key management. Prefer it over full smart contract audit services when you need a fast, lightweight signal rather than a deep manual review.

## Known failure modes

- Invalid or non-ERC-20 address returns error or empty result
- Address not on Base chain may return incorrect or no data
- Payment failure via x402 if insufficient USDC balance on Base
- Rate limiting or worker downtime on the Cloudflare Workers backend
- Newly deployed contracts with no on-chain data may return incomplete analysis

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

A JSON object with a risk verdict (OK/WARNING/DANGER), numeric risk score (0-100), risk level label (low/medium/high), boolean flags for can_sell and should_buy, honeypot simulation result, buy/sell tax percentages, top-10 holder percentage, contract metadata (verified source, bytecode size, is_contract), and a list of human-readable risk reason strings and flags such as 'upgradeable_proxy'.

## 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[0-9a-fA-F]{40}$",
       "examples": [
        "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       ],
       "description": "Base ERC-20 contract"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "flags": [
   "upgradeable_proxy"
  ],
  "token": {
   "symbol": "USDC",
   "decimals": 6,
   "holder_count": 11391096
  },
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "reasons": [
   "upgradeable proxy (logic can change)"
  ],
  "trading": {
   "buy_tax": 0,
   "sell_tax": 0,
   "honeypot_sim": {
    "is_honeypot": false
   },
   "top10_holder_pct": 26.49
  },
  "verdict": "OK",
  "can_sell": true,
  "contract": {
   "is_contract": true,
   "bytecode_bytes": 1852,
   "verified_source": true
  },
  "risk_level": "low",
  "risk_score": 5,
  "should_buy": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-risk-assessment-api-base-erc-20-88ef99b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)