DefiLlama API: List stablecoins
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.
Unofficial. Not affiliated with or endorsed by DefiLlama.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Pegged to optional
pegged_to Peg to include, for example us_dollar.
us_dollar
One of
any,us_dollar,euro,gold. Defaultany.- Max Results optional
max_results Maximum coins to return, for example 20.
20
Whole number from 1 to 200. Default
20.
Input as JSON
{ "pegged_to": "us_dollar", "max_results": 20}Output
{ "stablecoins": [ { "name": "Tether", "rank": 1, "symbol": "USDT", "page_url": "https://defillama.com/stablecoin/tether" , "pegged_to": "US dollar", "peg_mechanism": "fiat-backed", "number_of_chains": 130, "current_price_usd": 0.9989236647280817, "circulating_supply_usd": 182498824514.4392, "supply_change_7d_percent": -0.5107072388208084 }, { "name": "USD Coin", "rank": 2, "symbol": "USDC", "page_url": "https://defillama.com/stablecoin/usd-coin" , "pegged_to": "US dollar", "peg_mechanism": "fiat-backed", "number_of_chains": 157, "current_price_usd": 0.9995445523375535, "circulating_supply_usd": 72116950103.67883, "supply_change_7d_percent": -0.9533817802856628 }, { "name": "Sky Dollar", "rank": 3, "symbol": "USDS", "page_url": "https://defillama.com/stablecoin/sky-dollar" , "pegged_to": "US dollar", "peg_mechanism": "crypto-backed", "number_of_chains": 7, "current_price_usd": 1.0000663917589985, "circulating_supply_usd": 6879787971.664312, "supply_change_7d_percent": -2.7192366841110682 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"defillama.com/list_stablecoins","input":{"pegged_to":"us_dollar","max_results":20}}' # 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_stablecoins" , "input": { "pegged_to": "us_dollar", "max_results": 20 }})# 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_stablecoins" , "input": { "pegged_to": "us_dollar", "max_results": 20 } }), 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_stablecoins# with {"pegged_to":"us_dollar","max_results":20}"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", "properties": { "pegged_to": { "enum": [ "any", "us_dollar", "euro", "gold" ], "type": "string", "default": "any", "description": "Peg to include, for example us_dollar." }, "max_results": { "type": "integer", "default": 20, "maximum": 200, "minimum": 1, "description": "Maximum coins to return, for example 20." } }}Output schema
{ "type": "object", "required": [ "stablecoins" ], "properties": { "stablecoins": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "rank": { "type": "integer" }, "symbol": { "type": "string" }, "page_url": { "type": "string" }, "pegged_to": { "type": "string" }, "peg_mechanism": { "type": [ "string", "null" ] }, "number_of_chains": { "type": "integer" }, "current_price_usd": { "type": [ "number", "null" ] }, "circulating_supply_usd": { "type": "number" }, "supply_change_7d_percent": { "type": [ "number", "null" ] } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
defillama.com/list_stablecoins- Returns
- rank, name, symbol, circulating supply USD, peg, mechanism, price, 7d supply change, chain count, page URL
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_stablecoins with the inputs above.
Ask your agent
- Show me the top 10 stablecoins by circulating supply pegged to the US dollar, with their price and 7-day supply change
- Which euro-pegged stablecoins are largest right now? List up to 15 with their chain counts
- I need a ranked list of gold-backed stablecoins including circulating supply and peg mechanism
- What are the biggest stablecoins on defillama.com, and how much has each one's supply changed over the past week?
- Give me the top 25 stablecoins of any peg, sorted by market size, with their symbols and page URLs
See more
All DefiLlama methodsLists 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_blockchainsFinds the highest-APY DeFi pools on DefiLlama for a token symbol or name, optionally filtered by chain and minimum pool size.
defillama.com/list_best_yieldsGets 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 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 up to 15 of the most-searched coins on CoinGecko in trending order, with price and 24-hour change in the chosen currency. Non-USD prices may be unavailable for some coins.
coingecko.com/list_trending_coinsLists the largest price rises and falls among CoinMarketCap's top 100 coins with over $50,000 in 24-hour volume, for a chosen period.
coinmarketcap.com/list_gainers_and_losersGets 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 Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates.
store.steampowered.com/list_top_sellers