{"uid":"cap_xgBBkYMDQrnoCPo5Ue6cT","slug":"true402-defi-yield-lookup-49697f8a","name":"true402 DeFi Yield Lookup","description":"The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.","url":"https://true402.dev/api/v1/defi-yields","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"asset":{"type":"string","description":"Case-insensitive substring match on the pool symbol"},"chain":{"type":"string","description":"Filter by chain, case-insensitive (e.g. \"Base\")"},"limit":{"type":"number","description":"Max pools, 1–50 (default 20), applied after sort"},"project":{"type":"string","description":"Filter by protocol, case-insensitive (e.g. \"aave-v3\")"},"minTvlUsd":{"type":"number","description":"Drop pools below this TVL (USD), ≥ 0"},"stablecoinOnly":{"type":"boolean","description":"Keep only stablecoin pools"},"includeOutliers":{"type":"boolean","description":"Include DefiLlama outlier:true pools (default false)"}}},"responseSchema":{"type":"object","properties":{"asOf":{"type":"string"},"count":{"type":"number"},"pools":{"type":"array"},"query":{"type":"object"},"source":{"type":"string"}}},"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_hmZmo7OeoQ_7XM6KLjmsz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches and filters DeFi liquidity pool yield data (APY, TVL) from DefiLlama, filterable by asset, chain, protocol, TVL floor, and stablecoin type.","exampleAgentPrompt":"Show me the top 10 stablecoin-only DeFi pools on Base with at least $500,000 TVL — I want to see which ones have the best yields right now.","exampleUseCases":[{"title":"Best stablecoin yields on Base","prompt":"What are the top 5 stablecoin pools on Base right now with TVL above $1 million? I want to find somewhere safe to park USDC for yield."},{"title":"Aave protocol yield comparison","prompt":"Pull the best yielding pools from Aave v3 across any chain, up to 20 results, and tell me which ones have the highest APY."},{"title":"ETH pool discovery for yield farming","prompt":"Find me DeFi pools that include ETH in their symbol, minimum TVL of $2 million, sorted by yield — show me up to 15 pools."}],"resultDescription":"Returns a list of DeFi liquidity pools matching the specified filters, each entry including pool symbol, protocol/project name, chain, APY, and TVL in USD. Results are sorted and capped at the requested limit (default 20, max 50). Outlier pools (as flagged by DefiLlama) are excluded by default.","failureModes":["No pools match filters — returns empty list or zero results","Invalid chain or project name — case-insensitive match may return no results if spelling is wrong","limit out of range (must be 1–50) — validation error","minTvlUsd negative value — validation error","HTTP 402 payment required if wallet/payment not attached","DefiLlama upstream unavailable — may return 5xx or stale data"],"whenToPreferThis":"Choose this endpoint when you need real-time DeFi yield data filtered by asset, chain, protocol, or TVL without scraping DefiLlama yourself. It is ideal for agents comparing yield opportunities, building DeFi dashboards, or making automated liquidity decisions. Prefer this over raw DefiLlama API access when operating in a pay-per-call agent context via HTTP 402/x402 and needing pre-filtered, ranked results with low overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:35:26.692Z","isFirstParty":false}