{"uid":"cap_hwsG-LPB9h9UbXjwuV6my","slug":"rugguard-discover-pre-trade-rug-check-discovery-for-crypto-tokens-5a79a125","name":"RugGuard Discover — Pre-trade Rug Check Discovery for Crypto Tokens","description":"Pay-per-call rug check for crypto smart contracts. Built for AI agents on Agentic.market (x402). USDC fractional pricing, no API key.","url":"https://rugguard.redfleet.fr/v1/discover/%7Bchain%7D","method":"GET","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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":{"type":"integer","title":"Score","maximum":100,"minimum":0},"summary":{"type":"object","title":"Summary"},"verdict":{"type":"string","title":"Verdict"},"contract":{"type":"string","title":"Contract"},"sampled_at":{"type":"string","title":"Sampled At","format":"date-time"},"age_minutes":{"type":"integer","title":"Age Minutes","description":"Minutes since the token was first sampled by RugGuard."},"score_confidence":{"type":"string","title":"Score Confidence"}},"description":"One token surfaced by /v1/discover."},"title":"Tokens"},"disclaimer":{"type":"string","title":"Disclaimer","default":"RugGuard is a data analytics tool, not a security guarantee. Best-effort heuristic scoring. See /security.html."}},"description":"Response shape for GET /v1/discover/{chain}.\n\nDeal-flow endpoint for sniper / portfolio agents that want fresh tokens\nwith low risk, not just to score a token they already hold. Pulls from\nthe forward_sampler corpus (tokens RugGuard discovered proactively on\nAerodrome v2 / Raydium V3) and filters by the agent's risk tolerance."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mmohXdZLSPN3naLfJC04D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a filtered list of recently sampled crypto tokens on a given chain, each scored and verdicted for rug-pull risk, ordered by recency.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T12:39:38.191Z","isFirstParty":false}