{"uid":"cap_h-CZ9nSkJnsoy7yY4F2SP","slug":"baseyield-oracle-x402-90779ba2","name":"BaseYield Oracle x402","description":"Real-Time DeFi Lending & Staking Yield Oracle for Base Mainnet (Chain ID 8453), payable via x402.","url":"https://baseyield-x402.vercel.app/v1/top-pools","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","title":"TopPoolsInput","properties":{"limit":{"type":"integer","title":"Limit","default":10,"maximum":100,"minimum":1},"min_tvl":{"type":"number","title":"Min Tvl","default":1000000,"maximum":1000000000000000,"minimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"const":"json"},"example":{"type":"object","title":"TopPoolsResponse","required":["success","network","source","source_timestamp","fetched_at","timestamp","total_qualifying_pools","top_pools"],"properties":{"source":{"type":"string","title":"Source"},"network":{"type":"string","title":"Network"},"success":{"type":"boolean","title":"Success"},"timestamp":{"type":"string","title":"Timestamp"},"top_pools":{"type":"array","items":{"type":"object","title":"Pool","required":["project","symbol","pool_id","apy","apy_base","apy_reward","tvl_usd","underlying_tokens","source_timestamp"],"properties":{"apy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Apy"},"symbol":{"type":"string","title":"Symbol"},"pool_id":{"type":"string","title":"Pool Id"},"project":{"type":"string","title":"Project"},"tvl_usd":{"type":"number","title":"Tvl Usd"},"apy_base":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Apy Base"},"apy_reward":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Apy Reward"},"source_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Timestamp"},"underlying_tokens":{"type":"array","items":{"type":"string"},"title":"Underlying Tokens"}}},"title":"Top Pools"},"fetched_at":{"type":"string","title":"Fetched At"},"source_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Timestamp"},"total_qualifying_pools":{"type":"integer","title":"Total Qualifying Pools"}}}}}}},"responseSchema":{"type":"object","properties":{"asset":{"type":"string"},"pools":{"type":"array"},"network":{"type":"string"},"best_apy":{"type":"number"},"timestamp":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wQDDjOB94xESZCJHOwMn2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time DeFi lending and staking yield data (APY, TVL, pool rankings) for assets on Base Mainnet, paid per-call via x402.","exampleAgentPrompt":"What are the top USDC yield pools on Base Mainnet right now? Only show me pools with at least $500K TVL and rank them by APY.","exampleUseCases":[{"title":"Best stablecoin yield on Base","prompt":"Find me the highest-yielding USDC pools on Base Mainnet — filter to pools with at least $1 million TVL and tell me the best APY available right now."},{"title":"ETH staking opportunities on Base","prompt":"I want to stake my ETH on Base — what are the top pools available right now sorted by APY, with a minimum of $500K in TVL?"},{"title":"DeFi yield monitoring for portfolio rebalancing","prompt":"Check the current top lending pools on Base for USDC and give me the best APY so I can decide whether to move my funds from my current position."}],"resultDescription":"Returns a JSON object containing the queried asset symbol, the network name (Base Mainnet), a ranked array of top DeFi pools with their APY and TVL data, the single best APY found across all matching pools, and a timestamp indicating data freshness.","failureModes":["Payment not received via x402 — returns 402 Payment Required before data is served","Unknown or unsupported asset symbol — may return empty pool list or error","min_tvl set too high — returns empty pools array if no pools exceed threshold","Upstream on-chain data unavailability — stale or missing pool data","Service downtime on Vercel hosting — 500 or timeout response"],"whenToPreferThis":"Choose this endpoint when you need real-time, ranked DeFi yield data specifically on Base Mainnet (Chain ID 8453) and want per-call micropayment pricing via x402 rather than a subscription. Ideal for agents that need fresh APY snapshots on demand without committing to an API key or monthly plan.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:34:52.511Z","isFirstParty":false}