Get access
- Go to download.coinmetrics.io, select Log in, and paste your Coin Metrics API key. The portal validates it against the API and keeps it in your browser, so you log in once per browser.
- Check that the selectors list the data you expect. The portal reads entitlements from your key, so the market and asset lists cover only what your license includes.
If a market or asset you expect is missing from the selectors, or you want unthrottled downloads, reach out to your sales or account manager.
Datasets Available
The portal carries fourteen datasets, a subset of what the API serves. Each arrives exactly as the API returns it, so follow a link for field definitions. Eleven cover market data, and the granularity column lists what the portal offers for downsampling.| Dataset | Markets | Granularity |
|---|---|---|
| Trades | spot, future, option | raw |
| Quotes | spot, future, option | raw, 1m, 1h, 1d |
| Candles | spot, future, option | 1m through 1d, chosen as a frequency |
| Order books | spot, future, option | raw, 1m, 1h, 1d |
| Open interest | future | raw, 1m, 1h, 1d |
| Liquidations | future | raw |
| Funding rates | future | raw |
| Predicted funding rates | future | raw |
| Contract prices | option | raw, 1m, 1h, 1d |
| Implied volatility | option | raw, 1m, 1h, 1d |
| Greeks | option | raw, 1m, 1h, 1d |
| Dataset | You supply | Point in the chain |
|---|---|---|
| Account balances | Accounts | A single time, block height, or slot |
| Balance updates | Accounts | A range of dates, heights, or slots |
| Transactions | Transaction IDs | Not applicable |
File formats
JSONL streams straight from the API, so it is the fastest, and it carries every field the endpoint returns. CSV and Parquet are converted in the browser as the stream arrives, which is slower but lets you choose fields, with the required ones selected for you.
Download market data
- Open a dataset from the portal’s landing page.
- Set the start and end date. Both are UTC and default to today.
- Select markets. Where a dataset serves more than one market class, switch between spot, future, and option first. The list offers only markets with data inside your date range, so widen the range if something you expect is missing.
- Set the parameters the dataset exposes. Candles take a frequency. Order books take a depth: 1 for top of book, 100, 10% of mid price, 30000 for the full book, or a custom value between 2 and 29999. Where a granularity selector appears it downsamples to one record per minute, hour, or day, and runs slower than
rawbecause the aggregation happens server-side. - Choose a file format, and for CSV or Parquet select the fields to include.
- Select Preview to check the first three rows, then Download. Parquet has no preview. A JSONL download opens in a new tab and is handed to your browser, which tracks it from there. CSV and Parquet are written by the portal itself, which reports bytes and speed as they run and offers a Cancel button.
Download blockchain account data
The three blockchain datasets run as queued requests rather than direct downloads.- Select an asset.
- Add the accounts or transaction IDs the dataset takes. Enter them one at a time, paste a list, or upload a
.txtor.csvfile whose entries are separated by newlines, commas, semicolons, or tabs, with no header row. - Set the point in the chain, or the range, that the dataset takes.
- Select Submit Download Request. The request appears under Download Requests, where the status refreshes on its own.
- When the status reads Completed, select Download Results. These three datasets deliver line-delimited JSON only.
Automate a download
Once a market data selection is complete, the Automate downloads / API call examples panel renders it as a runnablecurl command and as a Python script. Both write to the same filename the browser download would produce. Copy either one, or save it as a .sh or .py file, and you have a repeatable version of the download you configured by hand. The examples carry YOUR_API_KEY, and a toggle substitutes the real key from your session, so treat anything copied afterward as a secret. The panel appears when the format is JSONL, and it links to the API reference for the endpoint behind your selection.
Limits and notes
- Keep the tab open for CSV and Parquet. Both are converted in the page as the stream arrives, so closing the tab or navigating away ends the download and leaves a partial file. JSONL hands off to the browser instead, and finishes on its own.
- A wide market selection can exceed the request limit. Every selected market goes into the query string, and the API rejects a request whose URI runs past 10,000 characters. That works out to a few hundred markets, and fewer where the identifiers are long, as option market identifiers are. Split a wide selection into several downloads.
- No cap applies to the date range. A longer range simply takes longer, and order book depth drives file size harder than either the range or the market count. If you are unsure of the volume, run a short range first and check the size of the file it produces.
- History depends on the market, not on the portal. Because the market list is filtered to markets with data in your range, an empty list usually means the range predates the market rather than that the dataset is unavailable. The coverage tool is the authoritative source for what exists.
Related
- Python API Client: make the same requests in code, with paging and parallel fetching handled for you.
- Cloud Delivery: scheduled bulk delivery of these datasets to Amazon S3 or Snowflake.
- API Conventions: the parameters, formats, and paging rules the portal is built on.

