# CoinGecko API: Get coin price on date

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

Unofficial. Not affiliated with or endorsed by CoinGecko.

- Page: https://fous.com/methods/coingecko.com/get-coin-price-on-date
- Method: `coingecko.com/get_coin_price_on_date`, version 1
- Website: coingecko.com
- Returns: coin name, symbol, date, price, market cap, 24h volume, currency, CoinGecko 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 | `"Ethereum"` | Coin name, symbol, CoinGecko link, or coin ID, such as Bitcoin or BTC. |
| `date` | string | yes | `"2026-02-15"` | UTC snapshot date in YYYY-MM-DD form, such as 2024-09-29. |
| `currency` | string | no | `"euro"` | Quote currency name or code, such as USD, EUR, or euro. Default "USD". |

## Output

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

```json
{
  "coin": "Ethereum",
  "date": "2026-02-15",
  "currency": "euro"
}
```

Its output:

```json
{
  "date": "2026-02-15",
  "note": "CoinGecko's daily value is the 00:00 UTC snapshot.",
  "price": 1757.5677879690463,
  "symbol": "ETH",
  "coin_link": "https://www.coingecko.com/en/coins/ethereum/historical_data?start=2026-02-15&end=2026-02-15",
  "coin_name": "Ethereum",
  "market_cap": 212125193329.37424,
  "volume_24h": 13574713761.080927,
  "currency_code": "EUR"
}
```

## 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":"coingecko.com/get_coin_price_on_date","input":{"coin":"Ethereum","date":"2026-02-15","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 was Bitcoin's price at midnight UTC on March 15, 2023, and what was its market cap?
- Look up the Ethereum 24h trading volume as of 2022-11-08 00:00 UTC in US dollars.
- I need the ETH price in euros on 2024-06-01, including market cap, from CoinGecko.
- How much was Solana worth on the date 2021-04-20, and what was its 24-hour volume that day?
- Show me Dogecoin's historical snapshot for 2025-01-10 in British pounds, with its CoinGecko link.

## Input schema

```json
{
  "type": "object",
  "required": [
    "coin",
    "date"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "minLength": 1,
      "description": "Coin name, symbol, CoinGecko link, or coin ID, such as Bitcoin or BTC."
    },
    "date": {
      "type": "string",
      "description": "UTC snapshot date in YYYY-MM-DD form, such as 2024-09-29."
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Quote currency name or code, such as USD, EUR, or euro."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "coin_name",
    "symbol",
    "date",
    "price",
    "market_cap",
    "volume_24h",
    "currency_code",
    "note",
    "coin_link"
  ],
  "properties": {
    "date": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "symbol": {
      "type": "string"
    },
    "coin_link": {
      "type": "string"
    },
    "coin_name": {
      "type": "string"
    },
    "market_cap": {
      "type": [
        "number",
        "null"
      ]
    },
    "volume_24h": {
      "type": [
        "number",
        "null"
      ]
    },
    "currency_code": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

## See more

- [CoinGecko API: Get coin price history](https://fous.com/methods/coingecko.com/get-coin-price-history.md): Gets a coin's daily prices and price change over the last 7, 30, 90 or 365 days, with UTC dates. Today's price may change.
- [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.
- [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.
- [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.
- [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.
- [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 CoinGecko methods](https://fous.com/methods/coingecko.com.md)