{"uid":"cap_o8uFSYSqf-i1G95fYVhod","slug":"aiworker-data-defi-yields-c1849235","name":"aiworker-data DeFi Yields","description":"Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1","url":"https://aiworker.duckdns.org/v1/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, solana"},"limit":{"type":"integer","default":50,"maximum":200,"minimum":1},"symbol":{"type":"string"},"project":{"type":"string","description":"DefiLlama project slug, e.g. aave-v3"},"stablecoin":{"type":"boolean"},"min_tvl_usd":{"type":"number"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"pools":{"type":"array","items":{"type":"object","properties":{"apy":{"type":["number","null"]},"chain":{"type":"string"},"symbol":{"type":"string"},"il_risk":{"type":["string","null"]},"pool_id":{"type":"string"},"project":{"type":"string"},"tvl_usd":{"type":"number"},"apy_base":{"type":["number","null"]},"exposure":{"type":["string","null"]},"apy_reward":{"type":["number","null"]},"source_url":{"type":"string"},"stablecoin":{"type":"boolean"},"updated_at":{"type":"string"},"underlying_tokens":{"type":"array","items":{"type":"string"}}}}},"stale":{"type":"boolean"},"source":{"type":"string"},"fetched_at":{"type":"string"},"source_url":{"type":"string"},"attribution":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"pools":[{"apy":2.3,"chain":"base","symbol":"WETH","pool_id":"…","project":"morpho-blue","tvl_usd":45000000}],"stale":false,"source":"DefiLlama"}},"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_2X6ig9LZn2hFsZKEkMvtZ","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":"Fetches filtered DeFi yield pool data (APY, TVL, chain, project) from DefiLlama via a pay-per-call API","exampleAgentPrompt":"What are the top 20 stablecoin yield pools on Base right now, filtered to those with at least $5 million TVL? I want to see APY and project details.","exampleUseCases":[{"title":"Best stablecoin yields on Base","prompt":"Find me the top stablecoin pools on Base with at least $2 million TVL — show me APY, project name, and symbol so I can decide where to park my USDC."},{"title":"Comparing Aave v3 pool yields","prompt":"Pull up all Aave v3 yield pools across any chain and show me their APY and TVL so I can compare where Aave is paying the most right now."},{"title":"High-APY ETH pools for yield farming","prompt":"What are the top 10 WETH yield pools by APY across all chains? I want TVL and base APY so I can evaluate the best farming opportunities."}],"resultDescription":"Returns a JSON object with a list of matching yield pools, each containing pool ID, chain, symbol, project, APY (total, base, reward), TVL in USD, stablecoin flag, IL risk, underlying tokens, source URL, and timestamp. Also includes total count, data freshness flag, and attribution to DefiLlama.","failureModes":["Invalid chain name returns empty pool list or error","Project slug not matching any DefiLlama entry returns zero results","Limit parameter out of range (< 1 or > 200) may return validation error","Stale data flag set to true if DefiLlama upstream is delayed","Network or DNS issues with duckdns.org host causing service unavailability","Payment failure (x402) if USDC balance insufficient"],"whenToPreferThis":"Use this endpoint when an AI agent needs reliable, structured DeFi yield data filtered by chain, project, symbol, or TVL — especially for Base, Ethereum, or Solana pools. Prefer this over scraping DefiLlama directly as it provides clean structured JSON at low per-call cost ($0.02) with no rate-limit management required. Best when you need machine-readable yield data for comparison, ranking, or monitoring workflows rather than human-readable summaries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:30:02.715Z","isFirstParty":false}