# CoinMarketCap API: Get coin price

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

Unofficial. Not affiliated with or endorsed by CoinMarketCap.

- Page: https://fous.com/methods/coinmarketcap.com/get-coin-price
- Method: `coinmarketcap.com/get_coin_price`, version 1
- Website: coinmarketcap.com
- Returns: name, symbol, rank, price, changes, market cap, volume, supply, all-time high, last update, 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 |
|---|---|---|---|---|
| `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. Default "USD". |

## Output

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

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

Its output:

```json
{
  "link": "https://coinmarketcap.com/currencies/ethereum/",
  "name": "Ethereum",
  "rank": 2,
  "slug": "ethereum",
  "price": 2144.2897863674384,
  "symbol": "ETH",
  "currency": "EUR",
  "market_cap": 261936501389.05014,
  "volume_24h": 10628539689.816965,
  "last_updated": "2026-10-23T07:20:00.000Z",
  "maximum_supply": null,
  "coinmarketcap_id": 1027,
  "change_1h_percent": -0.017174,
  "change_7d_percent": -1.861411,
  "all_time_high_date": "2025-08-24",
  "change_24h_percent": -0.669346,
  "circulating_supply": 122155364.9391704,
  "all_time_high_price": 4424.1640040879465
}
```

## 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/get_coin_price","input":{"coin":"ETH","currency":"Euro"}}'
```

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

- What is Bitcoin trading at right now in US dollars?
- price of ETH in euros with market cap and circulating supply
- Solana current price, 24h change and all-time high in Japanese yen
- how much is Dogecoin worth today, and what's its trading volume?
- check coinmarketcap for the live Cardano price in British pounds

## Input schema

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

## Output schema

```json
{
  "type": "object",
  "required": [
    "name",
    "symbol",
    "rank",
    "price",
    "currency",
    "change_1h_percent",
    "change_24h_percent",
    "change_7d_percent",
    "market_cap",
    "volume_24h",
    "circulating_supply",
    "maximum_supply",
    "all_time_high_price",
    "all_time_high_date",
    "last_updated",
    "link",
    "coinmarketcap_id",
    "slug"
  ],
  "properties": {
    "link": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "rank": {
      "type": [
        "integer",
        "null"
      ]
    },
    "slug": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "symbol": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "market_cap": {
      "type": [
        "number",
        "null"
      ]
    },
    "volume_24h": {
      "type": [
        "number",
        "null"
      ]
    },
    "last_updated": {
      "type": "string",
      "format": "date-time"
    },
    "maximum_supply": {
      "type": [
        "number",
        "null"
      ]
    },
    "coinmarketcap_id": {
      "type": "integer"
    },
    "change_1h_percent": {
      "type": [
        "number",
        "null"
      ]
    },
    "change_7d_percent": {
      "type": [
        "number",
        "null"
      ]
    },
    "all_time_high_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "change_24h_percent": {
      "type": [
        "number",
        "null"
      ]
    },
    "circulating_supply": {
      "type": [
        "number",
        "null"
      ]
    },
    "all_time_high_price": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
```

## See more

- [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.
- [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.
- [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.
- [Coinbase API: Get coin price](https://fous.com/methods/coinbase.com/get-coin-price.md): Looks up a cryptocurrency's current Coinbase spot, buy and sell prices in a chosen currency.
- [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.
- [Binance API: Get coin price](https://fous.com/methods/binance.com/get-coin-price.md): Gets a Binance spot pair's latest price and rolling 24-hour trading statistics from a coin name or symbol. Only currently trading pairs are available.
- [CoinGecko API: Get coin price on date](https://fous.com/methods/coingecko.com/get-coin-price-on-date.md): Gets a coin's price, market cap and 24-hour volume at 00:00 UTC on a past date. Non-USD currencies are available only for the last 365 days.
- [Kraken API: Get coin price](https://fous.com/methods/kraken.com/get-coin-price.md): Gets a coin's current Kraken price, bid and ask, and 24-hour trading statistics in a chosen currency, with change since today's midnight UTC open.
- [All CoinMarketCap methods](https://fous.com/methods/coinmarketcap.com.md)
