{"uid":"cap_FFZWirUJN38B-CPbzUvB1","slug":"defi-yields-by-token-symbol-defillama-76518b53","name":"DeFi Yields by Token Symbol (DefiLlama)","description":"Best DeFi yields (APY) for a given token symbol, across all chains and protocols, highest first, source DefiLlama — for an agent asking 'where's the best yield for my USDC/ETH/...?'. Parameter: ?symbol=<token symbol> (e.g. USDC, required). Optional: ?limit=<n> (1-100, default 10).","url":"https://x402-seller-0ay3.onrender.com/api/defi/yields/by-token","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":["symbol"],"properties":{"limit":{"type":"integer","description":"Number of pools to return (1-100, default 10)."},"symbol":{"type":"string","description":"Token symbol to match against pool holdings (e.g. USDC, WETH)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yiqVStAeoUkGaCAQheGdi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the best DeFi yield opportunities (APY) for a specified token symbol, ranked highest first, sourced from DefiLlama across all chains and protocols.","exampleAgentPrompt":"Show me the top 10 DeFi pools with the best APY for USDC right now, across all chains and protocols.","exampleUseCases":[{"title":"Best yield for idle USDC","prompt":"Where can I earn the highest yield on USDC right now? Show me the top 5 options across all chains and protocols."},{"title":"ETH yield farming comparison","prompt":"What are the best DeFi pools for depositing ETH to earn yield? Give me the top 10 ranked by APY."},{"title":"Stablecoin yield scouting","prompt":"I have some DAI sitting idle — which lending or liquidity pool is giving the highest APY for DAI across all DeFi protocols?"}],"resultDescription":"A ranked list of DeFi pools (up to the requested limit) that hold the specified token, each including the pool name, protocol, chain, and current APY — sorted from highest to lowest yield, sourced from DefiLlama.","failureModes":["Missing required 'symbol' parameter returns an error","Unknown or unsupported token symbol returns an empty list or error","Limit value outside 1-100 range may return a validation error","DefiLlama data may be slightly delayed or stale for low-liquidity pools","Network or upstream DefiLlama API outage causes failure"],"whenToPreferThis":"Use this endpoint when you need yield opportunities filtered specifically to a known token symbol (e.g. USDC, WETH, DAI) rather than browsing all pools globally. Prefer it over the general yields endpoint when the user has a specific token they want to deploy and wants the best protocol/chain combination for that asset. Ideal for agents helping users optimize idle token holdings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:45:55.223Z","isFirstParty":false}