# RugGuard Discover — Pre-trade Rug Check Discovery for Crypto Tokens

> RugGuard Discover — Pre-trade Rug Check Discovery for Crypto Tokens is a paid API for AI agents from rugguard.redfleet.fr, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-10).

Returns a filtered list of recently sampled crypto tokens on a given chain, each scored and verdicted for rug-pull risk, ordered by recency.

## Facts

- Endpoint: GET https://rugguard.redfleet.fr/v1/discover/%7Bchain%7D
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rugguard-discover-pre-trade-rug-check-discovery-for-crypto-tokens-5a79a125
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hwsG-LPB9h9UbXjwuV6my

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-discover-pre-trade-rug-check-discovery-for-crypto-tokens-5a79a125
```

Example prompt: Show me up to 10 freshly sampled tokens on Base from the last 60 minutes that are rated safe or low_risk, with at least $5,000 in liquidity.

## When to prefer this

Use this endpoint when an AI agent needs to proactively discover recently vetted, low-risk crypto tokens on a specific chain before executing a trade or investment, especially when no specific contract address is known yet. Prefer this over single-contract check endpoints when building token screening pipelines, automated trading bots, or opportunity scanners that need a filtered batch of pre-scored tokens with liquidity and flag metadata.

## Known failure modes

- Invalid chain slug in path returns 404 or error
- limit > 50 is rejected with a validation error
- Invalid verdict value in comma-separated list returns 400
- max_age_minutes outside 1-10080 range returns validation error
- No tokens match the filters — returns empty tokens array with count 0
- Payment not provided or insufficient USDC causes 402 Payment Required
- Service unavailable or backend timeout returns 5xx

## 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

A JSON object containing the chain name, applied filters, count of tokens returned, and an array of token objects each with contract address, rug risk score (0-100), verdict (safe/low_risk/medium_risk/high_risk/critical/uncertain), list of risk flags with severity, optional summary fields (LP lock status, liquidity USD, source verified, top-10 holder concentration), sample timestamp, age in minutes, and score confidence level. Also includes a disclaimer about heuristic nature of the scoring.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max rows (≤ 50)."
  },
  "verdicts": {
   "type": "string",
   "description": "Comma-separated verdict allowlist. Default 'safe,low_risk'. Valid: safe, low_risk, medium_risk, high_risk, critical, uncertain."
  },
  "max_age_minutes": {
   "type": "integer",
   "description": "Cap on how old a sample can be (1 to 10080 minutes = 1 week)."
  },
  "min_liquidity_usd": {
   "type": "string",
   "description": "Filter rows whose recorded LP_INSUFFICIENT_LIQUIDITY evidence had `total_liquidity_usd >= this`. Rows without that evidence are excluded."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "DiscoverResponse",
 "examples": [
  {
   "value": {
    "chain": "base",
    "count": 1,
    "filter": {
     "verdicts": [
      "safe",
      "low_risk"
     ],
     "max_age_minutes": 60,
     "min_liquidity_usd": 5000
    },
    "tokens": [
     {
      "chain": "base",
      "flags": [],
      "score": 18,
      "summary": {
       "lp_locked": true,
       "liquidity_usd": 18420,
       "source_verified": true,
       "top10_concentration_pct": 22.4
      },
      "verdict": "safe",
      "contract": "0xabc...",
      "sampled_at": "2026-04-28T12:00:00Z",
      "age_minutes": 12,
      "score_confidence": "medium"
     }
    ],
    "disclaimer": "RugGuard is a data analytics tool, not a security guarantee. Best-effort heuristic scoring. See /security.html."
   },
   "summary": "fresh low-risk Base tokens from the last 60 minutes",
   "description": "An agent asks for the 10 freshest Base tokens with verdict in {safe, low_risk}, sampled in the last 60 minutes, with at least $5k in liquidity. RugGuard returns the matching slice of its forward-sampler corpus, ordered by sampled_at DESC."
  }
 ],
 "required": [
  "chain",
  "filter",
  "tokens",
  "count"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "title": "Chain"
  },
  "count": {
   "type": "integer",
   "title": "Count",
   "description": "Number of tokens returned (≤ requested limit)."
  },
  "filter": {
   "type": "object",
   "title": "Filter",
   "description": "Echo of the filter that produced this slice — useful for caching keys."
  },
  "tokens": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "DiscoveredToken",
    "required": [
     "chain",
     "contract",
     "score",
     "verdict",
     "score_confidence",
     "sampled_at",
     "age_minutes",
     "flags"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "title": "Chain"
     },
     "flags": {
      "type": "array",
      "items": {
       "type": "object",
       "title": "FlagOut",
       "required": [
        "code",
        "severity"
       ],
       "properties": {
        "code": {
         "type": "string",
         "title": "Code",
         "description": "Stable flag identifier, e.g. OWNER_NOT_RENOUNCED."
        },
        "severity": {
         "type": "string",
         "title": "Severity",
         "description": "One of low | medium | high | critical."
        }
       }
      },
      "title": "Flags"
     },
     "score": {
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rugguard-discover-pre-trade-rug-check-discovery-for-crypto-tokens-5a79a125/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)