RugGuard

Pre-trade rug check API for AI agents — pay-per-call USDC, no API key, no account.

What it does

Before an AI agent buys a token, it should know: is this contract a rug pull? Is the liquidity locked? Can the creator mint at will? Do the top 10 holders concentrate the supply? Has the deployer rugged before? RugGuard answers in under 300 ms via a single HTTP call, settled in USDC on Base via the Coinbase CDP facilitator.

Designed as a systemic pre-trade check — the same call before every purchase. Not a security guarantee. Heuristics are deterministic, explainable, and improving weekly.

Endpoints

EndpointPriceStatus
GET /v1/scan/{chain}/{contract}
quick pre-trade scan, <300ms		 $0.01 Phase 0 (Base only)
GET /v1/scan/deep/{chain}/{contract}
honeypot simulation + deployer profile		 $0.05 Phase 1
POST /v1/watch/{chain}/{contract}
HMAC-signed webhook on critical changes		 $0.005/check Phase 1
GET /v1/explain?scan_id=...
audit trail, per-heuristic evidence		 $0.005 Phase 1

Example

curl https://rugguard.io/v1/scan/base/0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed
{
  "scan_id": "01J9...",
  "score": 32,
  "verdict": "low_risk",
  "flags": [
    {"code": "OWNER_NOT_RENOUNCED", "severity": "high"},
    {"code": "LP_NOT_LOCKED", "severity": "critical"},
    {"code": "MINT_AUTHORITY_ACTIVE", "severity": "critical"}
  ],
  "summary": {
    "top10_concentration_pct": 57.34,
    "buy_tax_pct": 0.0,
    "sell_tax_pct": 0.0,
    "mintable": true,
    "source_verified": true
  }
}

How agents pay

  1. Call the endpoint without payment headers.
  2. Server returns 402 Payment Required with x402 challenge.
  3. Agent settles in USDC via the Coinbase CDP facilitator on Base.
  4. Server verifies and returns the scan + x-payment-response.

No API key. No signup. The wallet that pays is the identity. See the x402 spec.

Resources