{"uid":"cap_Uo4c9-vmLFEmDP13U-izY","slug":"three-ws-defi-market-yields-api-c77eda5b","name":"three.ws DeFi Market Yields API","description":"Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.","url":"https://three.ws/api/x402/market-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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"pool":{"type":"string","description":"Chart mode: a DeFiLlama pool uuid — returns that pool's APY/TVL history instead of the list."},"sort":{"type":"string","description":"'tvl' (default) or 'apy' (dust-guarded to pools ≥ $10k TVL)."},"chain":{"type":"string","description":"Filter to one chain (case-insensitive, e.g. solana)."},"limit":{"type":"string","description":"Rows per page, 1–200. Default 100."},"minTvl":{"type":"string","description":"Minimum pool TVL in USD."},"offset":{"type":"string","description":"Pagination offset. Default 0."},"search":{"type":"string","description":"Substring match over symbol, project, and chain."},"project":{"type":"string","description":"Filter to one protocol slug (e.g. aave-v3)."},"stablecoin":{"type":"string","description":"'true' for stablecoin pools only, 'false' to exclude them."}}}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"pools":[{"apy":2.9,"pool":"747c1d2a-c668-4682-b9f9-296708a3dd90","chain":"Ethereum","symbol":"STETH","project":"lido","tvl_usd":24100000000,"stablecoin":false}],"stats":{"median_apy":4.1},"total":15234}},"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_B_sT387SaR-Hu14Cqk2-d","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live DeFi yield data (APY, TVL) across protocols and chains, sourced from DeFiLlama, with filtering and pagination.","exampleAgentPrompt":"Show me the top 20 stablecoin pools on Ethereum sorted by APY with at least $100k TVL — I want to find the best safe yield right now.","exampleUseCases":[{"title":"Find best stablecoin yield on a chain","prompt":"What are the top 10 stablecoin pools on Arbitrum right now, sorted by APY? Only show pools with at least $50k TVL."},{"title":"Research yields for a specific protocol","prompt":"Pull all the aave-v3 pools and sort them by TVL so I can see where the most liquidity is sitting."},{"title":"Track historical APY for a pool","prompt":"Give me the APY and TVL history for the DeFiLlama pool with ID 747c1d2a-c668-4682-b9f9-296708a3dd90 so I can see how yields have changed over time."}],"resultDescription":"Returns a paginated list of DeFi pools with each pool's APY, TVL in USD, symbol, project slug, chain, pool UUID, and stablecoin flag. Also includes aggregate stats (median APY) and total pool count. When a pool UUID is provided, returns that pool's historical APY/TVL time series instead.","failureModes":["Invalid pool UUID returns empty or error response","Unknown chain or project slug returns empty results","Limit outside 1–200 range may be rejected or clamped","Payment of 0.001 USDC not provided results in 402 Payment Required","Requesting a pool UUID that has been delisted returns no history data"],"whenToPreferThis":"Use this endpoint when an agent needs live DeFi yield and TVL data across multiple protocols and chains, especially when filtering by chain, protocol, stablecoin status, or TVL threshold. Prefer it over generic web search for structured, machine-readable DeFi metrics. Useful for portfolio yield optimization, market research, and alerting workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:58.113Z","isFirstParty":false,"canonicalSlug":"three-ws-defi-market-yields-api-c77eda5b"}