# token-verdict

> Token Verdict API for Base: one call runs token risk, rug-pull, holder and momentum checks plus contract flags (proxy, blacklist, pause, selfdestruct) and returns one verdict (avoid / high_risk / caution / low_risk) with a one-line English summary; top holders carry known labels (exchanges, bridges, lockers) that are excluded from concentration. $0.05 per call via x402 (USDC on Base or Polygon). Not investment advice.

- Base URL: https://token-verdict.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, 10 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: token-risk and rug-check must answer. holder-check and momentum-score are optional (no holder index / no market data → that part is null with a note). If any part still has a temporary gap (503 upstream) after up to 2 internal retries (short backoff), the verdict answers 503 + Retry-After 5 and nothing is charged (x402 is not settled, API-key credits are refunded).
- 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-verdict.restockalarm.workers.dev/openapi.json
- Manifest: https://token-verdict.restockalarm.workers.dev/.well-known/x402.json

## Endpoints
- GET https://token-verdict.restockalarm.workers.dev/v1/verdict?address={address} — $0.05 — One-call verdict for an ERC-20 token on Base: risk + rug-pull + holders + momentum + contract flags, verdict avoid/high_risk/caution/low_risk and a one-line English summary

## Related
- https://token-risk.restockalarm.workers.dev — Token risk score (Base)
- 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