# Coin API

Coin API is a financial data provider that delivers historical and real-time cryptocurrency market data — including price candles, individual trades, and bid/ask quotes — across thousands of trading pairs and exchanges. Connect it to Coupler.io to pull structured crypto market data directly into your analytics tools or AI assistants without writing a single line of code.

## Why connect Coin API to Coupler.io?

* **Centralize crypto market data** — pull OHLCV candles, raw trades, and quote data into one place for unified analysis
* **Automate historical pulls** — schedule recurring data flows to keep your dashboards and models up to date
* **Combine multiple symbols or entities** — use Append or Join transformations to analyze several trading pairs side by side
* **Send data to AI tools** — pipe market data directly into ChatGPT, Claude, Gemini, or Perplexity for pattern analysis and summaries

## Prerequisites

* A Coin API account with an active API key ([get one at coinapi.io](https://www.coinapi.io/))
* The Symbol ID for the trading pair you want to pull data for (e.g., `BITSTAMP_SPOT_BTC_USD`) — find the full list in the [Coin API docs](https://docs.coinapi.io/#list-all-symbols-get)
* A Coupler.io account

## Quick start

{% hint style="success" %}
Start with the **OHLCV Historical Data** entity using a single well-known symbol like `BITSTAMP_SPOT_BTC_USD` to verify your connection before pulling data for multiple pairs.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Create a new data flow in Coupler.io.** Go to your Coupler.io dashboard and click **Add data flow**. Search for **Coin API** and select it as your source.
{% endstep %}

{% step %}
**Enter your Coin API key.** Paste your API key into the authentication field. You can find or generate your key in the [Coin API dashboard](https://www.coinapi.io/dashboard) under your account settings.
{% endstep %}

{% step %}
**Select an entity.** Choose one of the three available entities: OHLCV Historical Data, Trades Historical Data, or Quotes Historical Data.
{% endstep %}

{% step %}
**Configure your parameters.** Enter the Symbol ID for your trading pair, set a time interval (for OHLCV), and use the date pickers to define your start and end dates. Set a record limit if needed (default is 100, max is 100,000).
{% endstep %}

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

{% step %}
**Run the data flow.** Click **Run** to execute a manual run and confirm that data loads correctly before setting up a schedule.
{% endstep %}
{% endstepper %}

## Available entities

| Entity                 | Description                                                                               |
| ---------------------- | ----------------------------------------------------------------------------------------- |
| OHLCV Historical Data  | Open, High, Low, Close, and Volume candles for a trading pair over a chosen time interval |
| Trades Historical Data | Individual trade transactions with price, volume, and timestamp                           |
| Quotes Historical Data | Historical bid and ask price quotes with timestamps                                       |