Exchange Coverage
Asset Metrics (Time Series)
Exchange Metrics (Time Series)
Exchange-Asset Metrics (Time Series)
Pair Metrics (Time Series)
Institution Metrics (Time Series)
Market Data
Block Explorer (ATLAS)
Charting Tools
Methodologies
Glossary
Market Candles
/timeseries/market-candles
Definition
Candles consist of summary statistics derived from individual trades that describe the trading activity of a market over an interval of time.
Details
Coin Metrics engineers several statistics based on trades data that occurred over an interval of time: opening price, high price, low price, close price, volume-weighted average price, total volume in base asset units, total volume in U.S. dollars, and number of trades in the interval.
Candles are generated at regular time intervals and at a time granularity that is suitable for charting and analysis. For instance, several technical analysis indicators can be calculated using data in candles format.
We produce our candles at
1m, 5m, 10m, 15m, 30m, 1h, 4h, 1d intervals. Our candles are calculated directly from our trades data. We construct gapless candles which means that if there are no trades in a candle interval, we fill forward candles through time, setting the open, high, low, and close to the close of the previous candle, setting the vwap to the vwap of the previous candle, and setting the volume to zero. Coin Metrics calculates candles for spot and future markets from exchanges that are listed on our exchange coverage universe.
Example
An sample of the candles data from the
coinbase-btc-usd-spot market from our /timeseries/market-quotes API endpoint is provided below. 1
{
2
"data": [
3
{
4
"time": "2020-06-08T20:45:00.000000000Z",
5
"market": "coinbase-btc-usd-spot",
6
"price_open": "9705.07999999999993",
7
"price_close": "9705.01000000000022",
8
"price_high": "9706.19000000000051",
9
"price_low": "9705",
10
"vwap": "9705.1686505895068",
11
"volume": "16.8066639099999975",
12
"candle_usd_volume": "16.8066639099999975",
13
"candle_trades_count": "212"
14
},
15
{
16
"time": "2020-06-08T20:50:00.000000000Z",
17
"market": "coinbase-btc-usd-spot",
18
"price_open": "9705",
19
"price_close": "9696.27000000000044",
20
"price_high": "9705",
21
"price_low": "9695.71999999999935",
22
"vwap": "9698.38894423754937",
23
"volume": "14.7672128699999963",
24
"candle_usd_volume": "14.7672128699999963",
25
"candle_trades_count": "215"
26
}
27
]
28
}
Copied!
time: The time of the beginning of the candle interval in ISO 8601 date-time format.market: The id of the market. Market ids use the following naming convention:exchangeName-baseAsset-quoteAsset-spotfor spot markets,exchangeName-futuresSymbol-futurefor futures markets, andexchangeName-optionsSymbol-optionfor options markets.​price_open: The opening price of the candle.price_high: The high price of the candle.price_low: The low price of the candle.price_close: The close price of the candle.vwap: The volume-weighted average price of the candle.volume: The volume of the candle in units of the base asset.candle_usd_volume: The volume of the candle in units of U.S. dollars.candle_trades_count: The number of trades in the candle interval.
Frequently Asked Questions
What is the historical coverage of your candles data?
Our candles history for Bitcoin begins when it began trading on Mt.Gox in July 2010, so we have over 10 years of candles history. We also have full historical candles from several other early exchanges such as Bitstamp, TheRockTrading, Bitfinex, and Kraken.
Our candles are calculated from trades data that we collect. Some exchanges allow users to query all of their historical trades data while other exchanges only allow users to query a short amount of history such as the past 1,000 trades. Coin Metrics always attempts to collect the maximum backhistory possible. If an exchange allows us to query historical trades data, we will collect data from every market starting from the inception of the exchange.
Is there a way to pull data for multiple markets in one API call?
Yes! All of our endpoints that accept the
markets parameter will accept wildcards like exchange-* or exchange-*-spot or *USDT-future. The wildcards will match any market which fits this pattern so users do not need to specify every individual market when querying data for multiple markets. The markets parameter will also accept a comma-separated string of individual markets. When are candles calculated?
Our candle generator waits 20 minutes before calculating a candle to ensure that we are not missing any trades in the candle interval. We are working towards a future upgrade that will reduce this lag. If you require candles with very low delay, we recommend calculating them using our trades data.
How does Coin Metrics ensure high levels of data quality and data integrity?
Please take a look at this question in the Market Data FAQs page linked below.
Why are there some observations where the candle vwap is higher than the high price or lower than the low price?
We construct gapless candles which means that if there are no trades in a candle interval, we fill forward candles through time, setting the open, high, low, and close to the close of the previous candle, setting the vwap to the vwap of the previous candle, and setting the volume to zero. In cases where there are no trades in a candle interval, it is expected that the vwap may be higher than the high price or lower than the low price due to our fill forward logic.
What does the time for each candle observation represent?
Since candles represent a set of summary statistics measured over an interval of time (such as one calendar day), by convention we set the
time field to the beginning of the candle interval.For instance, if the
time for a daily candle is 2022-02-17 00:00:00, this means that the price_open represents the price of the first trade after2022-02-17 00:00:00.000000 while the price_close represents the price of the last trade before 2022-02-17 23:59:59.999999. And the volume represents the sum of the trades amounts from 2022-02-17 00:00:00.00000 to 2022-02-17 23:59:59.999999, inclusive. Here we represent 00:00:00 as the beginning of a calendar day according to the ISO 8601 standard.Known Data Issues
- Candles data is filled forward longer than needed for markets that are delisted. We are working on a future upgrade to our candles that will correct this.
Release History
- CM MDF v1.0 on April 2020: Added candles for all spot markets on major exchanges. CM MDF v2.0 on December 9, 2019: Added candles for spot markets on Binance.US. Added candles for futures markets on BitMEX and Huobi.
- ​CM MDF v2.1 on May 5, 2020: Added candles for spot markets on Kucoin and FTX. Added candles for futures markets on Deribit, OKEx, Binance, FTX, and Bitfinex.
- ​CM MDF v2.3 on April 25, 2021: Added candles for spot markets on LMAX. Added candles for futures markets on CME and Bybit.
Availability
The previous 24 hours of trades data is available through our community API. Community data is available via HTTP API only and is limited to 1,000 API requests per 10 minutes per IP address. All of our trades data is available through our professional API with higher rate limits. The professional API supports trades data through both our HTTP API and websocket API.
Our coverage can be found by querying our
/catalog/markets or /catalog-all/markets API endpoints. Alternatively, you can query our /catalog/exchangesor /catalog-all/exchanges API endpoints which contain the same information but organized by exchange. Availability by Market Type
Type
Market Count
Spot
13440
Futures
6874
Availability by Exchange
Exchange
Spot Market Count
Future Market Count
Start Date
Bibox
202
​
2019-04-24
Binance
1580
220
2017-07-14
Binance.US
119
​
2019-09-23
Bitbank
11
​
2017-02-14
Bitfinex
533
35
2013-01-14
bitFlyer
9
64
2019-05-28
Bithumb
91
​
2013-12-27
BitMEX
​
302
2014-11-22
Bitstamp
108
​
2011-08-18
Bittrex
1068
​
2019-03-21
Bybit
​
31
2019-10-01
Cex.IO
240
​
2013-12-27
CME
​
252
2017-12-17
Coinbase
304
​
2014-12-01
Deribit
​
121
2017-01-06
FTX
440
1189
2019-03-05
Gate.io
1603
​
2017-09-29
Gatecoin
80
​
2014-11-11
Gemini
78
​
2018-10-16
Last modified 3mo ago