{"uid":"cap_jCKCBDfXfDtqGrUF7SIxi","slug":"defi-oracle-yield-rates-api-1eead8ab","name":"DeFi Oracle — Yield Rates API","description":"DeFi data for AI agents — yield rates, swap routes, IL calculator, liquidation risk, MEV scanner, TVL tracking. Powered by DeFiLlama + on-chain RPC data. Pay with USDC on Base via x402.","url":"https://defi-oracle-two.vercel.app/api/yield-rates","method":"POST","headers":{},"bodySchema":{"type":"object","required":["chain"],"properties":{"chain":{"type":"string","description":"Chain name (Ethereum, Base, Arbitrum, etc.)"},"limit":{"type":"number","description":"Max results (default 20)"},"min_tvl":{"type":"number","description":"Minimum TVL filter (default 100000)"}}},"responseSchema":{"type":"object","properties":{"count":{"type":"number"},"pools":{"type":"array","items":{"type":"object","properties":{"apy":{"type":"number"},"pool":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"il_risk":{"type":"string"},"project":{"type":"string"},"tvl_usd":{"type":"number"},"apy_base":{"type":"number"},"apy_reward":{"type":"number"},"stablecoin":{"type":"boolean"}}}},"filters":{"type":"object"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iOW8iJWZ7fHPb6ElmkQyx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns DeFi liquidity pool yield rates (APY, TVL, IL risk) for a given blockchain chain, powered by DeFiLlama and on-chain RPC data","exampleAgentPrompt":"What are the top 20 DeFi yield pools on Arbitrum right now with at least $500k TVL — show me each pool's APY and impermanent loss risk?","exampleUseCases":null,"resultDescription":"A JSON object containing a count of matching pools and an array of pool objects, each with APY (total, base, and reward components), TVL in USD, chain name, pool symbol, project name, stablecoin flag, and impermanent loss risk rating. Also includes a filters summary reflecting the query parameters used.","failureModes":["Missing required 'chain' parameter returns a 400 validation error","Unsupported or misspelled chain name may return empty results or error","Payment failure via x402/USDC on Base causes 402 Payment Required response","DeFiLlama upstream outage may cause 502 or empty data","Very restrictive min_tvl filter may return zero pools"],"whenToPreferThis":"Use this endpoint when you need structured, per-pool yield rate data for a specific blockchain, including APY breakdown and risk metadata. Prefer this over generic DeFi aggregators when you need IL risk flags, stablecoin classification, and project attribution in a single call, and when the user is asking about yield opportunities on Ethereum, Base, or Arbitrum specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:39:04.091Z","isFirstParty":false}