# 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/workflows/coinmarketcap
- Handle: `@coinmarketcap`
- Category: [Blockchain](https://fous.com/workflows/category/blockchain)
- Source website: https://coinmarketcap.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with CoinMarketCap.

## Methods

### Get coin price

Operation `get_coin_price`, version 1. 1 credit per call.

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

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

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

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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@coinmarketcap","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

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

### Is Fous affiliated with CoinMarketCap?

No. Fous is not affiliated with CoinMarketCap. This workflow reads the public coinmarketcap.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/kraken.md): Live cryptocurrency market prices and trading statistics from Kraken.
- [MSN Money API](https://fous.com/workflows/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/workflows/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/workflows/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 workflows](https://fous.com/workflows/category/blockchain)