{"uid":"cap_UXGVVNaLc-_3D46R8nMwO","slug":"agent402-defi-yields-lookup-56944005","name":"Agent402 DeFi Yields Lookup","description":"Live yield opportunities across DeFi, filterable by chain, protocol, token symbol, stablecoin-only, minimum TVL and minimum APY: pool identity, TVL in dollars, total APY split into base and reward, 1-day, 7-day and 30-day APY change, impermanent-loss risk and exposure type. Use it to find, compare or monitor where a given asset earns the most right now.","url":"https://agent402.tools/api/defi-yields","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"type":"string","description":"\"tvl\" (default) or \"apy\", descending."},"chain":{"type":"string","description":"Chain name as DefiLlama uses it (Ethereum, Base, Arbitrum, Solana, BSC, Optimism...). Case-insensitive, common aliases accepted. Omit for all chains."},"limit":{"type":"number","description":"Rows to return (default 20, max 100)."},"maxApy":{"type":"number","description":"Maximum total APY in percent (drops headline outliers)."},"minApy":{"type":"number","description":"Minimum total APY in percent."},"symbol":{"type":"string","description":"Token symbol filter, e.g. USDC or WETH-USDC; matches any leg of the pool symbol (case-insensitive)."},"project":{"type":"string","description":"Project slug substring (aave-v3, uniswap-v3, morpho, pendle, curve-dex...). Case-insensitive."},"exposure":{"type":"string","description":"\"single\" or \"multi\" asset exposure."},"minTvlUsd":{"type":"number","description":"Minimum pool TVL in USD (default 10000; pass 0 for no floor)."},"stablecoinOnly":{"type":"boolean","description":"true = only stablecoin pools."},"excludeOutliers":{"type":"boolean","description":"Drop pools DefiLlama flags as APY outliers (default true)."}}},"responseSchema":{"type":"json","example":{"sort":"apy","count":1,"pools":[{"apy":6.1,"pool":"54e9b138-3146-4c1f-8dce-1cb948f5ef96","chain":"Base","ilRisk":"no","symbol":"USDC","tvlUsd":25000000,"apyBase":4.9,"outlier":false,"project":"morpho-v1","apyPct1D":-0.04,"apyPct7D":0.5,"exposure":"single","poolMeta":null,"apyPct30D":-0.05,"apyReward":1.2,"apyMean30d":5.8,"prediction":{"class":"Stable/Up","probability":67},"stablecoin":true,"volumeUsd1d":null,"volumeUsd7d":null,"rewardTokens":[],"underlyingTokens":["0x8335..."]}],"cached":true,"source":"defillama-yields","filters":{"chain":"Base","maxApy":null,"minApy":null,"symbol":null,"project":null,"exposure":null,"minTvlUsd":1000000,"stablecoinOnly":true,"excludeOutliers":true},"matched":42,"fetchedAt":"2026-08-22T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IjhvyIvwpa_R2Ie0CuVMj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches and filters live DeFi yield pool data from DefiLlama, returning pools ranked by TVL or APY with rich metadata including APY trends, TVL, and ML-based stability predictions.","exampleAgentPrompt":"Show me the top 10 stablecoin-only DeFi yield pools on Base sorted by APY, with a minimum APY of 4% and at least $1M TVL — exclude APY outliers.","exampleUseCases":[{"title":"Best stablecoin yields on Base","prompt":"Find me the top 5 stablecoin pools on Base with at least 4% APY, sorted by APY and with TVL above $500K — I want to know which ones DefiLlama flags as stable or improving."},{"title":"Compare Morpho and Aave USDC yields","prompt":"Compare USDC yield pools from morpho-v1 and aave-v3 across all chains, sorted by APY, and show me their 7-day APY trend and stability predictions."},{"title":"High-TVL multi-asset pools on Ethereum","prompt":"Show me the 20 largest multi-asset liquidity pools on Ethereum by TVL, with APY between 2% and 30%, and tell me which ones have a positive 30-day APY trend."}],"resultDescription":"Returns a JSON object with a filtered, sorted list of DeFi yield pools sourced from DefiLlama. Each pool entry includes: pool UUID, chain, project slug, token symbol, total APY (base + reward), TVL in USD, APY changes over 1D/7D/30D periods, IL risk indicator, stablecoin flag, outlier flag, APY mean over 30 days, underlying token addresses, and an ML-based APY prediction (class and probability). Also includes applied filter metadata, total matched count, fetch timestamp, and a cache indicator.","failureModes":["Invalid chain name returns empty results or validation error","APY range conflict (minApy > maxApy) may return zero pools","Extremely restrictive filter combination returns empty pool list","DefiLlama upstream unavailability may cause delayed or stale cached data","Invalid project slug substring returns no matches","Payment of 0.003 USDC required; missing or failed x402 payment returns 402 status"],"whenToPreferThis":"Use this endpoint when you need structured, filterable DeFi yield data sourced from DefiLlama with ML-based APY stability predictions. Prefer this over raw DefiLlama API calls when you need pay-per-call access without API keys, or when building agents that compare yields across chains, protocols, and token types programmatically. It is ideal for yield optimization agents, portfolio rebalancing bots, or DeFi research tools that need ranked pool data with TVL and APY trend context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:56:52.956Z","isFirstParty":false}