# CoinMarketCap API

> CoinMarketCap returns cryptocurrency prices, market rankings, and sentiment as a workflow and API.

Get coin price returns price, supply, market cap, volume, and all-time high for a coin name or symbol in an optional currency. List top coins ranks coins by market cap with optional currency and count; List gainers and losers lists movers by period and direction. Get fear and greed index returns the current sentiment score, past comparisons, and overall market data without inputs.

- Page: https://fous.com/tools/coinmarketcap
- Handle: `@coinmarketcap`
- Category: [Blockchain](https://fous.com/tools/category/blockchain)
- Source website: https://coinmarketcap.com
- Last verified: Sep 29, 2026

## Methods

### Get coin price

Operation `get_coin_price`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `coin` | string | yes | `"ETH"` | Cryptocurrency name or symbol, such as Bitcoin or ETH. |
| `currency` | string | no | `"Euro"` | Currency name or code for prices and monetary values, such as Euro or EUR. Defaults to USD. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "Cryptocurrency name or symbol, such as Bitcoin or ETH.",
      "examples": [
        "ETH",
        "Bitcoin",
        "DOGE"
      ]
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Currency name or code for prices and monetary values, such as Euro or EUR. Defaults to USD.",
      "examples": [
        "Euro",
        "JPY"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "coin": "ETH",
      "currency": "Euro"
    },
    {
      "coin": "Bitcoin"
    },
    {
      "coin": "DOGE",
      "currency": "JPY"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `link` | string | `"https://coinmarketcap.com/currencies/ethereum/"` |  |
| `name` | string | `"Ethereum"` |  |
| `rank` | integer or null | `2` |  |
| `slug` | string | `"ethereum"` |  |
| `price` | number | `2324.2613278346603` |  |
| `symbol` | string | `"ETH"` |  |
| `currency` | string | `"EUR"` |  |
| `market_cap` | number or null | `283763194026.5349` |  |
| `volume_24h` | number or null | `10503792150.940683` |  |
| `last_updated` | string | `"2026-09-28T08:24:01.000Z"` |  |
| `maximum_supply` | number or null | `21000000` |  |
| `coinmarketcap_id` | integer | `1027` |  |
| `change_1h_percent` | number or null | `-0.141876` |  |
| `change_7d_percent` | number or null | `-0.261459` |  |
| `all_time_high_date` | string or null | `"2025-08-24"` |  |
| `change_24h_percent` | number or null | `-2.550467` |  |
| `circulating_supply` | number or null | `122087473.82588676` |  |
| `all_time_high_price` | number or null | `4350.719959908412` |  |

**Example input**

```json
{
  "coin": "ETH",
  "currency": "Euro"
}
```

**Example output**

```json
{
  "link": "https://coinmarketcap.com/currencies/ethereum/",
  "name": "Ethereum",
  "rank": 2,
  "slug": "ethereum",
  "price": 2324.2613278346603,
  "symbol": "ETH",
  "currency": "EUR",
  "market_cap": 283763194026.5349,
  "volume_24h": 10503792150.940683,
  "last_updated": "2026-09-28T08:24:01.000Z",
  "maximum_supply": null,
  "coinmarketcap_id": 1027,
  "change_1h_percent": -0.141876,
  "change_7d_percent": -0.261459,
  "all_time_high_date": "2025-08-24",
  "change_24h_percent": -2.550467,
  "circulating_supply": 122087473.82588676,
  "all_time_high_price": 4350.719959908412
}
```

### Get fear and greed index

Operation `get_fear_and_greed_index`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get the current crypto Fear and Greed Index, past comparisons, and overall market size from CoinMarketCap.

**Input**

No input.

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `currency` | string | `"USD"` | Currency of market capitalization and trading volume: USD. |
| `page_url` | string | `"https://coinmarketcap.com/charts/fear-and-greed-index/"` | CoinMarketCap Fear and Greed Index chart page. |
| `index_label` | string | `"Greed"` | Current score label: Extreme fear, Fear, Neutral, Greed, or Extreme greed. |
| `index_value` | integer | `68` | Current Fear and Greed score on a 0–100 scale. |
| `last_week_value` | integer | `79` | Fear and Greed score one week ago. |
| `yesterday_value` | integer | `72` | Fear and Greed score yesterday. |
| `index_updated_at` | string | `"2026-09-28T08:53:10Z"` | Time CoinMarketCap updated the index, in ISO 8601 UTC. |
| `last_month_value` | integer | `78` | Fear and Greed score one month ago. |
| `total_market_cap_usd` | number | `2841869641644.7017` | Total cryptocurrency market capitalization in USD. |
| `total_volume_24h_usd` | number | `84416558703.91` | Total cryptocurrency trading volume over 24 hours in USD. |
| `bitcoin_dominance_percent` | number | `58.590290564243` | Bitcoin share of the total cryptocurrency market capitalization, in percent. |
| `ethereum_dominance_percent` | number | `11.367369876378` | Ethereum share of the total cryptocurrency market capitalization, in percent. |
| `total_market_cap_change_24h_percent` | number | `-2.311245` | Percentage change in total cryptocurrency market capitalization over 24 hours. |

**Example input**

```json
{}
```

**Example output**

```json
{
  "currency": "USD",
  "page_url": "https://coinmarketcap.com/charts/fear-and-greed-index/",
  "index_label": "Greed",
  "index_value": 68,
  "last_week_value": 79,
  "yesterday_value": 72,
  "index_updated_at": "2026-09-28T08:53:10Z",
  "last_month_value": 78,
  "total_market_cap_usd": 2841869641644.7017,
  "total_volume_24h_usd": 84416558703.91,
  "bitcoin_dominance_percent": 58.590290564243,
  "ethereum_dominance_percent": 11.367369876378,
  "total_market_cap_change_24h_percent": -2.311245
}
```

### List gainers and losers

Operation `list_gainers_and_losers`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List the largest cryptocurrency price rises and falls among CoinMarketCap’s top 100 coins with over $50,000 in 24-hour volume. Results are limited to 30 per direction.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `period` | string | no | `"last_24_hours"` | Price change period, for example last_7_days. |
| `direction` | string | no | `"both"` | Which movers to list, for example both. |
| `max_results` | integer | no | `20` | Maximum coins per direction, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "period": {
      "enum": [
        "last_24_hours",
        "last_7_days",
        "last_30_days"
      ],
      "type": "string",
      "default": "last_24_hours",
      "description": "Price change period, for example last_7_days.",
      "examples": [
        "last_24_hours",
        "last_7_days",
        "last_30_days"
      ]
    },
    "direction": {
      "enum": [
        "gainers",
        "losers",
        "both"
      ],
      "type": "string",
      "default": "both",
      "description": "Which movers to list, for example both.",
      "examples": [
        "both",
        "gainers",
        "losers"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 30,
      "minimum": 1,
      "description": "Maximum coins per direction, for example 20.",
      "x-fous-developer": true,
      "examples": [
        20,
        5,
        30
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "period": "last_24_hours",
      "direction": "both",
      "max_results": 20
    },
    {
      "period": "last_7_days",
      "direction": "gainers",
      "max_results": 5
    },
    {
      "period": "last_30_days",
      "direction": "losers",
      "max_results": 30
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `movers` | array |  | Gainers from largest rise, followed by losers from largest fall. |
| `movers[].link` | string | `"https://coinmarketcap.com/currencies/quant/"` |  |
| `movers[].name` | string | `"Quant"` |  |
| `movers[].rank` | integer or null | `33` |  |
| `movers[].symbol` | string | `"QNT"` |  |
| `movers[].direction` | string | `"Gainer"` |  |
| `movers[].price_usd` | number or null | `256.4601277030079` |  |
| `movers[].change_percent` | number or null | `43.40123993` |  |
| `movers[].volume_24h_usd` | number or null | `1251136245.71812` |  |

**Example input**

```json
{
  "period": "last_24_hours",
  "direction": "both",
  "max_results": 20
}
```

**Example output**

```json
{
  "movers": [
    {
      "link": "https://coinmarketcap.com/currencies/quant/",
      "name": "Quant",
      "rank": 33,
      "symbol": "QNT",
      "direction": "Gainer",
      "price_usd": 256.4601277030079,
      "change_percent": 43.40123993,
      "volume_24h_usd": 1251136245.71812
    },
    {
      "link": "https://coinmarketcap.com/currencies/xdc-network/",
      "name": "XDC Network",
      "rank": 77,
      "symbol": "XDC",
      "direction": "Gainer",
      "price_usd": 0.03429024302702727,
      "change_percent": 12.39482564,
      "volume_24h_usd": 26200708.93302265
    },
    {
      "link": "https://coinmarketcap.com/currencies/pump-fun/",
      "name": "Pump.fun",
      "rank": 42,
      "symbol": "PUMP",
      "direction": "Gainer",
      "price_usd": 0.004872856571045047,
      "change_percent": 9.29131587,
      "volume_24h_usd": 479746268.8245368
    }
  ]
}
```

### List top coins

Operation `list_top_coins`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List the largest cryptocurrencies ranked by market cap, with prices, changes, volume, supply, and CoinMarketCap links in the chosen currency.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `currency` | string | no | `"USD"` | Currency name or code for prices, market caps, and volumes. Example: Euro or EUR. |
| `max_results` | integer | no | `20` | Maximum number of ranked coins to return, from 1 to 200. Example: 20. |

**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.",
      "examples": [
        "USD",
        "Euro",
        "EUR"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of ranked coins to return, from 1 to 200. Example: 20.",
      "x-fous-developer": true,
      "examples": [
        20,
        5,
        200
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "currency": "USD",
      "max_results": 20
    },
    {
      "currency": "Euro",
      "max_results": 5
    },
    {
      "currency": "EUR",
      "max_results": 200
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `coins` | array |  | Cryptocurrencies in market-cap rank order. |
| `coins[].name` | string | `"Bitcoin"` |  |
| `coins[].rank` | integer | `1` |  |
| `coins[].price` | number or null | `82879.41617543963` |  |
| `coins[].symbol` | string | `"BTC"` |  |
| `coins[].market_cap` | number or null | `1665087335963.7625` |  |
| `coins[].volume_24h` | number or null | `30032460620.43488` |  |
| `coins[].change_7d_percent` | number or null | `0.92030069` |  |
| `coins[].change_24h_percent` | number or null | `-2.22730511` |  |
| `coins[].circulating_supply` | number or null | `20090481` |  |
| `coins[].coinmarketcap_link` | string | `"https://coinmarketcap.com/currencies/bitcoin/"` |  |
| `currency_code` | string | `"USD"` | Currency used for monetary values. |

**Example input**

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

**Example output**

```json
{
  "coins": [
    {
      "name": "Bitcoin",
      "rank": 1,
      "price": 82879.41617543963,
      "symbol": "BTC",
      "market_cap": 1665087335963.7625,
      "volume_24h": 30032460620.43488,
      "change_7d_percent": 0.92030069,
      "change_24h_percent": -2.22730511,
      "circulating_supply": 20090481,
      "coinmarketcap_link": "https://coinmarketcap.com/currencies/bitcoin/"
    },
    {
      "name": "Ethereum",
      "rank": 2,
      "price": 2646.043525812738,
      "symbol": "ETH",
      "market_cap": 323048769699.81976,
      "volume_24h": 12114292132.573355,
      "change_7d_percent": -1.14385521,
      "change_24h_percent": -2.58172844,
      "circulating_supply": 122087473.82588676,
      "coinmarketcap_link": "https://coinmarketcap.com/currencies/ethereum/"
    },
    {
      "name": "Tether USDt",
      "rank": 3,
      "price": 0.9994299990920008,
      "symbol": "USDT",
      "market_cap": 183714039072.5767,
      "volume_24h": 68721031573.00902,
      "change_7d_percent": -0.02041173,
      "change_24h_percent": -0.03038778,
      "circulating_supply": 183818815964.58383,
      "coinmarketcap_link": "https://coinmarketcap.com/currencies/tether/"
    }
  ],
  "currency_code": "USD"
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@coinmarketcap",
  "visibility": "public",
  "operation": "get_coin_price",
  "version": 1,
  "input": {
    "coin": "ETH",
    "currency": "Euro"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@coinmarketcap\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_coin_price\",\n  \"version\": 1,\n  \"input\": {\n    \"coin\": \"ETH\",\n    \"currency\": \"Euro\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@coinmarketcap",
  "visibility": "public",
  "operation": "get_coin_price",
  "version": 1,
  "input": {
    "coin": "ETH",
    "currency": "Euro"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/coinmarketcap`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_coin_price`: Get coin price. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_fear_and_greed_index`: Get fear and greed index. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_gainers_and_losers`: List gainers and losers. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_top_coins`: List top coins. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-coinmarketcap https://api.fous.com/mcp/tools/coinmarketcap --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare a coin’s price and market cap across currencies
- Track ranked cryptocurrencies and their trading volumes
- Find the biggest cryptocurrency price rises and falls
- Compare sentiment scores with past readings
- Monitor overall crypto market size and Bitcoin dominance

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this CoinMarketCap tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a CoinMarketCap account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from coinmarketcap.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What is a cryptocurrency’s price and market cap?

Get coin price returns price and market cap for a coin name or symbol, with an optional currency.

### Which cryptocurrencies have risen or fallen the most?

List gainers and losers returns movers for a selected period and direction.

### What is the current crypto Fear and Greed Index?

Get fear and greed index returns the current score and label, past comparisons, and overall market size.

## Related

- [Coinbase API](https://fous.com/tools/coinbase.md): Coinbase provides public cryptocurrency prices and market overviews, including changing spot, buy, and sell quotes and 24-hour statistics; unavailable page facts may be missing.
- [CoinGecko API](https://fous.com/tools/coingecko.md): CoinGecko returns cryptocurrency prices and histories, sector rankings and details, and trending coins; non-USD historical values cover 365 days, histories 7–365 days, and today’s prices may change.
- [Google Finance API](https://fous.com/tools/google-finance.md): Google Finance returns possibly delayed prices and figures, indexes, up to four movers timed by oldest quote, currency conversions, and up to five financial periods.
- [Yahoo Finance API](https://fous.com/tools/yahoo-finance.md): Yahoo Finance provides quotes, movers, company financials, analyst ratings, earnings, news, and up to 5,000 price rows with adjusted returns; prices may be delayed.
- [Kraken API](https://fous.com/tools/kraken.md): Live cryptocurrency market prices and trading statistics from Kraken.
- [MSN Money API](https://fous.com/tools/msn-money.md): MSN Money provides stock quotes, key facts, financial news, and market data, including current market movers; quotes and prices may be delayed.
- [CompaniesMarketCap API](https://fous.com/tools/companiesmarketcap.md): CompaniesMarketCap ranks public companies worldwide or by country and industry across size and financial measures, and provides company figures with market-cap history for completed years.
- [Binance API](https://fous.com/tools/binance.md): Binance provides latest prices and rolling 24-hour statistics for active spot pairs, historical spot candles for a selected date range or newest first (up to 1,000), and current aggregated bid and ask levels.
- [All Blockchain tools](https://fous.com/tools/category/blockchain)