{"uid":"cap_5zfk1nR2gnF3zbsQrnU6g","slug":"grey-ridge-signals-pre-trade-token-safety-gate-base-erc-20-ffbac8e6","name":"Grey Ridge Signals — Pre-trade Token Safety Gate (Base ERC-20)","description":"Pre-trade token security GO / HOLD / BLOCK gate for an autonomous Base trading agent: pass token, side (buy|sell) and notional_usd; get a one-word decision plus reason in one fast call. Combines honeypot/sellability simulation, admin-control checks and Uniswap v3 WETH-pool liquidity vs. your trade size (price-impact guard). Use when an autonomous trading agent needs a GO/HOLD/BLOCK check right before a Base swap.","url":"https://x402-data-api.sigrunner.workers.dev/gate/swap?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"side":{"type":"string","description":"buy or sell (optional, default buy)"},"token":{"type":"string","description":"0x-prefixed ERC-20 contract on Base mainnet (only required param)"},"notional_usd":{"type":"string","description":"intended trade size in USD (optional, default 100)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["token","side","notional_usd","decision","reason","verdict","risk_score","liquidity_usd","impact_pct_of_pool","flags","token_meta","analyzed_at","disclaimer","note"],"properties":{"note":{"type":"null"},"side":{"type":"string"},"flags":{"type":"array","items":{"type":"string"}},"token":{"type":"string"},"reason":{"type":"string"},"verdict":{"type":"string"},"decision":{"type":"string"},"disclaimer":{"type":"string"},"risk_score":{"type":"integer"},"token_meta":{"type":"object","required":["symbol","name","decimals"],"properties":{"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer"}}},"analyzed_at":{"type":"string"},"notional_usd":{"type":"integer"},"liquidity_usd":{"type":"integer"},"impact_pct_of_pool":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"note":null,"side":"buy","flags":["no honeypot, deep liquidity, no high-risk admin controls detected"],"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","reason":"token passes safety checks","verdict":"SAFE","decision":"go","disclaimer":"Heuristic risk signal, not financial advice or a guarantee.","risk_score":25,"token_meta":{"name":"USD Coin","symbol":"USDC","decimals":6},"analyzed_at":"2026-10-20T21:45:00.000Z","notional_usd":500,"liquidity_usd":158115578,"impact_pct_of_pool":0.0003}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9hdvNUJYDQBjwlL1wHblA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a GO, HOLD, or BLOCK decision for a proposed ERC-20 token swap on Base mainnet, combining honeypot detection, admin-control checks, and Uniswap v3 price-impact analysis.","exampleAgentPrompt":"Before my agent buys $500 of 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, run a pre-trade safety gate check on it — I want to know if it's a GO, HOLD, or BLOCK and what the risk score and price impact look like.","exampleUseCases":[{"title":"Honeypot check before autonomous buy","prompt":"My trading bot is about to buy $1000 worth of token 0x4200000000000000000000000000000000000006 on Base — screen it first and tell me if it's safe or if I should block the trade."},{"title":"Sell-side rug pull guard","prompt":"Before my agent sells $250 of 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base, check if it's actually sellable or if there are any admin controls that would block the sell."},{"title":"Liquidity and price impact check","prompt":"I want to swap $5000 of 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22 on Base — is the Uniswap v3 pool liquid enough that my trade won't move the price too much? Give me the GO/HOLD/BLOCK decision."}],"resultDescription":"A JSON object containing: decision (one of 'go', 'hold', or 'block'), a human-readable reason string, a risk_score integer (0-100), liquidity_usd (Uniswap v3 WETH-pool liquidity in USD), impact_pct_of_pool (your trade's price impact as a percentage), plus echoed token, side, and notional_usd fields.","failureModes":["Invalid or non-checksummed token address returns an error response","Token not found on Base mainnet yields no liquidity data and likely a BLOCK decision","Non-numeric notional_usd value causes a bad request error","Missing required token param returns a 400-level error","Payment not included or insufficient results in x402 payment required response"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a fast, pre-trade safety gate on any Base ERC-20 before executing a swap — especially when honeypot risk, admin-control lock risk, or Uniswap v3 liquidity depth relative to trade size are concerns. Prefer this over generic token-info endpoints when you need an actionable GO/HOLD/BLOCK verdict rather than raw market data, and when the trade is on Base mainnet specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T16:47:40.836Z","isFirstParty":false,"canonicalSlug":"grey-ridge-signals-pre-trade-token-safety-gate-base-erc-20-ffbac8e6"}