{"uid":"cap_hi0oh2BMt_sLK3zosG9aW","slug":"three-ws-yield-scan-defi-pool-rankings-api-2007e6d8","name":"three.ws Yield Scan — DeFi Pool Rankings 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/yield-scan?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","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"sort":{"enum":["apy","tvl"],"type":"string","default":"apy","description":"Ranking dimension."},"chain":{"type":"string","description":"Filter to one chain, e.g. Ethereum, Solana, Base (case-insensitive)."},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1,"description":"Pools to return."},"stable":{"type":"boolean","description":"true → stablecoin-denominated pools only."},"minTvlUsd":{"type":"number","default":100000,"minimum":0,"description":"Minimum pool TVL in USD."}}}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"ts":"2026-07-11T10:00:00Z","count":10,"pools":[{"apy":9.42,"pool":"747c1d2a-c668-4682-b9f9-296708a3dd90","chain":"Ethereum","sigma":0.21,"symbol":"USDC","il_risk":"no","project":"example-protocol","tvl_usd":52400000,"apy_base":6.1,"exposure":"single","apy_reward":3.32,"prediction":"Stable/Up","risk_flags":[],"stablecoin":true,"apy_mean_30d":8.7}],"filters":{"sort":"apy","chain":null,"stable":true,"min_tvl_usd":1000000}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YHqZP_V6b5eiyb0WHrWcH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked DeFi yield pools filtered by chain, stablecoin status, minimum TVL, and sorted by APY or TVL","exampleAgentPrompt":"Show me the top 10 stablecoin yield pools on Ethereum with at least $1M TVL, sorted by APY.","exampleUseCases":[{"title":"Stablecoin yield optimization on Ethereum","prompt":"Find me the best stablecoin-only yield pools on Ethereum with at least $500,000 TVL, sorted by APY — I want the top 15 results."},{"title":"Comparing yields across all chains by TVL","prompt":"Show me the 20 largest DeFi pools across all chains ranked by total value locked, I don't care about chain — just the biggest pools."},{"title":"Low-risk yield hunting on Base","prompt":"What are the top 5 DeFi yield pools on Base right now sorted by APY, with a minimum TVL of $100,000? Stablecoins only please."}],"resultDescription":"A JSON object containing a timestamp, pool count, active filters applied, and an array of up to 50 ranked pools. Each pool entry includes: APY (total, base, reward, 30-day mean), TVL in USD, pool UUID, chain, token symbol, project name, impermanent loss risk flag, stablecoin flag, single/multi exposure type, risk flags array, and a yield prediction label (e.g. Stable/Up).","failureModes":["Invalid chain name returns empty pool list or 400 error","limit out of range (>50 or <1) rejected by schema validation","minTvlUsd set too high returns zero pools","sort enum value not in [apy, tvl] causes validation failure","Payment of $0.005 USDC not provided results in 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need real-time ranked DeFi yield pool data with filtering by chain, stablecoin type, and minimum TVL. It is well-suited for yield optimization agents, DeFi dashboard builders, or portfolio advisors that need structured pool metrics including APY breakdowns and risk signals. Prefer this over manual DeFi aggregator browsing when you need machine-readable, filterable pool data with IL risk and prediction labels included.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:48:17.520Z","isFirstParty":false,"canonicalSlug":"three-ws-yield-scan-defi-pool-rankings-api-2007e6d8"}