{"uid":"cap_iAstCDeyQUCy9vbAnLcko","slug":"heurist-mesh-defillama-yield-pool-search-f4fc4396","name":"Heurist Mesh: DefiLlama Yield Pool Search","description":"Search DefiLlama yield pools with optional filters for projects, chains, symbols, and stablecoin flag. Returns compact results with APY and TVL trend metrics. List filters (projects/chains/symbols) use OR matching, while different filter types are combined with AND.","url":"https://mesh.heurist.xyz/x402/solana/agents/DefiLlamaAgent/search_yield_pools","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":[],"properties":{"debug":{"type":"boolean","default":false,"description":"Debug mode flag. ALWAYS use false."},"limit":{"type":"integer","default":10,"maximum":50,"minimum":1,"description":"Number of pools to return (1-50)"},"chains":{"type":"array","items":{"type":"string"},"description":"Optional chain names (e.g., ['Ethereum', 'Arbitrum'])"},"sort_by":{"enum":["apy","tvl"],"type":"string","default":"apy","description":"Sort field: APY or TVL"},"symbols":{"type":"array","items":{"type":"string"},"description":"Optional token symbols (e.g., ['USDC', 'USDT'])"},"projects":{"type":"array","items":{"type":"string"},"description":"Optional project slugs (e.g., ['aave-v3', 'curve-dex'])"},"stablecoin":{"type":"boolean","description":"Optional stablecoin-only filter"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"result":{"type":"object","additionalProperties":true}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MWoxuu1FG5yVEUeBQr5Xv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search DefiLlama yield pools with optional filters for projects, chains, symbols, and stablecoin status, returning APY and TVL trend metrics.","exampleAgentPrompt":"Search DefiLlama for the best yield pools offering stablecoin yields on Ethereum and Arbitrum — filter for USDC and USDT symbols and show me APY and TVL trends for each pool.","exampleUseCases":[{"title":"Stablecoin yield hunting across chains","prompt":"Find me the top stablecoin yield pools on Ethereum and Polygon, filtering for USDC and USDT — I want to see current APY and whether TVL is trending up or down."},{"title":"Protocol-specific pool comparison","prompt":"Search for all yield pools from Aave and Curve on Arbitrum and show me their APY and TVL metrics so I can compare where to deploy capital."},{"title":"High-APY opportunity discovery","prompt":"Look up yield pools on DefiLlama for the ETH and WBTC symbols across all chains and give me the ones with the highest APY along with their TVL trend data."}],"resultDescription":"Returns a compact list of matching yield pools from DefiLlama, each including pool name, project, chain, symbol, current APY, TVL, and trend metrics indicating whether APY and TVL are rising or falling.","failureModes":["No pools match the specified filter combination (returns empty results)","Invalid project, chain, or symbol names produce no results without error","Stale data if DefiLlama upstream is delayed","Payment failure if insufficient USDC balance for $0.003 per call","Rate limiting or timeout if querying very broad filters"],"whenToPreferThis":"Use this endpoint when you need structured yield pool data from DefiLlama with flexible multi-dimensional filtering (project, chain, symbol, stablecoin). Prefer this over generic DeFi APIs when you need compact APY+TVL trend data quickly and want OR logic within filter categories combined with AND logic across them. Ideal for agents comparing yield opportunities across protocols or chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:01.272Z","isFirstParty":false}