{"uid":"cap_wQpHxMVhP6nVYyypgUEbj","slug":"agentservices-defi-yields-api-317a213f","name":"AgentServices DeFi Yields API","description":"Paid data APIs for AI agents. Crypto market data, DeFi yields, IP geolocation, dispute resolution, marketing intelligence. Powered by x402 micropayments on Base.","url":"https://agentservices.to/v1/yields","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string"},"limit":{"type":"integer"}}},"responseSchema":{"type":"object","title":"Response Defi Yields V1 Yields Get","properties":{"pools":{"type":"array","items":{"type":"object","properties":{"apy":{"type":"number"},"pool":{"type":"string"},"chain":{"type":"string"},"tvl_usd":{"type":"number"},"protocol":{"type":"string"}}}}},"additionalProperties":true},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h-eWcAgyjN8RMUivLKDBR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current DeFi liquidity pool yields (APY, TVL, protocol, chain) filtered by blockchain and result count","exampleAgentPrompt":"What are the top 10 DeFi liquidity pools by APY on Ethereum right now — show me the pool name, protocol, APY, and total value locked?","exampleUseCases":[{"title":"Find highest yield farming opportunities","prompt":"Show me the top 5 DeFi pools with the best APY on Arbitrum right now, including which protocol they're on and how much TVL they have."},{"title":"Cross-chain DeFi yield comparison","prompt":"I want to compare DeFi yields across Base chain — fetch the top 20 pools so I can see which protocols and liquidity pools are offering the best returns."},{"title":"Automated DeFi portfolio rebalancing research","prompt":"Pull the current top 15 yield pools on Optimism for me — I need the APY and TVL for each so I can decide where to move my liquidity."}],"resultDescription":"Returns a JSON object containing an array of liquidity pools, each with: pool identifier, blockchain chain name, DeFi protocol name, current APY as a decimal number, and total value locked in USD. Results can be filtered by chain and limited in count.","failureModes":["Invalid chain name returns empty pool array or 400 error","Limit parameter exceeding available pools silently returns all available pools","Payment failure via x402 micropayment returns 402 Payment Required","Service unavailability or upstream data lag returns 503 or stale data","Missing required authentication/payment header returns 401 or 402"],"whenToPreferThis":"Choose this endpoint when you need current DeFi yield data (APY, TVL) across multiple protocols on a specific blockchain and want chain-filtered results in a single low-cost call ($0.02 USDC). Prefer this over scraping DeFi dashboards when you need structured, machine-readable pool data for automated decision-making or portfolio optimization. Ideal for agents that need to compare yields programmatically without managing complex DeFi protocol integrations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:54.621Z","isFirstParty":false}