# DefiLlama API: List best yields for an asset > Finds the highest-APY DeFi pools on DefiLlama for a token symbol or name, optionally filtered by chain and minimum pool size. Unofficial. Not affiliated with or endorsed by DefiLlama. - Page: https://fous.com/methods/defillama.com/list-best-yields - Method: `defillama.com/list_best_yields`, version 1 - Website: defillama.com - Returns: project, chain, pool symbols, total/base/reward/30-day APY, pool size, stablecoin flag, DefiLlama link, pool ID - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `asset` | string | yes | `"USDC"` | Token symbol or name, such as USDC or Ethereum. | | `chain` | string | no | | Limit pools to one chain, such as Arbitrum; Any includes all chains. Default "Any". | | `max_results` | integer | no | | Maximum number of pools to return, such as 20. Default 20. | | `minimum_pool_size_usd` | number | no | | Minimum pool TVL in US dollars, such as 1000000. Default 1000000. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "asset": "USDC" } ``` Its output: ```json { "yields": [ { "pool": "USDC-VELVET", "chain": "Base", "pool_id": "c07a115f-7299-4dd1-ac25-2de459010b6b", "project": "Aerodrome Slipstream", "apy_percent": 75094.09201, "pool_size_usd": 1010551, "defillama_link": "https://defillama.com/yields/pool/c07a115f-7299-4dd1-ac25-2de459010b6b", "stablecoin_pool": false, "base_apy_percent": 0.52985, "reward_apy_percent": 75093.56216, "average_apy_30d_percent": 65459.58543 }, { "pool": "USDC-MSTRC", "chain": "Base", "pool_id": "06ae14ef-c2e3-5e30-9876-3e06c8b2f9a9", "project": "Aerodrome Slipstream", "apy_percent": 2350.97331, "pool_size_usd": 1366898, "defillama_link": "https://defillama.com/yields/pool/06ae14ef-c2e3-5e30-9876-3e06c8b2f9a9", "stablecoin_pool": false, "base_apy_percent": 158.53203, "reward_apy_percent": 2192.44128, "average_apy_30d_percent": 2975.57173 }, { "pool": "USDC-SNDKC", "chain": "Base", "pool_id": "3026b289-5595-548d-b9cc-e8c265ac1746", "project": "Aerodrome Slipstream", "apy_percent": 1655.61623, "pool_size_usd": 1017530, "defillama_link": "https://defillama.com/yields/pool/3026b289-5595-548d-b9cc-e8c265ac1746", "stablecoin_pool": false, "base_apy_percent": 99.72498, "reward_apy_percent": 1555.89125, "average_apy_30d_percent": 2309.94957 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"defillama.com/list_best_yields","input":{"asset":"USDC"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What are the highest APY pools for USDC on Arbitrum right now? Only show ones with at least $5M in TVL. - Pull the top 10 yield opportunities for ETH across all chains from DefiLlama, including base vs reward APY breakdown. - I'm holding some WBTC and want to earn on it — where can I get the best yield? Skip tiny pools under $2 million. - Check DefiLlama for the best DAI farming rates on Base, show me 15 results with their 30-day average APY. - Find top-yielding pools for SOL on Solana with TVL above $500k, and give me links to each pool. ## Input schema ```json { "type": "object", "required": [ "asset" ], "properties": { "asset": { "type": "string", "minLength": 1, "description": "Token symbol or name, such as USDC or Ethereum." }, "chain": { "type": "string", "default": "Any", "description": "Limit pools to one chain, such as Arbitrum; Any includes all chains." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of pools to return, such as 20." }, "minimum_pool_size_usd": { "type": "number", "default": 1000000, "minimum": 0, "description": "Minimum pool TVL in US dollars, such as 1000000." } } } ``` ## Output schema ```json { "type": "object", "required": [ "yields" ], "properties": { "yields": { "type": "array", "items": { "type": "object", "required": [ "project", "chain", "pool", "apy_percent", "base_apy_percent", "reward_apy_percent", "average_apy_30d_percent", "pool_size_usd", "stablecoin_pool", "defillama_link", "pool_id" ], "properties": { "pool": { "type": "string", "description": "Pool asset symbols." }, "chain": { "type": "string", "description": "Blockchain hosting the pool." }, "pool_id": { "type": "string", "description": "DefiLlama pool ID." }, "project": { "type": "string", "description": "Project offering the pool." }, "apy_percent": { "type": "number", "description": "Current total annual percentage yield." }, "pool_size_usd": { "type": "number", "description": "Total pool value in US dollars." }, "defillama_link": { "type": "string", "description": "DefiLlama page for the pool." }, "stablecoin_pool": { "type": "boolean", "description": "Whether DefiLlama marks this as a stablecoin pool." }, "base_apy_percent": { "type": [ "number", "null" ], "description": "Base annual percentage yield, or null if unavailable." }, "reward_apy_percent": { "type": [ "number", "null" ], "description": "Reward annual percentage yield, or null if none is reported." }, "average_apy_30d_percent": { "type": [ "number", "null" ], "description": "30-day average annual percentage yield, or null if unavailable." } }, "additionalProperties": false }, "description": "Matching pools, highest APY first." } }, "additionalProperties": false } ``` ## See more - [DefiLlama API: Get DeFi project](https://fous.com/methods/defillama.com/get-defi-project.md): Gets a DeFi project's current TVL, 1-day and 7-day changes, chain breakdown, token information and daily TVL history from DefiLlama. Parent projects combine their listed versions. - [DefiLlama API: List top blockchains by TVL](https://fous.com/methods/defillama.com/list-top-blockchains.md): Lists blockchains ranked by the total value locked in their DeFi apps on DefiLlama, with one-day and seven-day TVL changes, DeFi project counts and chain token symbols. - [DefiLlama API: List stablecoins](https://fous.com/methods/defillama.com/list-stablecoins.md): Lists DefiLlama stablecoins ranked by circulating supply in US dollars. Each coin comes with its peg, price, weekly supply change and chain count. You can filter by peg. - [TradingView API: Get technical rating](https://fous.com/methods/tradingview.com/get-technical-rating.md): Returns TradingView's buy, sell and neutral technical indicator summary for a stock, cryptocurrency or currency pair. Not investment advice. - [CoinMarketCap API: Get coin price](https://fous.com/methods/coinmarketcap.com/get-coin-price.md): Gets a cryptocurrency's price, changes, supply, market cap, volume and all-time high in a chosen currency. If a name or symbol is shared, returns the coin with the largest market cap. - [CoinMarketCap API: List top coins by market cap](https://fous.com/methods/coinmarketcap.com/list-top-coins.md): Lists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency. - [Bankrate API: List best savings, CD or money market rates](https://fous.com/methods/bankrate.com/list-best-savings-rates.md): Lists Bankrate's current high-yield savings, CD (for a chosen term) or money market account rates in Bankrate's listed order, with APY, minimum deposit and whether the listing is sponsored. - [Yahoo API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed. - [All DefiLlama methods](https://fous.com/methods/defillama.com.md)