# Token Risk API

> Token Risk API is a paid API for AI agents from token-risk-api-topaz.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13).

Returns a 0-100 risk score with A-F grade, market data, and security flags for a given crypto token contract address or symbol

## Facts

- Endpoint: GET https://token-risk-api-topaz.vercel.app/v1/risk?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-risk-api-20332e0f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HVb3SeUCJ1gJ-FtXnV41j

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-api-20332e0f
```

Example prompt: Can you risk-check the token at 0x2091125bFE4259b2CfA889165Beb6290d0Df5DeA on Base and tell me the risk score, grade, and whether it's a honeypot or has hidden owner issues?

## When to prefer this

Prefer this endpoint when you need a quick, structured, pay-per-call risk intelligence snapshot for a specific crypto token without setting up an account or API key. It is especially useful for DeFi agents that need to screen tokens at the point of a trade or alert, or for portfolio monitoring workflows that require on-demand security checks across multiple chains including Base, Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, and Solana.

## Known failure modes

- Unknown or unrecognized contract address returns an error or null result
- Token symbol ambiguity when the same symbol exists on multiple chains without a chain hint
- Unsupported chain returns a validation error
- Newly deployed contracts with no on-chain history may produce incomplete market data
- Rate-limited or payment failure via x402 returns a 402 Payment Required response

## How this service works

Pay-per-call crypto token risk intelligence over x402 on Base mainnet. Given a contract address or symbol, returns a 0-100 risk score with A-F grade, market data (liquidity, age), and contract security flags (honeypot, hidden owner, mintable, taxes, holder concentration). $0.005 USDC per call, no signup, no API key. Not financial advice.

## Output

Returns a JSON object with a numeric risk score (0-100), letter grade (A-F), plain-English verdict (e.g. 'moderate risk'), a list of human-readable risk reasons, market data (chain, liquidity in USD, age in days), and security flags (honeypot boolean, mintable boolean, hiddenOwner boolean)

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "bsc",
    "polygon",
    "arbitrum",
    "base",
    "optimism",
    "avalanche",
    "solana"
   ],
   "type": "string",
   "description": "Chain hint (auto-detected if omitted)"
  },
  "token": {
   "type": "string",
   "description": "Contract address (0x...) or token symbol to risk-check"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "grade": "B",
  "score": 42,
  "token": "0x2091125bFE4259b2CfA889165Beb6290d0Df5DeA",
  "market": {
   "chain": "base",
   "ageDays": 30,
   "liquidityUsd": 100000
  },
  "reasons": [
   "holder concentration 52%",
   "tax 3% on buy"
  ],
  "verdict": "moderate risk",
  "security": {
   "honeypot": false,
   "mintable": true,
   "hiddenOwner": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-risk-api-20332e0f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from token-risk-api-topaz.vercel.app](https://www.zero.xyz/host/token-risk-api-topaz.vercel.app/llms.txt)