Keyless DeFi yields API for AI agents

Lending and LP yields with APY trend, IL risk and TVL — paid per call in USDC on Base, no account or API key.

An agent deciding where to park capital needs more than a headline APY. Every route below returns the yield with the context that tells you whether it is real: the APY split into base and reward, how it moved over 1, 7 and 30 days, impermanent-loss exposure, the pool's TVL, and a stability forecast — so the agent can sort by risk-adjusted return, not just the biggest number. Filter to stablecoin-only pools or a single chain, and read it all 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 /defi/yields$0.001Decision-tagged DeFi lending/LP yields — every pool row carries a per-pool verdict (SUSTAINABLE|DECAYING|OUTLIER|AVOID) + 0-100 risk_score, so you rank by go/no-go not just raw APY (raw yield feeds don't). Plus project, chain, symbol, pool id, 1d/7d/30d APY trend, IL risk (il7d), reward/underlying tokens, outlier flag, mu/sigma, stability forecast, TVL. Filter by project (aave/uniswap/curve or exact slug), chain (eth/arb/op/avax/matic/sol/bnb) or stablecoin; sort by TVL or risk-adjusted APY.free preview
GET /defi/chains-tvl$0.004Top blockchains ranked by total DeFi TVL (DefiLlama): name, TVL USD, gas token. No params. Use when an agent needs a quick map of where DeFi capital sits.—
GET /defi/dex-volume$0.004Top DEXs by 24h trading volume (DefiLlama): name, 24h/7d volume USD, 1d change, plus market total. No params. Use when an agent needs where on-chain swap volume is flowing.—
GET /defi/fees-top$0.003Top DeFi protocols by 24h fees (DefiLlama): name, 24h/7d fees USD, 1d change, plus market total. No params. Use when an agent needs which protocols earn the most.—
GET /defi/hacks-recent$0.004Most recent DeFi/crypto hacks and exploits (DefiLlama): date, name, amount lost USD, chain, technique, bridge-hack flag; ?limit= up to 50. No required params. Use when an agent needs live security-incident risk signals.—
GET /defi/protocol-risk$0.01Protocol risk score from DefiLlama: joins TVL, 1d/7d TVL change, age, audits, chain count and matching hack history into one 0-100 score with flags; ?protocol= accepts a family name (aave, uniswap) that resolves to the highest-TVL version, or an exact slug (default aave-v3). Use when an agent needs a due-diligence check before routing funds to a DeFi protocol.free preview
GET /defi/protocols-top$0.004Top DeFi protocols by TVL (DefiLlama): name, category, TVL USD, 1d/7d change, chain. No params. Use when an agent needs a ranked protocol league table.—
GET /defi/safe-yields$0.01Vetted stablecoin yields: top stablecoin pools (DefiLlama, TVL>$5M, APY 1-25%) joined with each protocol's age and hack history, safest-yield first; optional ?chain= (short names like eth/arb/op/avax/matic/sol resolve to the canonical chain) & ?limit=. No required params. Use when an agent needs where to park stablecoins with due-diligence already applied.free preview
GET /defi/yield-entry-verdict$0.01Per-pool DeFi yield-entry verdict: pass ?pool=<DefiLlama poolId from /defi/yields> and get a packaged SUSTAINABLE|DECAYING|OUTLIER|AVOID go/no-go + 0-100 risk score + field-cited reasons, built from the pool's APY trend (1d/7d/30d), DefiLlama stability forecast, impermanent loss (il7d), volatility (sigma), outlier flag and TVL. Optional ?token=<0x underlying, Base> adds a honeypot-check pointer. Use after /defi/yields finds a high-APY pool to get a go/no-go on THAT pool before funding.—
GET /defi/yield-rotation$0.01Rotate-or-stay DeFi yield decision: pass ?from=<poolId you hold>&to=<poolId you're considering> (both the 'pool' field from /defi/yields) and &notional=<usd> (default 10000) and get a packaged ROTATE|STAY|MARGINAL verdict net of a transparent roundtrip cost (bps) + the risk-score change, with breakeven days, first-year net gain and field-cited reasons. Never rotates into an AVOID/OUTLIER target. The repeat-query sibling to /defi/yield-entry-verdict: re-check an open LP position as APYs drift.—
GET /defi/yields-top$0.004Top DeFi yield pools by TVL (DefiLlama): chain, project, symbol, APY, TVL USD; optional ?chain= (short names like eth/arb/op/avax/matic/sol resolve to the canonical chain) & ?stable=true. Use when an agent needs where to earn yield.—

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/defi/yields?stable=true&limit=20");
const yields = await r.json(); // risk-adjusted stablecoin yields, 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 read yields here instead of scraping

Pulling DefiLlama directly means an agent carries the rate limits, the pool-id bookkeeping and its own risk math. These routes do that work and return a ranked, risk-annotated set in one paid call — including a vetted /defi/safe-yields set that already joins protocol age and hack history, so the agent is not routing funds on APY alone. Yields are informational, not financial advice.