# CoinDesk

> Get crypto prices, historical OHLCV, top coin lists, and news with the CoinDesk (CryptoCompare) data API.

Lets an agent pull cryptocurrency market data from CoinDesk Data (formerly CryptoCompare): current prices across many symbols, daily and hourly historical OHLCV, top coin lists by market cap or volume, and the latest crypto news.

This connector uses the stable `min-api.cryptocompare.com` base, which serves the same data that powers CoinDesk Data.

## What it can do

| Method | What it does |
| --- | --- |
| `coindesk_price` | Current prices for multiple coins in multiple currencies. `full=true` adds 24h change, volume, and market cap. |
| `coindesk_historical_daily` | Daily historical OHLCV for a coin/currency pair. |
| `coindesk_historical_hourly` | Hourly historical OHLCV for a coin/currency pair. |
| `coindesk_top_list` | Top coins ranked by market cap (default) or total volume. |
| `coindesk_news` | Latest crypto news articles, optionally filtered by language and categories. |
| `coindesk_request` | Generic passthrough to any endpoint for full coverage. |

## How to get your key

The API authenticates with the `authorization: Apikey <key>` header.

1. Sign in at [CryptoCompare](https://www.cryptocompare.com/) (the CoinDesk Data developer dashboard).
2. Open **API Keys** ([cryptocompare.com/cryptopian/api-keys](https://www.cryptocompare.com/cryptopian/api-keys)).
3. Create a key, or copy an existing one. A free tier is available.
4. Paste it into FlyMyAI.

## Fields to fill

| FlyMyAI field | Where it comes from |
| --- | --- |
| `COINDESK_API_KEY` | CoinDesk Data / CryptoCompare dashboard -> API Keys |

## Troubleshooting

- **`401` / `Response: Error` about the API key** - the key is wrong or missing. Re-copy it from the dashboard API Keys page.
- **`429 Too Many Requests`** - you hit the monthly call limit for your tier. Wait for the reset or upgrade.
- **Unknown coin/currency** - use ticker symbols, e.g. `BTC`, `ETH`, `USD`. The API returns a `Response: Error` body for unrecognised symbols (surfaced as an error).
- **Empty history** - reduce `limit`, or check that the `fsym`/`tsym` pair is actually traded.

## Links

- [CoinDesk Data / CryptoCompare API keys](https://www.cryptocompare.com/cryptopian/api-keys)
- [CoinDesk Data API documentation](https://developers.coindesk.com/documentation/data-api)