{"uid":"cap_6ayWl-Pp7LQ11RvyLObVr","slug":"tbs-defi-yields-api-e2a81af6","name":"TBS DeFi Yields API","description":"DeFi yield and APY data for AI agents and yield optimizers. Thousands of liquidity and lending pools across chains and protocols, filterable by chain, project, token symbol, minimum TVL and stablecoin-only, sorted by APY. Each pool returns chain, project, symbol, TVL and APY. Sourced from DefiLlama yields.","url":"https://x402.tbs-digital.com/defi/yields?utm_source=zero.xyz","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 filter, e.g. Ethereum (optional)"},"limit":{"type":"string","description":"Max pools 1-50 (default 20)"},"symbol":{"type":"string","description":"Pool token symbol filter, e.g. USDC (optional)"},"min_tvl":{"type":"string","description":"Minimum pool TVL in USD (optional)"},"project":{"type":"string","description":"Project filter, e.g. aave-v3 (optional)"},"stablecoin":{"type":"string","description":"true|false — stablecoin pools only (optional)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"number"},"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"pools":{"type":"array"},"source":{"type":"string"},"request_id":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lIracB8QMwRDQ_c2mzvf0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns DeFi yield and APY data for liquidity and lending pools across chains and protocols, filterable and sorted by APY, sourced from DefiLlama.","exampleAgentPrompt":"Find me the top 10 stablecoin-only DeFi pools on Ethereum with at least $1 million TVL, sorted by APY — I want to see the chain, project, symbol, TVL, and yield for each.","exampleUseCases":[{"title":"Best stablecoin yields for treasury","prompt":"Show me the top 20 stablecoin-only DeFi pools across all chains with at least $5 million TVL, sorted by APY — I'm looking to park some USDC somewhere safe but high-yielding."},{"title":"Aave yield comparison across chains","prompt":"Pull the top Aave v3 pools across all chains sorted by APY, up to 15 results — I want to see which chain is offering the best rates right now."},{"title":"High-APY Arbitrum pool discovery","prompt":"What are the top 10 liquidity pools on Arbitrum right now, sorted by APY? Show me the symbol, TVL, and current yield for each so I can decide where to allocate."}],"resultDescription":"Returns a JSON object containing a list of DeFi pools (up to the requested limit), each with chain, project, symbol, TVL in USD, and APY percentage, plus metadata including pool count, request ID, source attribution (DefiLlama), and generation timestamp.","failureModes":["Invalid chain name returns empty pool list or error","Limit value outside 1-50 range may return an error or be clamped","Very high min_tvl thresholds may return zero results","Unknown project slug returns empty results","Payment failure via x402 protocol blocks the request","Stale data if DefiLlama upstream is delayed"],"whenToPreferThis":"Choose this endpoint when you need real-time DeFi yield data with flexible filtering by chain, protocol, token, and TVL — especially useful for yield optimizers, DeFi dashboards, or agents comparing APY opportunities. Prefer this over building your own DefiLlama integration when you need a pay-per-call, agent-friendly API with structured output at low cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:49:59.506Z","isFirstParty":false,"canonicalSlug":"tbs-defi-yields-api-e2a81af6"}