{"openapi":"3.1.0","info":{"title":"TokenGuard Base","version":"1.0.0","contact":{"name":"TokenGuard Base","url":"https://github.com/Imac2014Ville/baselens"},"description":"Honeypot check, rug pull check and scam token detector for Base tokens (is this token safe?), plus new token launches pre-screened for honeypots (sniper safety). No API key: pay USDC on Base per call via x402.","x-guidance":"Pay-per-call USDC on Base via x402. POST /token-risk {token} ($0.02): honeypot check / rug pull check - is this Base token safe? Simulated sell, owner powers, liquidity, LP burn, verdict LOW_RISK/CAUTION/HIGH_RISK/AVOID and risk score 0-100. POST /launch-scan {minutes, quote, limit<=10} ($0.03): new token launches pre-screened for honeypots, each pool annotated with verdict, riskScore and flags (sniper safety; takes up to ~20s). POST /new-pools {minutes, quote} ($0.01): raw feed of new Base pools. GET with query params also works. Malformed input returns 400 and failed lookups return non-2xx, so you are not charged."},"servers":[{"url":"https://tokenguard.imac2014ville.workers.dev"}],"paths":{"/launch-scan":{"get":{"operationId":"launchScanGet","summary":"New token launches on Base pre-screened for honeypots","description":"New token launches pre-screened for honeypots on Base: sniper safety in one call. Lists the newest pools (Uniswap v2/v3/v4, Aerodrome) and runs a honeypot check and rug pull check on each token; every pool comes back with verdict (LOW_RISK/CAUTION/HIGH_RISK/AVOID), risk score and flags. Max 10 tokens per call.","tags":["new-tokens","honeypot","sniper-safety","token-safety","base"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"count":5,"screenedCount":5,"pools":[{"dex":"uniswap-v4","token":{"symbol":"XYZ"},"ageMinutes":3,"liquidityUsd":12000,"screened":true,"verdict":"AVOID","riskScore":75,"riskFlags":[{"severity":"critical","issue":"Simulated transfer into the main pool REVERTS: likely honeypot / sells blocked"}]}]}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"minutes","in":"query","required":false,"schema":{"type":"number","description":"Look-back window, 1-120 (default 30)"},"description":"Look-back window, 1-120 (default 30)"},{"name":"quote","in":"query","required":false,"schema":{"type":"string","enum":["any","weth","usdc"],"description":"Quote token filter (default any; launch-scan default weth)"},"description":"Quote token filter (default any; launch-scan default weth)"},{"name":"limit","in":"query","required":false,"schema":{"type":"number","description":"Max pools to screen, 1-10 (default 5)"},"description":"Max pools to screen, 1-10 (default 5)"}]},"post":{"operationId":"launchScanPost","summary":"New token launches on Base pre-screened for honeypots","description":"New token launches pre-screened for honeypots on Base: sniper safety in one call. Lists the newest pools (Uniswap v2/v3/v4, Aerodrome) and runs a honeypot check and rug pull check on each token; every pool comes back with verdict (LOW_RISK/CAUTION/HIGH_RISK/AVOID), risk score and flags. Max 10 tokens per call.","tags":["new-tokens","honeypot","sniper-safety","token-safety","base"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"count":5,"screenedCount":5,"pools":[{"dex":"uniswap-v4","token":{"symbol":"XYZ"},"ageMinutes":3,"liquidityUsd":12000,"screened":true,"verdict":"AVOID","riskScore":75,"riskFlags":[{"severity":"critical","issue":"Simulated transfer into the main pool REVERTS: likely honeypot / sells blocked"}]}]}}}},"402":{"description":"Payment Required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"minutes":{"type":"number","description":"Look-back window, 1-120 (default 30)"},"quote":{"type":"string","enum":["any","weth","usdc"],"description":"Quote token filter (default any; launch-scan default weth)"},"limit":{"type":"number","description":"Max pools to screen, 1-10 (default 5)"}}}}}}}},"/token-risk":{"get":{"operationId":"tokenRiskGet","summary":"Honeypot check / rug pull check: is this Base token safe?","description":"Honeypot check and rug pull check for any Base token: is this token safe to buy? Scam token detector: simulates a sell, checks owner powers (mint, blacklist, pause, fees, proxy), renounced ownership, liquidity, LP burn. Returns LOW_RISK/CAUTION/HIGH_RISK/AVOID, risk score 0-100.","tags":["honeypot","rug-check","token-safety","scam-token","base"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"symbol":"AERO","verdict":"LOW_RISK","riskScore":0,"flags":[],"liquidityUsd":48832868,"priceUsd":0.8378,"sellSimulation":{"simulated":true,"sellToPoolSucceeds":true}}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","description":"ERC-20 contract address on Base"},"description":"ERC-20 contract address on Base"}]},"post":{"operationId":"tokenRiskPost","summary":"Honeypot check / rug pull check: is this Base token safe?","description":"Honeypot check and rug pull check for any Base token: is this token safe to buy? Scam token detector: simulates a sell, checks owner powers (mint, blacklist, pause, fees, proxy), renounced ownership, liquidity, LP burn. Returns LOW_RISK/CAUTION/HIGH_RISK/AVOID, risk score 0-100.","tags":["honeypot","rug-check","token-safety","scam-token","base"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"symbol":"AERO","verdict":"LOW_RISK","riskScore":0,"flags":[],"liquidityUsd":48832868,"priceUsd":0.8378,"sellSimulation":{"simulated":true,"sellToPoolSucceeds":true}}}}},"402":{"description":"Payment Required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","description":"ERC-20 contract address on Base"}},"required":["token"]}}}}}},"/new-pools":{"get":{"operationId":"newPoolsGet","summary":"New token launches on Base (sniper feed)","description":"New token launches on Base in the last N minutes (Uniswap v2/v3/v4, Aerodrome): token, quote, initial price, liquidity, hooks, flags. Sniper feed; use /launch-scan for launches pre-screened for honeypots, or /token-risk on each token before buying.","tags":["new-tokens","sniper","dex","base","trading"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"count":25,"pools":[{"dex":"uniswap-v4","token":{"symbol":"XYZ"},"quote":"WETH","ageMinutes":3,"priceUsd":0.00012,"flags":["custom-hooks"]}]}}}},"402":{"description":"Payment Required"}},"parameters":[{"name":"minutes","in":"query","required":false,"schema":{"type":"number","description":"Look-back window, 1-120 (default 30)"},"description":"Look-back window, 1-120 (default 30)"},{"name":"quote","in":"query","required":false,"schema":{"type":"string","enum":["any","weth","usdc"],"description":"Quote token filter (default any; launch-scan default weth)"},"description":"Quote token filter (default any; launch-scan default weth)"},{"name":"minLiquidityUsd","in":"query","required":false,"schema":{"type":"number","description":"Minimum USD liquidity (excludes v4 pools, whose liquidity is not measured)"},"description":"Minimum USD liquidity (excludes v4 pools, whose liquidity is not measured)"},{"name":"limit","in":"query","required":false,"schema":{"type":"number","description":"Max pools, 1-100 (default 25)"},"description":"Max pools, 1-100 (default 25)"}]},"post":{"operationId":"newPoolsPost","summary":"New token launches on Base (sniper feed)","description":"New token launches on Base in the last N minutes (Uniswap v2/v3/v4, Aerodrome): token, quote, initial price, liquidity, hooks, flags. Sniper feed; use /launch-scan for launches pre-screened for honeypots, or /token-risk on each token before buying.","tags":["new-tokens","sniper","dex","base","trading"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"count":25,"pools":[{"dex":"uniswap-v4","token":{"symbol":"XYZ"},"quote":"WETH","ageMinutes":3,"priceUsd":0.00012,"flags":["custom-hooks"]}]}}}},"402":{"description":"Payment Required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"minutes":{"type":"number","description":"Look-back window, 1-120 (default 30)"},"quote":{"type":"string","enum":["any","weth","usdc"],"description":"Quote token filter (default any; launch-scan default weth)"},"minLiquidityUsd":{"type":"number","description":"Minimum USD liquidity (excludes v4 pools, whose liquidity is not measured)"},"limit":{"type":"number","description":"Max pools, 1-100 (default 25)"}}}}}}}}},"x-discovery":{"ownershipProofs":["0x95b0c6525e891bd434f731e84c3ba6adfec215373ebf68c8cbc9ce5915f31ca8292015b6cb4217b21a0e7d7923e5128be6b282e866c6053045af7d4881c6069f1b"]}}