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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Asset, required
asset Token symbol or name, such as USDC or Ethereum.
USDC
- Chain optional
chain Limit pools to one chain, such as Arbitrum; Any includes all chains.
Any (default)
- Max Results optional
max_results Maximum number of pools to return, such as 20.
20 (default)
Whole number from 1 to 100.
- Minimum Pool Size (USD) optional
minimum_pool_size_usd Minimum pool TVL in US dollars, such as 1000000.
1000000 (default)
Number 0 or more.
Input as JSON
{ "asset": "USDC"}Output
{ "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 } ]}Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "defillama.com/list_best_yields" , "input": { "asset": "USDC" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "defillama.com/list_best_yields" , "input": { "asset": "USDC" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run defillama.com/list_best_yields# with {"asset":"USDC"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
defillama.com/list_best_yields- Returns
- project, chain, pool symbols, total/base/reward/30-day APY, pool size, stablecoin flag, DefiLlama link, pool ID
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method defillama.com/list_best_yields with the inputs above.
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.
See more
All DefiLlama methodsGets 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.com/get_defi_projectLists 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.com/list_top_blockchainsLists 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.
defillama.com/list_stablecoinsReturns TradingView's buy, sell and neutral technical indicator summary for a stock, cryptocurrency or currency pair. Not investment advice.
tradingview.com/get_technical_ratingGets 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.com/get_coin_priceLists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency.
coinmarketcap.com/list_top_coinsLists 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.
bankrate.com/list_best_savings_ratesLooks 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.
finance.yahoo.com/get_quote