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

## Methods

### Get coin price history

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

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

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

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

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

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": "@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.
# 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\": \"@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=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": "@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);
```

Or describe the data in plain language: send `{"api":"@coingecko","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, 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

### Is Fous affiliated with CoinGecko?

No. Fous is not affiliated with CoinGecko. This workflow reads the public coingecko.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 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/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/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.
- [Kraken API](https://fous.com/workflows/kraken.md): Live cryptocurrency market prices and trading statistics from Kraken.
- [Google Trends API](https://fous.com/workflows/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/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.
- [GitHub API](https://fous.com/workflows/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/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.
- [Twitch API](https://fous.com/workflows/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 workflows](https://fous.com/workflows/category/blockchain)