{"uid":"cap_DK9ePQyjZFzl3fx68ztvq","slug":"defi-oracle-yield-rates-4eae32b4","name":"DeFi Oracle Yield Rates","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://oraclius.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_WlHOeIPXq457F4rzDpfAt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches DeFi yield rates, APY data, and pool information for a given blockchain chain, filtered by TVL and result count","exampleAgentPrompt":"Show me the top 10 yield farming pools on Arbitrum with at least $500,000 TVL — I want to see APY, impermanent loss risk, and whether each pool is stablecoin-based.","exampleUseCases":null,"resultDescription":"Returns a list of DeFi liquidity pools for the specified chain, each with APY (total, base, and reward components), TVL in USD, project name, pool identifier, token symbol, impermanent loss risk rating, stablecoin flag, and the chain name. Also includes a count of results and the applied filters.","failureModes":["Missing required 'chain' parameter returns a validation error","Unsupported or misspelled chain name may return empty results or an error","Very high min_tvl filter may return zero pools","Rate limiting or upstream DeFiLlama API unavailability may cause failures","Payment failure via x402/USDC on Base will block the request"],"whenToPreferThis":"Use this endpoint when an agent needs current DeFi yield data for a specific blockchain, especially when filtering by TVL is important. Prefer this over generic DeFi APIs when the agent needs structured APY breakdowns (base vs reward), IL risk signals, and stablecoin flags in a single call. Best for yield comparison, portfolio optimization, or DeFi research tasks on Ethereum, Base, or Arbitrum.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:42:02.645Z","isFirstParty":false}