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.
| Route | Price | What it returns | Try free |
|---|---|---|---|
GET /defi/yields | $0.001 | Decision-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.004 | Top 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.004 | Top 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.003 | Top 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.004 | Most 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.01 | Protocol 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.004 | Top 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.01 | Vetted 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.01 | Per-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.01 | Rotate-or-stay DeFi yield decision: pass ?from=<poolId you hold>&to=<poolId you're considering> (both the 'pool' field from /defi/yields) and ¬ional=<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.004 | Top 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.
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.
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.
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.
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.