# Token Risk Score API for Base

> Token Risk Score API for Base is a paid API for AI agents from token-risk.restockalarm.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-16).

Returns a 0-100 risk score for any ERC-20 token on Base, with liquidity depth, holder concentration, honeypot/tax checks, and contract flags.

## Facts

- Endpoint: GET https://token-risk.restockalarm.workers.dev/v1/risk?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/token-risk-score-api-for-base-ad086c89
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PZlh-zK-qlO2V99KFIBg5

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-score-api-for-base-ad086c89
```

Example prompt: Can you check the risk score for the token at 0x940181a94a35a4569e4529a3cdfb74e38fd98631 on Base — I want to know if it's a honeypot, what the holder concentration looks like, and how much liquidity it has?

## When to prefer this

Use this endpoint when you need a fast, structured, quantified risk assessment of a specific ERC-20 token on the Base network before trading, investing, or integrating it — especially when you need contract flag checks (honeypot, blacklist, pause, selfdestruct), holder concentration data, and liquidity depth in a single API call. Prefer this over manual on-chain inspection when you need a normalized 0-100 score suitable for automated decision-making or filtering in agent workflows.

## Known failure modes

- Invalid address format (not 0x + 40 hex) returns HTTP 400
- Token not found on Base or no DEX data available may return incomplete scores or null fields
- Network/upstream failures from DexScreener or on-chain data providers may cause errors
- Cached responses may be slightly stale for rapidly changing tokens
- Missing news data returns news_sentiment.level as 'no_data'

## How this service works

Token Risk Score API for Base: one call returns a 0-100 risk score (higher = riskier) for any ERC-20 on Base, with a derived liquidity view, known-address supply breakdown, our own on-chain sell simulation (buy/sell/transfer tax) and contract flags (owner, proxy, blacklist, pause, selfdestruct, delegatecall). Base only; Polygon/Ethereum analysis is paused (503 before payment, never charged). $0.01 per call via x402 (USDC on Base), or $0.005 for the slim /v1/risk-lite. No charge for…

## Output

A JSON object containing: a 0-100 composite risk score (higher = riskier), a score breakdown by category (liquidity, holder concentration, contract/trading, pool age, news sentiment), token metadata (name, symbol, holder count), liquidity info (total pooled USD across all pools, top pool name and address, pool count), top-5 holder addresses with ownership percentages and type, a set of boolean contract flags (honeypot, proxy, blacklist, pause, selfdestruct, delegatecall, mintable, open_source, anti_whale), buy/sell tax percentages, news sentiment level, liquidity risk level, and a disclaimer.

## 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": [],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC-20 contract address on Base (0x + 40 hex). If omitted, the AERO example is returned with example=true; an invalid address is 400."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "score": 20,
  "token": {
   "name": "Aerodrome",
   "symbol": "AERO"
  },
  "cached": false,
  "address": "0x940181a94a35a4569e4529a3cdfb74e38fd98631",
  "sources": [
   "https://api.dexscreener.com/latest/dex/tokens/… (input for pool discovery and liquidity; only derived values are returned)",
   "Base JSON-RPC (https://mainnet.base.org): …"
  ],
  "liquidity": {
   "band": "$10M-$100M",
   "level": "deep",
   "top_pool": {
    "address": "0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d",
    "share_pct": 53.3
   },
   "derived_from": "dexscreener",
   "pools_counted": 30
  },
  "disclaimer": "Ikke investeringsråd / not investment advice. Automated indicator from public on-chain and DEX data; it can be incomplete or wrong. Do your own research.",
  "contract_flags": {
   "flags": [],
   "owner": {
    "note": "no owner() function",
    "type": null,
    "address": null
   },
   "pause": false,
   "proxy": {
    "value": false
   },
   "mintable": true,
   "blacklist": false,
   "anti_whale": false,
   "paused_now": false,
   "buy_tax_pct": 0,
   "delegatecall": false,
   "selfdestruct": false,
   "sell_blocked": false,
   "sell_tax_pct": null,
   "sell_simulation": {
    "pool": "0x3d5d143381916280ff91407febeb52f2b60f33cf",
    "status": "ok",
    "pool_type": "v3_style",
    "buy_tax_pct": 0,
    "transfer_tax_pct": 0,
    "round_trip_loss_pct": 0.6
   },
   "transfer_tax_pct": 0
  },
  "liquidity_risk": {
   "band": "$10M-$100M",
   "level": "low",
   "pools": 30,
   "reason": "$10M-$100M pooled liquidity across 30 pools, deepest pool 53.3% of it, oldest pool 800 days",
   "oldest_pool_age_days": 800
  },
  "news_sentiment": {
   "level": "no_data",
   "measured": false,
   "sentence": "No news data: no news source is connected, so nothing is inferred (v1 reported this as 'neutral').",
   "legacy_level": "neutral"
  },
  "score_breakdown": {
   "pool_age": 0,
   "liquidity": 5,
   "news_sentiment": 0,
   "contract_trading": 3,
   "holder_concentration": 5
  },
  "holder_concentration": {
   "top5": [
    {
     "pct": 1.9,
     "type": "lp",
     "label": "DEX pool",
     "address": "0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d"
    }
   ],
   "level": "low",
   "reason": "known addresses hold …% of supply: DEX pools …%, burned …%, owner …%, token contract …%, labeled …%",
   "owner_pct": 0,
   "burned_pct": 0,
   "insider_pct": 0,
   "labeled_pct": 1.2,
   "in_pools_pct": 3.1,
   "top5_total_pct": 4.3,
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-risk-score-api-for-base-ad086c89/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from token-risk.restockalarm.workers.dev](https://www.zero.xyz/host/token-risk.restockalarm.workers.dev/llms.txt)
