{"uid":"cap_cIfw31Jp9rgSJ-VIG73up","slug":"agent-data-desk-defi-yields-8dc80530","name":"Agent Data Desk – DeFi Yields","description":"Pay-per-call data for AI agents: weather ($0.005), defi_yields ($0.002), token_balance ($0.002), markdown ($0.01). USDC on Base mainnet via x402 v2; no API keys, no accounts.","url":"https://x402-seller.zshnfaizal.workers.dev/v1/defi/yields","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","required":["chain"],"properties":{"chain":{"type":"string","description":"Chain name as used by DefiLlama (case-insensitive): base, ethereum, arbitrum, optimism, polygon, bsc, solana, avalanche... Omit for all chains."},"limit":{"type":"integer","description":"Max pools to return (1-100)."},"symbol":{"type":"string","description":"Only pools whose symbol contains this text, e.g. USDC."},"max_apy":{"type":"number","description":"Drop pools with APY above this percent (outlier guard). Default 1000; 0 disables."},"min_tvl":{"type":"number","description":"Minimum pool TVL in USD. Default 100000 with a chain, 1000000 without."},"project":{"type":"string","description":"Only pools from this DefiLlama project slug, e.g. aave-v3, morpho-blue."},"stablecoin":{"type":"boolean","description":"true = only pools DefiLlama flags as stablecoin pools."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["pools","count"],"properties":{"cache":{"type":"string"},"count":{"type":"integer"},"pools":{"type":"array","items":{"type":"object","properties":{"apy":{"type":"number"},"url":{"type":"string"},"pool":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"tvlUsd":{"type":"number"},"apyBase":{"type":["number","null"]},"project":{"type":"string"},"apyReward":{"type":["number","null"]},"stablecoin":{"type":"boolean"}}}},"source":{"type":"string"},"filters":{"type":"object"},"fetched_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"cache":"miss","count":5,"pools":[{"apy":42.1,"url":"https://defillama.com/yields/pool/c07a115f-7299-4dd1-ac25-2de459010b6b","pool":"c07a115f-7299-4dd1-ac25-2de459010b6b","chain":"Base","symbol":"WETH-USDC","tvlUsd":12345678,"apyBase":12.3,"project":"aerodrome-slipstream","apyReward":29.8,"stablecoin":false}],"source":"yields.llama.fi/pools","filters":{"chain":"Base","limit":5,"max_apy":1000,"min_tvl":1000000},"fetched_at":"2026-08-29T20:05:12.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__V8qT1h-QG4WjLnuk0vut","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns filtered DeFi yield pool data (APY, TVL, project, symbol) from DefiLlama for a specified chain and criteria","exampleAgentPrompt":"Show me the top 10 DeFi yield pools on Base that include USDC, with at least $500,000 TVL and an APY under 500% — I want to see what Aerodrome or Aave v3 are offering right now.","exampleUseCases":[{"title":"Best stablecoin yields on Ethereum","prompt":"Find me the top 20 stablecoin yield pools on Ethereum with at least $1 million TVL and APY under 300% — I want to compare options across protocols."},{"title":"Scout Aerodrome pools on Base","prompt":"Pull the current Aerodrome-slipstream pools on Base, limit to 15, and filter out anything with APY over 1000% so I can see realistic opportunities."},{"title":"Cross-chain USDC yield comparison","prompt":"What are the best USDC yield pools on Arbitrum right now? Show me up to 25 pools with at least $500k TVL so I can figure out where to deploy capital."}],"resultDescription":"A JSON object containing an array of yield pools, each with pool ID, chain, symbol, project slug, APY (total, base, and reward components), TVL in USD, and a DefiLlama URL. Also includes metadata: applied filters, data source, fetch timestamp, and cache status (hit/miss).","failureModes":["Invalid or unrecognized chain name returns empty pool list or error","limit out of range (must be 1-100) may return validation error","No pools matching filters returns count 0 with empty pools array","Payment failure (insufficient USDC balance or x402 protocol error) blocks the call","Rate limiting or DefiLlama upstream outage may return stale cached data or error","Extremely restrictive filter combinations (very high min_tvl + low max_apy) may return zero results"],"whenToPreferThis":"Choose this endpoint when an AI agent needs real-time DeFi yield data filtered by chain, token, project, TVL, or APY without setting up API keys or accounts. It is ideal for agents that need to compare yield opportunities across DeFi protocols programmatically and can pay $0.002 USDC per call via x402. Prefer it over direct DefiLlama API calls when you need a pay-per-use, keyless integration with pre-built filtering logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:41:18.452Z","isFirstParty":false}