{"uid":"cap_SpB55pp-ulCsJOn_yW6Pa","slug":"tbs-crypto-defi-api-defi-yield-pools-7e057c02","name":"TBS Crypto & DeFi API – DeFi Yield Pools","description":"Crypto & DeFi data for AI agents in one sub-cent call: real-time token prices, market data (market cap, volume, supply), DeFi TVL by protocol or chain, yield/APY pools, and a flagship bundle combining all of it. DefiLlama + Coinpaprika, keyless, unified schema, USDC-payable via x402 on Base.","url":"https://crypto-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":{"type":"json","example":{"count":1,"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"pools":[{"apy":5.21,"chain":"Ethereum","symbol":"USDC","project":"aave-v3","tvl_usd":452000000,"apy_base":5.02,"stablecoin":true}],"source":"defillama","request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","generated_at":"2026-08-11T12:00:00.000Z"}},"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_TQ5jGJOfgfEz4u7vm35SQ","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":"Fetches live DeFi yield/APY pool data filtered by chain, project, token symbol, TVL, or stablecoin flag, sourced from DefiLlama","exampleAgentPrompt":"Show me the top 10 stablecoin yield pools on Ethereum right now — I want to see APY, TVL, and which protocol they're on, only pools with at least $50M TVL.","exampleUseCases":[{"title":"Find best USDC yield on Ethereum","prompt":"What are the top 5 USDC yield pools on Ethereum right now? Show me the APY and TVL for each — I only want stablecoin pools."},{"title":"Compare Aave v3 yield across assets","prompt":"Pull the current yield pools for Aave v3 and show me the APY and TVL — give me up to 20 results so I can compare options."},{"title":"Discover high-TVL DeFi pools on Arbitrum","prompt":"Find DeFi yield pools on Arbitrum with at least $5 million in TVL, up to 15 results, and tell me the APY and project for each."}],"resultDescription":"Returns a JSON array of yield pools matching the filters, each with APY, base APY, TVL in USD, token symbol, chain, project, and stablecoin flag. Also includes total count, data source (DefiLlama), payer wallet info, a unique request ID, and generation timestamp.","failureModes":["Invalid chain name returns empty pool list or 400 error","Limit outside 1-50 range may cause validation error","No pools matching filters returns empty array with count 0","Payment not processed causes 402 response blocking data return","DefiLlama upstream outage may cause stale or missing data"],"whenToPreferThis":"Choose this endpoint when you need live DeFi yield and APY data across protocols and chains, especially when filtering by specific token, project, chain, or TVL threshold. It is ideal for agents comparing yield farming opportunities or recommending DeFi strategies. Prefer over raw DefiLlama API when you want a unified, keyless, USDC-payable interface with a consistent schema.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:38:12.702Z","isFirstParty":false,"canonicalSlug":"tbs-crypto-defi-api-defi-yield-pools-7e057c02"}