# Crypto Token Risk API

> Crypto Token Risk API is a paid API for AI agents from crypto-risk-api-jw3l.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns a real-time risk score, whale concentration metrics, and honeypot flags for a given crypto token address

## Facts

- Endpoint: GET https://crypto-risk-api-jw3l.onrender.com/api/v1/risk-score
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-token-risk-api-82c5c568
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KoEh87_Yyy3nLFnavHK3A

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 crypto-token-risk-api-82c5c568
```

Example prompt: Can you check whether the token at address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 is safe to trade — give me its risk score, whether it's a honeypot, and how concentrated the top holders are?

## When to prefer this

Use this endpoint when an agent needs a fast, pre-trade safety assessment of a specific EVM token address — particularly for honeypot detection, whale concentration checks, and tax analysis — before executing a DeFi swap. Prefer this over generic on-chain data APIs when you need aggregated risk signals (score + flags + LP status) in a single call rather than raw blockchain data.

## Known failure modes

- Invalid or malformed token address returns an error response
- Unrecognized or very new token address may return null for many fields like symbol, price, and taxes
- Illiquid or unlisted tokens may have missing liquidity and volume data
- Network or provider downtime may cause timeouts or 5xx errors
- Token on an unsupported chain returns incomplete or empty data

## How this service works

Real-time token risk score, whale concentration, and honeypot check

## Output

Returns a JSON object with a numeric risk score and categorical risk rating, an array of flags (e.g. honeypot, high tax, low liquidity), token symbol, current price in USD, buy/sell tax percentages, LP lock status, holder count, top-10 holder percentage, 24h volume and price change, total liquidity in USD, and a recommended max slippage string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "tokenAddress"
 ],
 "properties": {
  "tokenAddress": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "flags": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "token": {
   "type": "string"
  },
  "symbol": {
   "type": [
    "string",
    "null"
   ]
  },
  "lpLocked": {
   "type": [
    "boolean",
    "null"
   ]
  },
  "priceUsd": {
   "type": [
    "number",
    "null"
   ]
  },
  "buyTaxPct": {
   "type": [
    "number",
    "null"
   ]
  },
  "riskScore": {
   "type": "number"
  },
  "timestamp": {
   "type": "integer"
  },
  "riskRating": {
   "type": "string"
  },
  "sellTaxPct": {
   "type": [
    "number",
    "null"
   ]
  },
  "holderCount": {
   "type": [
    "integer",
    "null"
   ]
  },
  "liquidityUsd": {
   "type": [
    "number",
    "null"
   ]
  },
  "volume24hUsd": {
   "type": [
    "number",
    "null"
   ]
  },
  "priceChange24h": {
   "type": [
    "number",
    "null"
   ]
  },
  "top10HolderPct": {
   "type": [
    "number",
    "null"
   ]
  },
  "recommendedMaxSlippage": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-token-risk-api-82c5c568/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto-risk-api-jw3l.onrender.com](https://www.zero.xyz/host/crypto-risk-api-jw3l.onrender.com/llms.txt)