# RugGuard Wallet Rug Check API

> RugGuard Wallet Rug Check API is a paid API for AI agents from rugguard.redfleet.fr, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-10).

Looks up a wallet address's on-chain deployment history and returns rug-pull risk stats including rug rate, rugged contract count, and per-contract risk verdicts across chains.

## Facts

- Endpoint: GET https://rugguard.redfleet.fr/v1/wallet/%7Baddress%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rugguard-wallet-rug-check-api-c25d07e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OTGpRc9bGlFIqfF1VER7V

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 rugguard-wallet-rug-check-api-c25d07e3
```

Example prompt: Before I buy into this new token launch, can you run a rug check on the deployer wallet 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed and tell me their rug rate and how many of their past contracts got flagged as high risk?

## When to prefer this

Use this endpoint when an AI agent needs to evaluate the historical trustworthiness of a token deployer wallet before a trade or investment decision. Prefer it over generic block explorer lookups when you need a pre-computed rug rate and structured risk verdicts rather than raw transaction data. Best suited for pre-trade due diligence on new token launches where the deployer's past behavior is a key signal.

## Known failure modes

- Invalid or malformed wallet address returns a 400 error
- Wallet with no on-chain deployments returns empty deployed_contracts array with zero stats
- Payment not fulfilled via x402 returns 402 Payment Required
- Chain indexing lag may cause recently deployed contracts to appear absent
- Address not found on any queried chain returns empty result with no error

## How this service works

Pay-per-call rug check for crypto smart contracts. Built for AI agents on Agentic.market (x402). USDC fractional pricing, no API key.

## Output

Returns a JSON object with the queried wallet address, a list of all deployed contracts with per-contract chain, risk score (0-100), verdict (low_risk/high_risk), status (ok/rugged/pending), and first-seen timestamp, plus aggregate stats: total_deployed, rugged_count, ok_count, pending_count, and rug_rate. Also includes chains queried, scan timestamp, and a disclaimer.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "WalletResponse",
 "examples": [
  {
   "value": {
    "stats": {
     "ok_count": 1,
     "rug_rate": 0.5,
     "rugged_count": 1,
     "pending_count": 0,
     "total_deployed": 2
    },
    "address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
    "disclaimer": "RugGuard is a data analytics tool, not a security guarantee. Best-effort heuristic scoring. See /security.html.",
    "scanned_at": "2026-04-28T12:00:00Z",
    "chains_queried": [
     "base",
     "solana"
    ],
    "deployed_contracts": [
     {
      "chain": "base",
      "contract": "0xaaa...",
      "latest_score": 87,
      "first_seen_at": "2026-04-28T12:00:00Z",
      "sample_status": "rugged",
      "latest_verdict": "high_risk",
      "latest_scanned_at": "2026-04-28T12:00:00Z"
     },
     {
      "chain": "base",
      "contract": "0xbbb...",
      "latest_score": 22,
      "first_seen_at": "2026-04-28T12:00:00Z",
      "sample_status": "ok",
      "latest_verdict": "low_risk",
      "latest_scanned_at": "2026-04-28T12:00:00Z"
     }
    ]
   },
   "summary": "wallet with 2 deployed contracts, 1 rugged",
   "description": "An agent looking up a wallet that's about to launch a new token gets back its prior deployment history. One of two previous deploys ended up rugged → 50% rug rate, agent should treat the new deploy as critical-risk-by-priors."
  }
 ],
 "required": [
  "address",
  "chains_queried",
  "deployed_contracts",
  "stats",
  "scanned_at"
 ],
 "properties": {
  "stats": {
   "type": "object",
   "title": "Stats",
   "description": "Aggregate counts: total_deployed, rugged_count, ok_count, pending_count, rug_rate (= rugged_count / total_deployed)."
  },
  "address": {
   "type": "string",
   "title": "Address"
  },
  "disclaimer": {
   "type": "string",
   "title": "Disclaimer",
   "default": "RugGuard is a data analytics tool, not a security guarantee. Best-effort heuristic scoring. See /security.html."
  },
  "scanned_at": {
   "type": "string",
   "title": "Scanned At",
   "format": "date-time"
  },
  "chains_queried": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Chains Queried"
  },
  "deployed_contracts": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "WalletDeployedContract",
    "required": [
     "chain",
     "contract",
     "first_seen_at"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "title": "Chain"
     },
     "contract": {
      "type": "stri
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rugguard-wallet-rug-check-api-c25d07e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rugguard.redfleet.fr](https://www.zero.xyz/host/rugguard.redfleet.fr/llms.txt)