{"uid":"cap_MSnGZ7P7CsYETbXE4Cd6X","slug":"defi-yield-apy-pool-lookup-21a107aa","name":"DeFi Yield & APY Pool Lookup","description":"DeFi yield and APY across pools. Returns the top yield-farming pools via DefiLlama with current APY, base and reward APY split, TVL, chain, and project, filterable by chain, project, symbol, stablecoin-only, minimum TVL, and minimum APY. For yield discovery and comparing APY across protocols. Keyless.","url":"https://api.kadec0.xyz/v1/yield-pools","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"chain":{"type":"string","description":"e.g. Ethereum|Arbitrum|Solana"},"minApy":{"type":"string","default":"0"},"minTvl":{"type":"string","default":"1000000"},"symbol":{"type":"string","description":"pool symbol substring, e.g. USDC|ETH"},"project":{"type":"string","description":"e.g. aave-v3|lido|uniswap-v3"},"maxItems":{"type":"string","default":"25"},"stablecoin":{"type":"string","description":"true -> stablecoin pools only"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5w7McdC3yDlGcdKqq2ulD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches top yield-farming pools with APY, TVL, chain, project, and asset data from DefiLlama, filterable by chain, project, symbol, and stablecoin status.","exampleAgentPrompt":"Show me the top 20 stablecoin yield pools on Ethereum with at least 5% APY and at least $5 million TVL — I want to see which DeFi projects are offering the best returns right now.","exampleUseCases":null,"resultDescription":"A list of yield-farming pools (up to maxItems, default 25) each containing APY percentage, TVL in USD, blockchain chain, project name (e.g. aave-v3), and asset/pool symbol — sourced from DefiLlama and filterable by chain, stablecoin type, minimum APY, minimum TVL, symbol substring, and project name.","failureModes":["Invalid chain name returns empty results or 400 error","minApy or minTvl filters too restrictive return empty pool list","Unknown project slug returns no results","Rate limiting or payment failure returns 402 if USDC payment not attached","Upstream DefiLlama API outage may cause 503 or stale data"],"whenToPreferThis":"Use this endpoint when you need live DeFi yield pool data aggregated across chains and protocols, especially when filtering for stablecoin-only pools or comparing APY/TVL across projects like Aave, Lido, or Uniswap. Prefer this over manual DefiLlama queries when you need structured, filterable JSON output for agent workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:39.419Z","isFirstParty":false}