{"uid":"cap_cXY8bIKMnsbjZyDTjv5vA","slug":"defi-yield-pool-aggregator-via-defillama-100aee4f","name":"DeFi Yield Pool Aggregator via DefiLlama","description":"Interactive Bitcoin 4-year halving cycle chart on a polar disc. Live price, 200W MA, Mayer Multiple, RSI, MACD, Pi Cycle and optional paid cycle projections.","url":"https://4yearcycle.com/x402/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","required":[],"properties":{"top":{"type":"string","default":"20","pattern":"^\\d{1,3}$","examples":["20","50"],"description":"Maximum number of pools to return. Integer 1-100; values above 100 are capped. Default: 20."},"sort":{"enum":["apy","tvl"],"type":"string","default":"apy","examples":["apy","tvl"],"description":"Ranking order: apy = highest total APY first, tvl = largest TVL first. Default: apy."},"chain":{"type":"string","examples":["Base","Ethereum","Arbitrum"],"description":"Optional chain filter, matched case-insensitively against DefiLlama chain names (Ethereum, Base, Arbitrum, Solana, Polygon, BSC, ...). Empty = all chains."},"minTvlUsd":{"type":"string","default":"10000000","pattern":"^\\d+$","examples":["10000000","1000000"],"description":"Minimum pool TVL in USD; pools below it are dropped. Integer >= 0. Default: 10000000 ($10M)."},"stablecoinOnly":{"enum":["true","false"],"type":"string","default":"false","examples":["true"],"description":"If true, keep only pools DefiLlama classifies as stablecoin pools. Default: false."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["count","generatedAt","pools"],"properties":{"count":{"type":"integer","description":"Number of pools returned (after filtering and top cap)"},"pools":{"type":"array","items":{"type":"object","required":["project","symbol","chain","tvlUsd","apy","poolId"],"properties":{"apy":{"type":"number","description":"Total APY in percent (base + reward)"},"chain":{"type":"string","description":"Chain name as used by DefiLlama, e.g. Ethereum, Base, Arbitrum"},"ilRisk":{"type":"string","description":"Impermanent-loss risk flag from DefiLlama: yes or no"},"poolId":{"type":"string","description":"DefiLlama pool UUID, usable against yields.llama.fi/chart/{poolId}"},"symbol":{"type":"string","description":"Pool token symbol(s), e.g. STETH or USDC-AERO"},"tvlUsd":{"type":"number","description":"Pool TVL in USD"},"apyBase":{"type":["number","null"],"description":"Base (fee/interest) APY in percent, null if not split out"},"project":{"type":"string","description":"DefiLlama project slug, e.g. aave-v3, lido, aerodrome-v1"},"apyReward":{"type":["number","null"],"description":"Reward-token incentive APY in percent, null if none"},"stablecoin":{"type":"boolean","description":"True if DefiLlama classifies the pool as stablecoin-only"}}},"description":"Curated pools in the requested sort order"},"generatedAt":{"type":"integer","description":"Epoch ms when the snapshot was generated"}}}}}}},"responseSchema":{"type":"json","example":{"count":2,"pools":[{"apy":22.23682,"chain":"Base","ilRisk":"yes","poolId":"d32f9c01-47d1-4077-8c73-8b91b08d1e91","symbol":"USDC-AERO","tvlUsd":26728916,"apyBase":null,"project":"aerodrome-v1","apyReward":22.23682,"stablecoin":false},{"apy":16.58258,"chain":"Arbitrum","ilRisk":"yes","poolId":"61b4c35c-97f6-4c05-a5ff-aeb4426adf5b","symbol":"ETH-USDC","tvlUsd":40279708,"apyBase":16.58258,"project":"gmx-v2-perps","apyReward":null,"stablecoin":false}],"generatedAt":1787047200000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WiGL9dgv-LdFjzZI2Dal7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns top DeFi liquidity pool yields ranked by APY or TVL, with optional filtering by chain, minimum TVL, and stablecoin status.","exampleAgentPrompt":"Show me the top 20 DeFi liquidity pools on Base sorted by APY, only include pools with at least $10M TVL.","exampleUseCases":[{"title":"Best stablecoin yields on Ethereum","prompt":"Find me the top 10 stablecoin-only DeFi pools on Ethereum with at least $10M TVL, sorted by highest APY."},{"title":"Cross-chain yield comparison for ETH pools","prompt":"What are the top 50 DeFi pools across all chains sorted by TVL, with a minimum of $1M TVL? I want to compare yields across Arbitrum, Base, and Ethereum."},{"title":"Highest APY farming opportunities on Arbitrum","prompt":"Pull the top 20 highest-APY liquidity pools on Arbitrum with at least $10M TVL so I can find the best yield farming opportunities right now."}],"resultDescription":"Returns a JSON object with a count of matching pools, a timestamp (generatedAt), and an array of pool objects each containing project name, token symbol, chain, TVL in USD, total APY (base + reward split), pool ID, impermanent loss risk flag, and stablecoin classification.","failureModes":["Invalid chain name returns empty pool list or unfiltered results","top value above 100 is silently capped at 100","minTvlUsd with non-integer string may cause validation error","DefiLlama upstream outage returns stale or empty data","Payment not accepted returns HTTP 402"],"whenToPreferThis":"Choose this endpoint when you need ranked, filterable DeFi yield data sourced from DefiLlama with minimal setup — ideal for agents comparing cross-chain APY opportunities, building yield dashboards, or screening pools by TVL and chain without running your own DefiLlama queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:12.796Z","isFirstParty":false}