# token-risk

> Token Risk Score API for Base: one call returns a 0-100 risk score (higher = riskier) for any ERC-20 on Base, with named liquidity, top-5 holder concentration, honeypot/tax and contract flags (proxy, blacklist, pause, selfdestruct, delegatecall). $0.02 per call via x402 (USDC on Base). Not investment advice.

- Base URL: https://token-risk.restockalarm.workers.dev
- Pay per call via x402: USDC on Base (eip155:8453) or Polygon PoS (eip155:137), payTo 0x7B97303d62517eA9E26D1E1b199Eac42a487F430
- Free demo: 5 calls/day per IP under /demo/...
- Card alternative: X-API-Key header, 4 credits per call. Credit packs (all APIs): 250 calls $1.25 https://space-command-kits-shop.fourthwall.com/products/api-credits-250-calls | 1000 calls $5 https://space-command-kits-shop.fourthwall.com/products/api-credits-1000-calls | 5000 calls $15 https://space-command-kits-shop.fourthwall.com/products/api-credits-5000-calls; claim key https://api-keys.restockalarm.workers.dev/claim
- No address: GET without address answers for the AERO example (0x940181a94A35A4569E4529A3CDfB74e38FD98631) with example=true and a note; an invalid address is still 400
- Errors: 400 bad input, 404 no contract, 422 no data, 503 + Retry-After = a core field could not be measured right now (not charged: x402 not settled, API-key credits refunded)
- Core fields: liquidity_risk (a liquidity source answered) and holder_concentration with every top-5 holder typed (burn/lp/contract/wallet). If either cannot be measured the API answers 503 + Retry-After and nothing is charged.
- Output (API v2.0.0): enum values are canonical English (low/medium/high, ok/warning/unknown, no_data …); ?lang=da returns the previous Danish values. *_en mirror fields are deprecated (removal in v3).
- OpenAPI: https://token-risk.restockalarm.workers.dev/openapi.json
- Manifest: https://token-risk.restockalarm.workers.dev/.well-known/x402.json

## Endpoints
- GET https://token-risk.restockalarm.workers.dev/v1/risk?address={address} — $0.02 — Risk score 0-100 for an ERC-20 token on Base: named liquidity, top-5 holder concentration, honeypot/tax and contract flags, news sentiment

## Related
- https://token-verdict.restockalarm.workers.dev — One-call verdict: all 4 checks + English conclusion (Base, $0.05)
- https://rug-check.restockalarm.workers.dev — Rug-pull detector (Base)
- https://holder-check.restockalarm.workers.dev — Holder analysis (Base)
- https://momentum-score.restockalarm.workers.dev — Momentum score (Base)
- Token Safety suite: https://product-katalog.restockalarm.workers.dev/token-safety
- MCP server (same tools incl. token_verdict; x402 $0.02, verdict $0.05): https://token-safety-mcp.restockalarm.workers.dev/mcp
- Catalog: https://product-katalog.restockalarm.workers.dev/llms.txt