# 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                                       |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coupler.io/sources/category/finance-and-accounting/coin-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.