<!-- BusyBot node reference — https://busybot.net/tools/coingecko/ -->

> Node: CoinGecko (`coingecko`) · Action · v1
> Category: Finance · Credentials: none
> Updated: 2026-08-16

# CoinGecko

> Retrieve cryptocurrency prices, market data, and events from CoinGecko.

## Overview

CoinGecko is a cryptocurrency data aggregator providing comprehensive market data. This tool provides read-only access to the CoinGecko API v3 (https://api.coingecko.com/api/v3). It supports two resources: Coin (get, get many, market, price, ticker, history, market chart, candlestick) and Event (get many). The Coin resource provides current and historical price data, market metrics, exchange tickers, and OHLC charts. The Event resource lists cryptocurrency-related events. Supports searching by coin ID or contract address. Market and ticker operations support pagination via returnAll/limit pattern. No authentication is required — this is a public API.

**Category:** Finance  
**Tool Name:** `coingecko`  
**Version:** 1

**Appearance:** Icon: `lucide-Coins` | Color: `#8DC63F`

## Node Type

**Action** — processes input items and produces output

## Input / Output

| Direction | Port(s) |
|-----------|--------|
| Input | `Input` |
| Output | `Output`, `Error` |

## Credentials

This tool does not require any credentials.

### Resources

| Resource | Value |
|----------|-------|
| Coin | `coin` |
| Event | `event` |

### Operations

Each resource has its own Operation list. Pick the resource first, then the operation.

| Resource | Operation | Value | Description |
|----------|-----------|-------|-------------|
| Coin | Candlestick | `candlestick` | Get a candlestick open-high-low-close chart for the selected currency |
| Coin | Get | `get` | Get current data for a coin |
| Coin | Get Many | `getAll` | Get many coins |
| Coin | History | `history` | Get historical data (name, price, market, stats) at a given date for a coin |
| Coin | Market | `market` | Get prices and market related data for all trading pairs that match the selected currency |
| Coin | Market Chart | `marketChart` | Get historical market data including price, market cap, and 24h volume |
| Coin | Price | `price` | Get the current price of any cryptocurrencies in any other supported currencies |
| Coin | Ticker | `ticker` | Get coin tickers |
| Event | Get Many | `getAll` | Get many events |

### Parameters

Coin IDs are CoinGecko's own slugs (`bitcoin`, `ethereum`, `solana`) — the value in the coin's page URL, not the ticker symbol. Every identifier and currency field accepts expressions, so you can feed them from an upstream item.

#### Coin: Candlestick

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Base Currency | `string` | Yes | — | The CoinGecko coin ID for the base currency. The first currency in the pair (e.g., for BTC:ETH, this is bitcoin). |
| Quote Currency | `string` | Yes | — | The target currency code (e.g., usd, eur, btc). Full list available at GET /simple/supported_vs_currencies. |
| Range (Days) | `options` | Yes | `1` | Return data for this many days in the past from now. |
| | | | | Options: `1`, `7`, `14`, `30`, `90`, `180`, `365`, `max` |

#### Coin: Get

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Search By | `options` | Yes | `coinId` | Search by coin ID or contract address. |
| | | | | Options: `coinId`, `contractAddress` |
| Coin ID | `string` | Yes | — | The CoinGecko coin ID. Find at https://www.coingecko.com/ — the ID is in the URL (e.g., bitcoin, ethereum, solana). _(shown when Search By is `coinId`)_ |
| Platform ID | `options` | Yes | `ethereum` | The ID of the platform issuing tokens. _(shown when Search By is `contractAddress`)_ |
| | | | | Options: `ethereum` |
| Contract Address | `string` | Yes | — | Token's contract address. _(shown when Search By is `contractAddress`)_ |
| Options | `collection` | No | `{}` | Extra response sections to request. Anything you leave out is requested as `false`. |
| — Community Data (`community_data`) | `boolean` | No | `false` | Whether to include community data. |
| — Developer Data (`developer_data`) | `boolean` | No | `false` | Whether to include developer data. |
| — Localization (`localization`) | `boolean` | No | `false` | Whether to include all localized languages in response. |
| — Market Data (`market_data`) | `boolean` | No | `false` | Whether to include market data. |
| — Sparkline (`sparkline`) | `boolean` | No | `false` | Whether to include sparkline 7 days data. |
| — Tickers (`tickers`) | `boolean` | No | `false` | Whether to include tickers data. |

#### Coin: Get Many

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Return All | `boolean` | No | `false` | Whether to return all results or only up to a given limit. |
| Limit | `number` | No | `100` | Max number of results to return (1–500). _(shown when Return All is `false`)_ |

#### Coin: History

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Coin ID | `string` | Yes | — | The CoinGecko coin ID. Find at https://www.coingecko.com/ — the ID is in the URL (e.g., bitcoin, ethereum, solana). |
| Date | `string` | Yes | — | The date of the data snapshot (ISO 8601 format). Will be converted to DD-MM-YYYY for the API. |
| Options | `collection` | No | `{}` | Extra request options. |
| — Localization (`localization`) | `boolean` | No | `true` | Whether to include localized languages in response. |

#### Coin: Market

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Base Currency | `string` | Yes | — | The target currency code (e.g., usd, eur, btc). Full list available at GET /simple/supported_vs_currencies. |
| Return All | `boolean` | No | `false` | Whether to return all results or only up to a given limit. |
| Limit | `number` | No | `100` | Max number of results to return (1–500). _(shown when Return All is `false`)_ |
| Options | `collection` | No | `{}` | Extra filters and sorting for the market listing. |
| — Coin IDs (`ids`) | `string` | No | — | Filter results by comma-separated list of coin IDs. |
| — Category (`category`) | `options` | No | `decentralized_finance_defi` | Filter by coin category. |
| | | | | Options: `decentralized_finance_defi` |
| — Order (`order`) | `options` | No | — | Sort results by field. |
| | | | | Options: `gecko_asc`, `gecko_desc`, `id_asc`, `id_desc`, `market_cap_asc`, `market_cap_desc`, `volume_asc`, `volume_desc` |
| — Sparkline (`sparkline`) | `boolean` | No | `false` | Whether to include sparkline 7 days data. |
| — Price Change Percentage (`price_change_percentage`) | `multiOptions` | No | `[]` | Include price change percentage for specified time periods. |
| | | | | Options: `1h`, `24h`, `7d`, `14d`, `30d`, `200d`, `1y` |

#### Coin: Market Chart

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Search By | `options` | Yes | `coinId` | Search by coin ID or contract address. |
| | | | | Options: `coinId`, `contractAddress` |
| Base Currency | `string` | Yes | — | The CoinGecko coin ID for the base currency. _(shown when Search By is `coinId`)_ |
| Platform ID | `options` | Yes | `ethereum` | The ID of the platform issuing tokens. _(shown when Search By is `contractAddress`)_ |
| | | | | Options: `ethereum` |
| Contract Address | `string` | Yes | — | Token's contract address. _(shown when Search By is `contractAddress`)_ |
| Quote Currency | `string` | Yes | — | The target currency code (e.g., usd, eur, btc). Full list available at GET /simple/supported_vs_currencies. |
| Range (Days) | `options` | Yes | `1` | Return data for this many days in the past from now. |
| | | | | Options: `1`, `7`, `14`, `30`, `90`, `180`, `365`, `max` |

#### Coin: Price

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Search By | `options` | Yes | `coinId` | Search by coin ID or contract address. |
| | | | | Options: `coinId`, `contractAddress` |
| Base Currencies | `string` | Yes | — | Comma-separated CoinGecko coin IDs (e.g., bitcoin,ethereum,solana). _(shown when Search By is `coinId`)_ |
| Platform ID | `options` | Yes | `ethereum` | The ID of the platform issuing tokens. _(shown when Search By is `contractAddress`)_ |
| | | | | Options: `ethereum` |
| Contract Addresses | `string` | Yes | — | The contract addresses of tokens, comma-separated. _(shown when Search By is `contractAddress`)_ |
| Quote Currencies | `string` | Yes | — | Comma-separated target currency codes (e.g., usd,eur,btc). Full list available at GET /simple/supported_vs_currencies. |
| Options | `collection` | No | `{}` | Extra values to include alongside each price. |
| — Include 24hr Change (`include_24hr_change`) | `boolean` | No | `false` | Include the 24-hour price change. |
| — Include 24hr Vol (`include_24hr_vol`) | `boolean` | No | `false` | Include the 24-hour trading volume. |
| — Include Last Updated At (`include_last_updated_at`) | `boolean` | No | `false` | Include the last-updated timestamp. |
| — Include Market Cap (`include_market_cap`) | `boolean` | No | `false` | Include the market capitalization. |

#### Coin: Ticker

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Coin ID | `string` | Yes | — | The CoinGecko coin ID. Find at https://www.coingecko.com/ — the ID is in the URL (e.g., bitcoin, ethereum, solana). |
| Return All | `boolean` | No | `false` | Whether to return all results or only up to a given limit. |
| Limit | `number` | No | `100` | Max number of results to return (1–500). _(shown when Return All is `false`)_ |
| Options | `collection` | No | `{}` | Extra filters and sorting for the ticker list. |
| — Exchange IDs (`exchange_ids`) | `string` | No | — | Comma-separated exchange IDs to filter by. Find exchange IDs at https://www.coingecko.com/en/exchanges. |
| — Include Exchange Logo (`include_exchange_logo`) | `boolean` | No | `false` | Include each exchange's logo URL. |
| — Order (`order`) | `options` | No | `trust_score_desc` | Sort results by the selected rule. |
| | | | | Options: `trust_score_desc`, `trust_score_asc`, `volume_desc` |

#### Event: Get Many

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Return All | `boolean` | No | `false` | Whether to return all results or only up to a given limit. |
| Limit | `number` | No | `100` | Max number of results to return (1–500). _(shown when Return All is `false`)_ |
| Options | `collection` | No | `{}` | Filters for the event listing. |
| — Country Code (`country_code`) | `string` | No | — | Country code to filter events. Find codes at GET /events/countries. |
| — From Date (`from_date`) | `string` | No | — | List events after this date (ISO 8601 format). |
| — To Date (`to_date`) | `string` | No | — | List events before this date (ISO 8601 format). |
| — Type (`type`) | `string` | No | — | Type of event to filter by. Find types at GET /events/types. |
| — Upcoming Events Only (`upcoming_events_only`) | `boolean` | No | `true` | Whether to list only upcoming events. |

#### All Operations

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Max Concurrency | `number` | No | `10` | Maximum number of items to process concurrently (1–100). |

## Output Data

Every operation **merges its result onto the input item's JSON** — the fields the item already carried survive, and a result field with the same name overwrites the item's value. Binary data on the input item is forwarded unchanged.

Most operations **fan out: one output item per record returned**, so a single input item can produce hundreds of output items:

| Operation | Output |
|-----------|--------|
| Get, Price, History | One output item — the API's response object merged onto the item. Price returns one object keyed by coin (or contract address), not one item per coin. |
| Get Many, Market, Ticker | One output item per coin or ticker returned. |
| Market Chart | One output item per data point, reshaped to `time` (ISO 8601), `price`, `marketCaps`, `totalVolume`. |
| Candlestick | One output item per candle, reshaped to `time` (ISO 8601), `open`, `high`, `low`, `close`. |
| Event Get Many | One output item per event. |

When a request returns nothing at all, the input item is still passed through unchanged — so an empty result is an item with no new fields on it, not a missing item. Check for the field you expect before using it downstream.

## Usage Examples

- Get the current price of Bitcoin in USD
- List top 10 cryptocurrencies by market cap
- Get OHLC candlestick data for Ethereum over 30 days
- Get exchange ticker data for Bitcoin
- Get historical snapshot of a coin at a specific date
- List upcoming cryptocurrency events
- Get market chart data for a token by contract address

## Example Configuration

Look up several coins in several currencies at once:

```json
{
  "type": "coingecko",
  "parameters": {
    "resource": "coin",
    "operation": "price",
    "searchBy": "coinId",
    "baseCurrencies": "bitcoin,ethereum",
    "quoteCurrencies": "usd,eur",
    "options": {
      "include_24hr_change": true,
      "include_market_cap": true
    }
  }
}
```

Get full current data for one coin, including market metrics:

```json
{
  "type": "coingecko",
  "parameters": {
    "resource": "coin",
    "operation": "get",
    "searchBy": "coinId",
    "coinId": "{{ $json.coin }}",
    "options": {
      "market_data": true,
      "community_data": false,
      "developer_data": false,
      "localization": false,
      "sparkline": true,
      "tickers": false
    }
  }
}
```

Price a token by its Ethereum contract address:

```json
{
  "type": "coingecko",
  "parameters": {
    "resource": "coin",
    "operation": "price",
    "searchBy": "contractAddress",
    "platformId": "ethereum",
    "contractAddresses": "{{ $json.tokenAddress }}",
    "quoteCurrencies": "usd,eur",
    "options": {
      "include_24hr_change": true,
      "include_24hr_vol": true,
      "include_last_updated_at": true
    }
  }
}
```

Pull a month of price history as one item per data point:

```json
{
  "type": "coingecko",
  "parameters": {
    "resource": "coin",
    "operation": "marketChart",
    "searchBy": "coinId",
    "baseCurrency": "ethereum",
    "quoteCurrency": "usd",
    "days": "30"
  }
}
```

Get a week of daily candles:

```json
{
  "type": "coingecko",
  "parameters": {
    "resource": "coin",
    "operation": "candlestick",
    "baseCurrency": "bitcoin",
    "quoteCurrency": "usd",
    "days": "7"
  }
}
```

Take a historical snapshot of a coin on a fixed date:

```json
{
  "type": "coingecko",
  "parameters": {
    "resource": "coin",
    "operation": "history",
    "coinId": "bitcoin",
    "date": "2026-01-15T00:00:00Z",
    "options": {
      "localization": false
    }
  }
}
```

List the top 50 DeFi coins by market cap:

```json
{
  "type": "coingecko",
  "parameters": {
    "resource": "coin",
    "operation": "market",
    "baseCurrency": "usd",
    "returnAll": false,
    "limit": 50,
    "options": {
      "category": "decentralized_finance_defi",
      "order": "market_cap_desc",
      "sparkline": true,
      "price_change_percentage": ["24h", "7d"]
    }
  }
}
```

List upcoming crypto conferences in one country:

```json
{
  "type": "coingecko",
  "parameters": {
    "resource": "event",
    "operation": "getAll",
    "returnAll": false,
    "limit": 10,
    "options": {
      "country_code": "US",
      "type": "Conference",
      "upcoming_events_only": true
    }
  }
}
```

### Error Handling

| Mode | Behavior |
|------|----------|
| **stop** | Halts workflow on first error |
| **continue** | Skips failed items, passes successful ones through |
| **errorPort** | Routes failed items to Error output port |

## Tips

Retrieve cryptocurrency prices, market data, OHLC charts, tickers, and events from the CoinGecko public API — no authentication required.

- **Search By decides which identifier you fill in.** With `coinId` you supply CoinGecko slugs; with `contractAddress` you supply Platform ID plus the token address. Filling the other one has no effect.
- **Return All really does page through everything.** On Get Many, Market, Ticker and Events it keeps requesting pages until the API stops returning results, which can be a lot of items and a lot of requests. Leave it off and set Limit when you only need a slice.
- **The public API is rate limited.** Lower Max Concurrency if a large batch starts returning errors, and prefer one request that names several coins (Price accepts comma-separated lists) over one node run per coin.
- **Resource and Operation are fixed at design time.** Unlike the other fields they do not accept expressions, so build separate branches rather than switching operation per item.