CoinGecko integration

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.

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: 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	{}
				Options: decentralized_finance_defi, gecko_asc, 1h, trust_score_desc
— Community Data	boolean	No	false	Whether to include community data.
— Developer Data	boolean	No	false	Whether to include developer data.
— Localization	boolean	No	false	Whether to include all localized languages in response.
— Market Data	boolean	No	false	Whether to include market data.
— Sparkline	boolean	No	false	Whether to include sparkline 7 days data.
— 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. (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	{}
				Options: decentralized_finance_defi, gecko_asc, 1h, trust_score_desc
— 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. (shown when Return All is false)
Options	collection	No	{}
				Options: decentralized_finance_defi, gecko_asc, 1h, trust_score_desc
— Coin IDs	string	No	—	Filter results by comma-separated list of coin IDs.
— Category	options	No	decentralized_finance_defi	Filter by coin category.
				Options: decentralized_finance_defi
— 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	boolean	No	false	Whether to include sparkline 7 days data.
— 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	{}
				Options: decentralized_finance_defi, gecko_asc, 1h, trust_score_desc
— Include 24hr Change	boolean	No	false
— Include 24hr Vol	boolean	No	false
— Include Last Updated At	boolean	No	false
— Include Market Cap	boolean	No	false

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. (shown when Return All is false)
Options	collection	No	{}
				Options: decentralized_finance_defi, gecko_asc, 1h, trust_score_desc
— Exchange IDs	string	No	—	Comma-separated exchange IDs to filter by. Find exchange IDs at https://www.coingecko.com/en/exchanges.
— Include Exchange Logo	boolean	No	false
— 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. (shown when Return All is false)
Options	collection	No	{}
				Options: decentralized_finance_defi, gecko_asc, 1h, trust_score_desc
— Country Code	string	No	—	Country code to filter events. Find codes at GET /events/countries.
— From Date	string	No	—	List events after this date (ISO 8601 format).
— To Date	string	No	—	List events before this date (ISO 8601 format).
— Type	string	No	—	Type of event to filter by. Find types at GET /events/types.
— 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.

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.

Example Configuration

Look up several coins in several currencies at once:

{
  "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:

{
  "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:

{
  "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:

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

Get a week of daily candles:

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

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

{
  "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:

{
  "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:

{
  "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

This tool retrieves cryptocurrency prices, market data, OHLC charts, tickers, and events from CoinGecko. It is ideal for current and historical data on coins and related events, offering more detailed market insights than a simple price lookup. It produces current and historical cryptocurrency prices, market capitalization, trading volumes, candlestick charts, exchange tickers, and event listings.

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