# rug-check

> Rug Pull Detector API for Base: one call returns rug_pull true/false with confidence and 5 honest signals (liquidity removal, wash trading, LP lock, owner wallet, honeypot/tax). Unmeasurable signals are 'unknown' and never counted; named liquidity (pooled_all_pools_usd, top_pool_liquidity_usd). $0.02 per call via x402 (USDC on Base). Not investment advice.

- Base URL: https://rug-check.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 signals: honeypot_tax (measured, or structurally unknown) and liquidity_removal; if only the ~2 h log history is temporarily missing, a measured lp_lock or creator_wallet_activity (owner/holder-based) replaces liquidity_removal. Otherwise 503 + Retry-After, not charged. 503 is only for temporary gaps (a source timed out); a signal that cannot exist for this token (e.g. no DEX pool, no owner(), sources disagree) is reported as unknown in a 200 and never counted. Answers with temporarily missing signals are cached max 30 s.
- 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://rug-check.restockalarm.workers.dev/openapi.json
- Manifest: https://rug-check.restockalarm.workers.dev/.well-known/x402.json

## Endpoints
- GET https://rug-check.restockalarm.workers.dev/v1/rug?address={address} — $0.02 — Rug pull check for an ERC-20 token on Base: rug_pull true/false, confidence, 5 signals (ok/warning/unknown), named liquidity and the decision rule

## Related
- https://token-verdict.restockalarm.workers.dev — One-call verdict: all 4 checks + English conclusion (Base, $0.05)
- https://token-risk.restockalarm.workers.dev — Token risk score (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