# CoinGecko API

> CoinGecko returns coin prices, price history, crypto categories, and trending coins as a workflow and API.

CoinGecko returns a coin’s price, market cap, and 24-hour volume at 00:00 UTC for a past date; provide a coin and date, with currency optional. CoinGecko returns daily coin prices and price changes over 7, 30, 90, or 365 days; provide a coin, with period and currency optional. CoinGecko lists crypto categories by market capitalization or trending coins by search position; filter categories or choose a currency for prices.

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

## Methods

### Get coin price history

Operation `get_coin_price_history`, 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 coin’s daily prices and price change over the last 7, 30, 90 or 365 days. Dates use UTC; today’s price may change.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `coin` | string | yes | `"Bitcoin"` | Cryptocurrency name or symbol, for example Dogecoin or DOGE. |
| `period` | string | no | `"last_90_days"` | How far back to look, for example last_90_days. |
| `currency` | string | no | `"EUR"` | Currency for prices, for example USD or EUR. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "Cryptocurrency name or symbol, for example Dogecoin or DOGE.",
      "examples": [
        "Bitcoin",
        "BTC",
        "Dogecoin"
      ]
    },
    "period": {
      "enum": [
        "last_7_days",
        "last_30_days",
        "last_90_days",
        "last_year"
      ],
      "type": "string",
      "default": "last_30_days",
      "description": "How far back to look, for example last_90_days.",
      "examples": [
        "last_90_days",
        "last_7_days",
        "last_year"
      ]
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Currency for prices, for example USD or EUR.",
      "examples": [
        "EUR"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "coin": "Bitcoin",
      "period": "last_90_days"
    },
    {
      "coin": "BTC",
      "period": "last_7_days",
      "currency": "EUR"
    },
    {
      "coin": "Dogecoin"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `symbol` | string | `"BTC"` |  |
| `coin_url` | string | `"https://www.coingecko.com/en/coins/bitcoin"` | CoinGecko page for this coin. |
| `currency` | string | `"USD"` |  |
| `coin_name` | string | `"Bitcoin"` |  |
| `daily_prices` | array |  |  |
| `daily_prices[].date` | string | `"2026-07-01"` | UTC date of the price. |
| `daily_prices[].price` | number | `59111.52241823526` | Price in the requested currency. |
| `lowest_price` | number | `59111.52241823526` |  |
| `highest_price` | number | `86596.74004249526` |  |
| `period_end_date` | string | `"2026-09-29"` |  |
| `lowest_price_date` | string | `"2026-07-01"` |  |
| `period_start_date` | string | `"2026-07-01"` |  |
| `highest_price_date` | string | `"2026-09-22"` |  |
| `price_change_percent` | number | `40.632284473615556` |  |

**Example input**

```json
{
  "coin": "Bitcoin",
  "period": "last_90_days"
}
```

**Example output**

```json
{
  "symbol": "BTC",
  "coin_url": "https://www.coingecko.com/en/coins/bitcoin",
  "currency": "USD",
  "coin_name": "Bitcoin",
  "daily_prices": [
    {
      "date": "2026-07-01",
      "price": 59111.52241823526
    },
    {
      "date": "2026-07-02",
      "price": 59967.685041718134
    },
    {
      "date": "2026-07-03",
      "price": 61490.21448471664
    }
  ],
  "lowest_price": 59111.52241823526,
  "highest_price": 86596.74004249526,
  "period_end_date": "2026-09-29",
  "lowest_price_date": "2026-07-01",
  "period_start_date": "2026-07-01",
  "highest_price_date": "2026-09-22",
  "price_change_percent": 40.632284473615556
}
```

### Get coin price on date

Operation `get_coin_price_on_date`, 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 coin’s price, market cap and 24-hour volume at 00:00 UTC on a past date. Historical values in currencies other than USD are available only for the last 365 days; older dates use USD only.

**Input**

| Field | Type | Required | Example | 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, such as 2024-09-29. |
| `currency` | string | no | `"euro"` | Quote currency name or code, such as USD, EUR, or euro. |

**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.",
      "examples": [
        "Ethereum",
        "Bitcoin",
        "BTC"
      ]
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "UTC snapshot date, such as 2024-09-29.",
      "examples": [
        "2026-02-15",
        "2024-09-29",
        "2025-09-29"
      ]
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Quote currency name or code, such as USD, EUR, or euro.",
      "examples": [
        "euro"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "coin": "Ethereum",
      "date": "2026-02-15",
      "currency": "euro"
    },
    {
      "coin": "Bitcoin",
      "date": "2024-09-29"
    },
    {
      "coin": "BTC",
      "date": "2025-09-29"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `date` | string | `"2026-02-15"` |  |
| `note` | string | `"CoinGecko's daily value is the 00:00 UTC snapshot."` |  |
| `price` | number | `1757.5677879690463` |  |
| `symbol` | string | `"ETH"` |  |
| `coin_link` | string | `"https://www.coingecko.com/en/coins/ethereum/historical_data?start=2026-02-15&end=2026-02-15"` |  |
| `coin_name` | string | `"Ethereum"` |  |
| `market_cap` | number or null | `212125193329.37424` |  |
| `volume_24h` | number or null | `13574713761.080927` |  |
| `currency_code` | string | `"EUR"` |  |

**Example input**

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

**Example 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"
}
```

### List crypto categories

Operation `list_crypto_categories`, 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 CoinGecko crypto sectors by market cap, including their size, daily change, volume, leading coins, and category pages. Filter by category name or link; categories without reported market cap appear after ranked categories.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `category` | string | no | `"Artificial Intelligence"` | Category name, part of a name, category link, or category ID; for example, Meme or Artificial Intelligence. Leave blank for all categories. |
| `max_results` | integer | no | `4` | Maximum number of categories, for example 50 (up to 200). |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "default": "",
      "description": "Category name, part of a name, category link, or category ID; for example, Meme or Artificial Intelligence. Leave blank for all categories.",
      "examples": [
        "Artificial Intelligence",
        "Meme"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of categories, for example 50 (up to 200).",
      "x-fous-developer": true,
      "examples": [
        4,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "category": "Artificial Intelligence",
      "max_results": 4
    },
    {
      "category": "Meme",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `categories` | array |  | Categories ordered from largest to smallest market capitalization. |
| `categories[].category_link` | string | `"https://www.coingecko.com/en/categories/artificial-intelligence"` | CoinGecko category page. |
| `categories[].category_name` | string | `"Artificial Intelligence (AI)"` | CoinGecko category name. |
| `categories[].market_cap_usd` | number or null | `24744680109.496906` | Category market capitalization in USD, or null when unavailable. |
| `categories[].volume_24h_usd` | number or null | `3405926570.907825` | 24-hour trading volume in USD. |
| `categories[].top_coin_1_name` | string or null | `"NEAR Protocol"` | Largest listed coin by name. |
| `categories[].top_coin_2_name` | string or null | `"Bittensor"` | Second listed coin by name. |
| `categories[].top_coin_3_name` | string or null | `"Staked TAO (Root)"` | Third listed coin by name. |
| `categories[].market_cap_change_24h_percent` | number or null | `-4.889960184377242` | 24-hour percentage change in market cap. |

**Example input**

```json
{
  "category": "Artificial Intelligence",
  "max_results": 4
}
```

**Example output**

```json
{
  "categories": [
    {
      "category_link": "https://www.coingecko.com/en/categories/artificial-intelligence",
      "category_name": "Artificial Intelligence (AI)",
      "market_cap_usd": 24744680109.496906,
      "volume_24h_usd": 3405926570.907825,
      "top_coin_1_name": "NEAR Protocol",
      "top_coin_2_name": "Bittensor",
      "top_coin_3_name": "Staked TAO (Root)",
      "market_cap_change_24h_percent": -4.889960184377242
    }
  ]
}
```

### List trending coins

Operation `list_trending_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 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.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `currency` | string | no | `"EUR"` | Currency for prices and 24-hour changes, such as USD or EUR. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "default": "USD",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Currency for prices and 24-hour changes, such as USD or EUR.",
      "examples": [
        "EUR",
        "USD"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "currency": "EUR"
    },
    {
      "currency": "USD"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `trending_coins` | array |  | Coins ordered by trending position. |
| `trending_coins[].name` | string | `"Quant"` | Coin name. |
| `trending_coins[].price` | number or null | `202.373568416315` | Current coin price in the currency shown, if available. |
| `trending_coins[].symbol` | string | `"QNT"` | Coin trading symbol. |
| `trending_coins[].currency` | string | `"EUR"` | Price currency code. |
| `trending_coins[].coingecko_link` | string | `"https://www.coingecko.com/en/coins/quant"` | Coin page on CoinGecko. |
| `trending_coins[].market_cap_rank` | integer or null | `36` | CoinGecko market capitalization rank, if available. |
| `trending_coins[].trending_position` | integer | `1` | Position in CoinGecko’s trending search list, starting at 1. |
| `trending_coins[].price_change_24h_percent` | number or null | `-13.085739200520266` | Price change over 24 hours in the chosen currency, as a percentage; null if unavailable. |

**Example input**

```json
{
  "currency": "EUR"
}
```

**Example output**

```json
{
  "trending_coins": [
    {
      "name": "Quant",
      "price": 202.373568416315,
      "symbol": "QNT",
      "currency": "EUR",
      "coingecko_link": "https://www.coingecko.com/en/coins/quant",
      "market_cap_rank": 36,
      "trending_position": 1,
      "price_change_24h_percent": -13.085739200520266
    },
    {
      "name": "Firo",
      "price": 1.112878564639364,
      "symbol": "FIRO",
      "currency": "EUR",
      "coingecko_link": "https://www.coingecko.com/en/coins/firo",
      "market_cap_rank": 811,
      "trending_position": 2,
      "price_change_24h_percent": 2.275215547433386
    },
    {
      "name": "Hedera",
      "price": 0.10433551632539856,
      "symbol": "HBAR",
      "currency": "EUR",
      "coingecko_link": "https://www.coingecko.com/en/coins/hedera",
      "market_cap_rank": 26,
      "trending_position": 3,
      "price_change_24h_percent": 25.363512072887296
    }
  ]
}
```

## 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": "@coingecko",
  "visibility": "public",
  "operation": "get_coin_price_history",
  "version": 1,
  "input": {
    "coin": "Bitcoin",
    "period": "last_90_days"
  },
  "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\": \"@coingecko\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_coin_price_history\",\n  \"version\": 1,\n  \"input\": {\n    \"coin\": \"Bitcoin\",\n    \"period\": \"last_90_days\"\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": "@coingecko",
  "visibility": "public",
  "operation": "get_coin_price_history",
  "version": 1,
  "input": {
    "coin": "Bitcoin",
    "period": "last_90_days"
  },
  "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/coingecko`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_coin_price_history`: Get coin price history. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_coin_price_on_date`: Get coin price on date. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_crypto_categories`: List crypto categories. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_trending_coins`: List trending 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-coingecko https://api.fous.com/mcp/tools/coingecko --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, market cap, and volume on a past date
- Review a coin’s daily prices over a selected period
- Find categories with the largest market capitalizations
- Track 24-hour category market cap changes
- Identify coins trending in searches

## 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 CoinGecko 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 CoinGecko account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from coingecko.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 30, 2026.

### What was a coin’s price on a past date?

Use Get coin price on date with a coin and UTC date; currency is optional.

### How has a coin’s price changed over time?

Use Get coin price history with a coin; period and currency are optional.

### Which coins are trending?

Use List trending coins to see coins ordered by trending position, with prices and 24-hour changes when available.

## Related

- [CoinMarketCap API](https://fous.com/tools/coinmarketcap.md): CoinMarketCap returns prices, rankings and current Fear and Greed readings; gainers and losers include up to 30 top-100 coins above $50,000 in 24-hour volume.
- [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.
- [Kraken API](https://fous.com/tools/kraken.md): Live cryptocurrency market prices and trading statistics from Kraken.
- [Google Trends API](https://fous.com/tools/google-trends.md): Google Trends compares relative search interest over time and by region, shows related searches and current trends, with daily peaks for seven-day views.
- [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.
- [GitHub API](https://fous.com/tools/github.md): GitHub returns public repository matches and details, up to 25 trending projects, issues, pull requests, and newest-first published releases; release or commit dates may be unavailable.
- [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.
- [Twitch API](https://fous.com/tools/twitch.md): Twitch returns channel profiles, live status, up to 10 broadcasts, top streams, viewer-ranked categories, up to 100 public videos/clips, and 1–30-day schedules; counts change.
- [All Blockchain tools](https://fous.com/tools/category/blockchain)