# 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.

- Page: https://fous.com/methods/defillama.com/list-stablecoins
- Method: `defillama.com/list_stablecoins`, version 1
- Website: defillama.com
- Returns: rank, name, symbol, circulating supply USD, peg, mechanism, price, 7d supply change, chain count, page URL
- 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 |
|---|---|---|---|---|
| `pegged_to` | string | no | `"us_dollar"` | Peg to include, for example us_dollar. One of "any", "us_dollar", "euro", "gold". Default "any". |
| `max_results` | integer | no | `20` | Maximum coins to return, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "pegged_to": "us_dollar",
  "max_results": 20
}
```

Its output:

```json
{
  "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
    }
  ]
}
```

## 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_stablecoins","input":{"pegged_to":"us_dollar","max_results":20}}'
```

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

- 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

## Input schema

```json
{
  "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

```json
{
  "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"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [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 best yields for an asset](https://fous.com/methods/defillama.com/list-best-yields.md): Finds the highest-APY DeFi pools on DefiLlama for a token symbol or name, optionally filtered by chain and minimum pool size.
- [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.
- [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.
- [CoinGecko API: List trending coins](https://fous.com/methods/coingecko.com/list-trending-coins.md): Lists 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.
- [CoinMarketCap API: List gainers and losers](https://fous.com/methods/coinmarketcap.com/list-gainers-and-losers.md): Lists 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 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.
- [Steam API: List top sellers](https://fous.com/methods/store.steampowered.com/list-top-sellers.md): Lists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates.
- [All DefiLlama methods](https://fous.com/methods/defillama.com.md)