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:

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

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.