{"uid":"cap__M2EYmpDRupRAarhiG8tC","slug":"defi-signals-api-defi-yields-endpoint-3e308a6c","name":"DeFi Signals API – DeFi Yields Endpoint","description":"Paid market-data API for AI agents (x402 / USDC on Base): cross-venue perpetual funding rates with an arbitrage spread signal, outlier-cleaned DeFi yields, and a low-cost market snapshot.","url":"https://defi-signals.org/defi/yields","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"chain":{"type":"string","description":"Chain name, e.g. Base, Ethereum, Arbitrum"},"max_apy_pct":{"type":"number","description":"Outlier cap: pools above this APY are excluded (default 300)"},"min_tvl_usd":{"type":"number","description":"Minimum pool TVL in USD (default 1000000)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"Base","pools":[{"stable":true,"symbol":"USDC","apy_pct":5.42,"project":"aave-v3","tvl_usd":182400000,"apy_base_pct":5.42}],"outliers_removed":7}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7c1ZsOX1spnDge8V06JWl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns outlier-cleaned DeFi lending/liquidity pool yields (APY, TVL, project) filtered by chain, minimum TVL, and APY cap, paid per-call via x402/USDC on Base.","exampleAgentPrompt":"Pull me the current DeFi yields on Base — only pools with at least $5 million TVL and exclude anything above 150% APY so the data is clean.","exampleUseCases":[{"title":"Stablecoin yield optimization on Base","prompt":"What are the best stablecoin yields available on Base right now? Only show me pools with at least $2 million TVL and cap APYs at 100% to filter out any sketchy outliers."},{"title":"Cross-protocol yield comparison on Ethereum","prompt":"Pull me the current DeFi lending yields on Ethereum — I want to compare what Aave and other protocols are offering, with a minimum TVL of $10 million so I'm only looking at serious pools."},{"title":"Arbitrum yield scouting for portfolio rebalancing","prompt":"Show me the top DeFi yield opportunities on Arbitrum with at least $1 million TVL and exclude pools with APYs over 200%. I want realistic, clean data to decide where to move funds."}],"resultDescription":"A JSON object containing the queried chain name, a list of pools each with symbol, project, APY percentage, base APY percentage, TVL in USD, and a stability flag, plus a count of how many outlier pools were removed from the dataset before returning results.","failureModes":["Invalid chain name returns empty or error response","Very high min_tvl_usd filters out all pools, returning empty list","Payment failure via x402 if USDC balance on Base is insufficient","Rate limiting or timeout if the upstream DeFi data source is unavailable","max_apy_pct set too low may exclude nearly all pools"],"whenToPreferThis":"Choose this endpoint when you need cleaned, outlier-filtered DeFi yield data across major chains and want to avoid manually scraping or aggregating multiple protocol APIs. Especially useful for agents making yield-optimization decisions or portfolio rebalancing recommendations where garbage APY outliers would skew results. The per-call micropayment model via x402/USDC makes it practical for autonomous agents without subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:38:01.933Z","isFirstParty":false}