Keyless token-safety API for AI agents — honeypot & rug check per call

Pre-trade honeypot, rug and sellability checks for Base ERC-20s — a SAFE / CAUTION / AVOID verdict in one call, settled in USDC on Base, no account or API key.

A honeypot or a rug costs an agent the whole position, so the check has to run before the buy — and it has to be more than a bytecode grep. Every route below returns a verdict an agent can act on in one call: a live state-override simulation that actually attempts a sell (the only reliable honeypot catch), the buy/sell tax measured against the token's deepest Uniswap-v3 WETH pool, whether ownership is renounced and which admin levers (mint, pause, blacklist, fee-setter, upgradeable proxy) remain, how concentrated supply is in the owner's wallet, and the real pool liquidity in USD. Pass a Base token address and read all of it without an account, a dashboard or a key to rotate. Discover and wire the whole set from one file: the x402 catalog, the OpenAPI spec, or the plain-text catalog.

Routes

RoutePriceWhat it returnsTry free
GET /chain/token-report$0.01Is this Base token safe to buy? One call returns a trade-safety verdict — SAFE | CAUTION | AVOID — with risk_score (0-100) and reasons: honeypot/sellability simulation, owner-renounced + mint/pause/blacklist/fee-setter/upgradeable-proxy checks, measured transfer tax, symbol/name/decimals, and Uniswap v3 WETH-pool liquidity (USD). Replaces many RPC calls and prevents a bad trade before an agent buys a Base ERC-20.free preview
GET /chain/token-security$0.009Is this Base token a scam or rug pull? Honeypot detector for a Base ERC-20: EIP-1967 proxy + upgradeability check, bytecode scan for mint/pause/blacklist/fee-setter/ownership, owner() renouncement, contract source-verification (Sourcify), and a live eth_call state-override sim proving a real wallet can transfer() it. Returns risk_score (0-100) + verdict (clear/review/block) + honeypot/scam/rug flags. Use before an agent buys, holds or approves a token.free preview
GET /gate/swap$0.008Is this Base token safe to swap right now? GO / HOLD / BLOCK pre-trade safety gate for autonomous trading agents: is it a honeypot, can you sell it, and is your trade too big for the pool? Honeypot/sellability + admin-control checks + Uniswap v3 liquidity vs. your notional — one decision + reason in one fast call.free preview

Prices are per successful call in USDC on Base (eip155:8453). Routes with a free preview return the same JSON shape without payment so an agent can evaluate before it pays.

How an agent pays

Point any x402-aware client at a route. The first response carries the price and payment terms; the client pays and retries; the second response is the data. With the x402-fetch wrapper it is one line:

import { wrapFetch } from "x402-fetch";
const fetchPaid = wrapFetch(fetch, { account }); // your agent's Base wallet
const r = await fetchPaid("https://api.greyridgesignals.ai/chain/token-report?token=0x940181a94A35A4569E4529A3CDfB74e38FD98631");
const report = await r.json(); // SAFE / CAUTION / AVOID verdict + risk score, paid inline

No API key is sent or stored. Settlement is a standard USDC transfer the route verifies on-chain before returning data.

Pay on Base, Polygon or Arbitrum

The 402 challenge offers native USDC on 3 networks — Base, Polygon or Arbitrum — so an agent holding USDC on any of them settles without bridging. Each offer in accepts[] carries the matching chain id and USDC contract; Base is listed first. Pick whichever network your wallet already funds.

Prepaid session cap — no per-call signature

For high-frequency polling, open a session once with a single USDC payment up to a cap, then call any paid route with just the returned session token — no EIP-712 signature per call. Each call debits the cap until it runs out. Open a cap at POST /x402/session (tiers $0.05 / $0.50 / $5.00), check the remaining balance any time at the free GET /x402/session/status. This removes the per-call signing round-trip for agents that make many requests in a row.

Why agents check tokens here before they buy

The usual options make an agent carry a key and rate limits (GoPlus), sell crypto-wide data it does not need (1inch), or trust a static honeypot list that misses a token that only taxes the LP pair. These routes are Base-native and verdict-first: /chain/token-report returns SAFE / CAUTION / AVOID with the reasons in one call, /chain/token-security focuses the scam/rug flags, and /gate/swap adds your notional against pool liquidity so an agent sees whether its own trade is too big before it fires. One keyless, pay-per-call rail. Verdicts are informational, not financial advice — a "SAFE" means no known pattern matched these checks, not a guarantee.