# CoinMarketCap API: List top coins by market cap

> Lists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency.

Unofficial. Not affiliated with or endorsed by CoinMarketCap.

- Page: https://fous.com/methods/coinmarketcap.com/list-top-coins
- Method: `coinmarketcap.com/list_top_coins`, version 1
- Website: coinmarketcap.com
- Returns: rank, name, symbol, price, 24h/7d change, market cap, volume, supply, link
- 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 |
|---|---|---|---|---|
| `currency` | string | no | `"USD"` | Currency name or code for prices, market caps, and volumes. Example: Euro or EUR. Default "USD". |
| `max_results` | integer | no | `20` | Maximum number of ranked coins to return, from 1 to 200. Default 20. |

## Output

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

```json
{
  "currency": "USD",
  "max_results": 20
}
```

Its output:

```json
{
  "coins": [
    {
      "name": "Bitcoin",
      "rank": 1,
      "price": 81746.0357327227,
      "symbol": "BTC",
      "market_cap": 1643282271411.447,
      "volume_24h": 27239840632.650894,
      "change_7d_percent": -0.42740148,
      "change_24h_percent": -0.29555307,
      "circulating_supply": 20102287,
      "coinmarketcap_link": "https://coinmarketcap.com/currencies/bitcoin/"
    },
    {
      "name": "Ethereum",
      "rank": 2,
      "price": 2407.0651739479576,
      "symbol": "ETH",
      "market_cap": 294035924755.98047,
      "volume_24h": 11671629104.57986,
      "change_7d_percent": -1.80385028,
      "change_24h_percent": -0.28758248,
      "circulating_supply": 122155364.9391704,
      "coinmarketcap_link": "https://coinmarketcap.com/currencies/ethereum/"
    },
    {
      "name": "Tether USDt",
      "rank": 3,
      "price": 0.9986155756513813,
      "symbol": "USDT",
      "market_cap": 182473160113.14856,
      "volume_24h": 58522545534.190285,
      "change_7d_percent": -0.01105512,
      "change_24h_percent": -0.02222513,
      "circulating_supply": 182726130617.5043,
      "coinmarketcap_link": "https://coinmarketcap.com/currencies/tether/"
    }
  ],
  "currency_code": "USD"
}
```

## 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":"coinmarketcap.com/list_top_coins","input":{"currency":"USD","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 15 largest cryptocurrencies by market cap priced in Euros, with 24h and 7d changes
- What are the top 50 coins ranked by market cap in USD right now?
- Give me a ranked list of the biggest crypto assets on CoinMarketCap with their circulating supply and 24-hour trading volume
- I need the top 10 coins by market capitalization in Japanese Yen, including prices and weekly percentage moves
- Which cryptocurrencies rank highest by market cap today? List around 100 with symbols and links to their pages

## Input schema

```json
{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Currency name or code for prices, market caps, and volumes. Example: Euro or EUR."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of ranked coins to return, from 1 to 200."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "currency_code",
    "coins"
  ],
  "properties": {
    "coins": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "name",
          "symbol",
          "coinmarketcap_link"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "rank": {
            "type": "integer"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "symbol": {
            "type": "string"
          },
          "market_cap": {
            "type": [
              "number",
              "null"
            ]
          },
          "volume_24h": {
            "type": [
              "number",
              "null"
            ]
          },
          "change_7d_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "change_24h_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "circulating_supply": {
            "type": [
              "number",
              "null"
            ]
          },
          "coinmarketcap_link": {
            "type": "string"
          }
        }
      }
    },
    "currency_code": {
      "type": "string"
    }
  }
}
```

## See more

- [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 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 Fear and Greed Index](https://fous.com/methods/coinmarketcap.com/get-fear-and-greed-index.md): Returns the current crypto Fear and Greed Index with yesterday, last week and last month comparisons, plus total crypto market size, BTC and ETH dominance from CoinMarketCap.
- [CompaniesMarketCap API: List largest companies](https://fous.com/methods/companiesmarketcap.com/list-largest-companies.md): Ranks public companies worldwide, or by country and industry, by market cap, revenue, earnings, employees or dividend yield. When both a country and an industry are set, the industry ranking order is kept and only companies from that country are shown.
- [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.
- [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.
- [Coinbase API: Get coin overview](https://fous.com/methods/coinbase.com/get-coin-overview.md): Gets a cryptocurrency's price, 24-hour change, market statistics, popularity, tradability, description and website from its public Coinbase price page.
- [CoinGecko API: List crypto categories](https://fous.com/methods/coingecko.com/list-crypto-categories.md): Lists CoinGecko crypto sectors by market cap with daily change, volume, leading coins and category pages, optionally filtered by name or link.
- [All CoinMarketCap methods](https://fous.com/methods/coinmarketcap.com.md)