# CoinGecko Coins

CoinGecko is one of the largest cryptocurrency data aggregators, tracking prices, market caps, trading volumes, and historical data for thousands of coins. With the CoinGecko Coins source in Coupler.io, you can pull market chart data and historical snapshots directly into your preferred destination for analysis, reporting, or AI-powered workflows.

## Why connect CoinGecko Coins to Coupler.io?

* **Automate crypto reporting** — pull live and historical price data into Google Sheets, Excel, or BigQuery without manual exports
* **Track multiple coins** — create separate sources for Bitcoin, Ethereum, or any other coin and append them into a single dataset
* **Feed AI tools** — send price trends and market data to ChatGPT, Claude, Gemini, or other AI destinations for analysis and summaries
* **Combine with other sources** — join crypto data with your financial or business data using Coupler.io's built-in transformations

## Prerequisites

* A CoinGecko account with an active API key (available from the [CoinGecko Developer Dashboard](https://www.coingecko.com/en/developers/dashboard))
* The CoinGecko coin ID for the coin(s) you want to track — you can look these up via the [CoinGecko coins list endpoint](https://api.coingecko.com/api/v3/coins/list)
* A Coupler.io account

## Quick start

{% hint style="success" %}
If you want to track multiple coins, set up one source per coin and use the **Append** transformation in your data flow to combine them into one unified dataset.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Create a new data flow in Coupler.io.** From your Coupler.io dashboard, click **Add data flow**, then search for and select **CoinGecko Coins** as your source.
{% endstep %}

{% step %}
**Enter your CoinGecko API key.** Paste your API key from the CoinGecko Developer Dashboard into the API key field. This authenticates Coupler.io to fetch data on your behalf.
{% endstep %}

{% step %}
**Configure your source parameters.** Fill in the required fields:

* **Coin ID** — the CoinGecko identifier for your coin (e.g. `bitcoin`, `ethereum`)
* **Currency** — the target currency for market data (e.g. `usd`, `eur`, `jpy`)
* **Entity** — choose **Market charts** for time-series data or **Histories** for point-in-time historical data
* For **Market charts**: select the number of **Days** to include (1, 7, 14, 30, 90, 180, 365, or max)
* For **Histories**: use the date picker to set a **Start date** and **End date**
  {% endstep %}

{% step %}
**Choose your destination.** Select where you want your data to land — Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like ChatGPT, Claude, Gemini, Perplexity, Cursor, or OpenClaw.
{% endstep %}

{% step %}
**Run your data flow.** Click **Run** to execute a manual run and verify that your data loads correctly.
{% endstep %}
{% endstepper %}

## Entities overview

| Entity        | Description                                                                                  |
| ------------- | -------------------------------------------------------------------------------------------- |
| Market charts | Time-series data for prices, market caps, and trading volumes over a selected number of days |
| Histories     | Historical snapshot data for a cryptocurrency on a specific date range                       |