Coin Metrics Market Candles
Definition
Candles consist of summary statistics that describe the trading activity of a market over an interval of time. Coin Metrics engineers six statistics based on trades data that occurred over an interval of time: opening price, high price, low price, close price, volume-weighted average price, and total volume.
Dictionary
| Name | Category | Subcategory | Type | Unit | Interval |
|---|---|---|---|---|---|
| Market candles | Market | Candles | Market data | Price/VWAP: quote asset. Volume: units of base asset | 5 minutes, 10 minutes, 15 minutes, 30 minutes, 1 hour, 4 hours, 1 day |
Markets can be categorized in spots or derivatives markets. Currently the market types available are ‘spot’ and ‘future’.
A spot market represents a trading pair in which the buyer exchanges units of one asset in return for units of another asset in amounts specified by the market’s price or exchange rate. By convention, the exchange rate consists of a base asset and a quote asset and represents the number of units of the quote asset needed to buy one unit of the base asset. Cryptoassets and fiat currencies can serve as either base or quote assets, depending on the market.
A derivatives market represents a venue where contracts of a financial derivative are bought and sold. Instead of an exchange rate, the price of a derivative represents the price of one contract. Each financial derivatives contract has unique contract specifications which describe how the contract is quoted and the amount of notional exposure that a contract represents.
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.
The volume-weighted average price (VWAP) is the average price of an asset over an interval weighted by volume.
An sample of the candles data from Coinbase’s Bitcoin-US Dollar Spot Market is provided below:
market: The IDs of the market. Market IDs use the following naming convention: exchangeName-baseAsset-quoteAsset-spot for spot markets and exchangeName-futuresSymbol-future for futures markets.
time: The exchange-reported time in ISO 8601 date-time format.
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.
Resource history
Release Version: CM MDF v1.0 (April 2019) - initial version
Release Version: CM MDF v2.0 (Dec 9, 2019) - candles for futures instruments for BitMEX and Huobi, candles for all spot pairs traded on Binance US
Release Version: CM MDF v2.1 (May 5, 2020) - candles for spot markets from Kucoin and FTX, trades for futures markets from Deribit, OKex, Binance, FTX and BItfinex
Availability
Community and pro market availability does not differ. However, only daily candles are available for the community. Community data is available via the HTTP API only and is limited to 1,000 API requests per 10 minutes per IP address.
For a full list of assets, exchanges, spot markets, and futures markets, please consult the Coin Metrics Data Coverage file or the ‘/catalog-all/markets’ via the API.
Markets
| Type of market | Number of markets |
|---|---|
| Spot Markets | 21231 |
| Futures Markets | 6649 |
Assets
| Asset | Number of markets spot | Number of markets futures |
|---|---|---|
| 1inch | 16 | 6 |
| aave | 49 | 8 |
| abbc | 4 | 0 |
| abt | 14 | 0 |
| ada | 62 | 108 |
| adx | 15 | 0 |
| ae | 18 | 0 |
| agi | 9 | 0 |
| aion | 10 | 0 |
| akro | 18 | 3 |
| algo | 42 | 10 |
| alpha | 13 | 2 |
| amb | 10 | 0 |
| ampl | 9 | 2 |
| ankr | 18 | 2 |
| ant | 24 | 2 |
| aoa | 4 | 0 |
| appc | 8 | 0 |
| ar | 5 | 1 |
| ardr | 13 | 0 |
| ark | 7 | 0 |
| ast | 12 | 0 |
| atom | 57 | 10 |
| ava | 15 | 0 |
| avax | 19 | 9 |
| badger | 12 | 3 |
| bal | 35 | 9 |
| band | 31 | 5 |
| bat | 54 | 5 |
| bcd | 15 | 0 |
| bch | 123 | 189 |
| bcn | 12 | 0 |
| bcpt | 13 | 0 |
| beam | 6 | 0 |
| bft | 9 | 0 |
| bht | 3 | 0 |
| bix | 22 | 0 |
| blz | 11 | 2 |
| bnb | 232 | 13 |
| bnb_mainnet | 0 | 0 |
| bnt | 30 | 3 |
| boa | 3 | 0 |
| bsv | 45 | 159 |
| btc | 3320 | 881 |
| btg | 18 | 0 |
| btm | 25 | 2 |
| bts | 20 | 2 |
| btt | 41 | 2 |
| busd | 189 | 1 |
| bzrx | 8 | 1 |
| cdt | 10 | 0 |
| cel | 9 | 1 |
| celo | 14 | 0 |
| celr | 6 | 0 |
| cennz | 5 | 0 |
| chat | 12 | 0 |
| chsb | 4 | 0 |
| chz | 27 | 6 |
| ckb | 16 | 0 |
| cmct | 8 | 0 |
| cmt | 12 | 0 |
| cnd | 10 | 0 |
| cnn | 4 | 0 |
| comp | 37 | 9 |
| cpay | 1 | 0 |
| cro | 24 | 0 |
| crpt | 7 | 0 |
| crv | 30 | 6 |
| csp | 2 | 0 |
| ctc | 3 | 0 |
| ctxc | 12 | 0 |
| cvc | 23 | 3 |
| cvt | 8 | 0 |
| dai | 70 | 0 |
| dash | 66 | 12 |
| data | 9 | 0 |
| dbc | 9 | 0 |
| dcr | 24 | 0 |
| dent | 13 | 0 |
| dgb | 28 | 0 |
| dgd | 11 | 0 |
| dgtx | 5 | 0 |
| dgx | 2 | 0 |
| dia | 13 | 0 |
| dmg | 7 | 3 |
| dnt | 9 | 0 |
| dock | 10 | 0 |
| doge | 51 | 12 |
| dot | 53 | 145 |
| drgn | 10 | 5 |
| dta | 8 | 0 |
| dx | 4 | 0 |
| egld | 15 | 4 |
| ela | 10 | 0 |
| elf | 23 | 0 |
| eng | 9 | 0 |
| enj | 30 | 2 |
| eos | 93 | 182 |
| eos_eth | 0 | 0 |
| etc | 63 | 163 |
| eth | 2154 | 281 |
| ethos | 6 | 0 |
| etn | 12 | 0 |
| etp | 6 | 0 |
| eurs | 19 | 0 |
| evx | 7 | 0 |
| ewt | 12 | 0 |
| fct | 5 | 3 |
| fet | 11 | 0 |
| fil | 35 | 48 |
| foam | 2 | 0 |
| ftm | 20 | 2 |
| ftt | 15 | 1 |
| fun | 17 | 0 |
| fxc | 4 | 0 |
| gas | 21 | 0 |
| glm | 21 | 0 |
| gno | 12 | 1 |
| gnt | 31 | 0 |
| go | 8 | 0 |
| grin | 19 | 0 |
| grs | 8 | 0 |
| grt | 35 | 8 |
| gt | 7 | 0 |
| gtc_gamecom | 7 | 0 |
| gusd | 21 | 0 |
| gxs | 9 | 1 |
| hbar | 23 | 1 |
| hbtc | 0 | 0 |
| hc_hypercash | 12 | 0 |
| hedg | 3 | 0 |
| hive | 12 | 0 |
| hns | 6 | 0 |
| hnt | 6 | 4 |
| hot_holo | 5 | 0 |
| hpt | 3 | 0 |
| ht | 67 | 3 |
| husd | 54 | 0 |
| hxro | 4 | 0 |
| icx | 26 | 1 |
| ignis | 5 | 0 |
| iht | 8 | 0 |
| inj | 14 | 0 |
| iost | 26 | 5 |
| iotx | 13 | 0 |
| iris | 14 | 0 |
| itc | 11 | 0 |
| jst | 22 | 2 |
| kan | 11 | 0 |
| kava | 17 | 3 |
| kcs | 32 | 0 |
| keep | 5 | 0 |
| key | 12 | 0 |
| kin | 4 | 1 |
| kmd | 16 | 0 |
| knc | 50 | 7 |
| kp3r | 8 | 0 |
| ksm | 27 | 5 |
| lamb | 16 | 0 |
| lba | 14 | 0 |
| lbc | 7 | 0 |
| lend | 25 | 8 |
| leo | 15 | 2 |
| leo_eos | 0 | 0 |
| leo_eth | 0 | 0 |
| link | 72 | 165 |
| loki | 5 | 0 |
| loom | 20 | 0 |
| lpt | 4 | 0 |
| lrc | 29 | 4 |
| lsk | 26 | 1 |
| ltc | 110 | 193 |
| lto | 2 | 0 |
| lun | 9 | 0 |
| luna | 20 | 4 |
| lym | 11 | 0 |
| maid | 6 | 0 |
| mana | 43 | 3 |
| matic | 26 | 5 |
| mco | 27 | 0 |
| mda | 7 | 0 |
| meta | 4 | 0 |
| mft | 9 | 0 |
| miota | 27 | 6 |
| mith | 22 | 0 |
| mkr | 49 | 6 |
| mln | 14 | 0 |
| mof | 6 | 0 |
| mona | 4 | 0 |
| mta | 11 | 3 |
| mtl_metal | 13 | 0 |
| mx | 4 | 0 |
| mxc | 9 | 0 |
| nano | 25 | 0 |
| nas | 14 | 0 |
| nav | 8 | 0 |
| ncash | 10 | 0 |
| near | 15 | 5 |
| neo | 69 | 9 |
| nexo | 6 | 0 |
| nim | 5 | 0 |
| nmr | 16 | 0 |
| noia | 2 | 0 |
| npxs | 17 | 0 |
| nrg | 3 | 0 |
| nu | 10 | 0 |
| nuls | 14 | 0 |
| nxm | 0 | 0 |
| nxt | 11 | 0 |
| oax | 10 | 0 |
| ocean | 16 | 1 |
| ocn | 16 | 0 |
| octo | 2 | 0 |
| ogn | 11 | 0 |
| okb | 27 | 5 |
| omg | 60 | 8 |
| one_harmony | 10 | 0 |
| ong_ontologygas | 13 | 0 |
| ont | 42 | 6 |
| orbs | 8 | 0 |
| ost | 10 | 0 |
| oxt | 24 | 0 |
| pai | 8 | 0 |
| pax | 73 | 0 |
| paxg | 17 | 5 |
| pay | 14 | 0 |
| perp | 5 | 1 |
| phx | 9 | 0 |
| pivx | 10 | 0 |
| pnk | 5 | 0 |
| pnt | 9 | 0 |
| poa | 13 | 0 |
| pols | 9 | 0 |
| poly | 16 | 0 |
| powr | 18 | 0 |
| ppt | 8 | 0 |
| pro | 6 | 0 |
| qash | 93 | 0 |
| qkc | 11 | 0 |
| qnt | 5 | 0 |
| qsp | 7 | 0 |
| qtum | 58 | 7 |
| rcn_ripiocreditnetwork | 18 | 0 |
| rdd | 3 | 0 |
| rdn | 13 | 0 |
| ren | 31 | 5 |
| renbtc | 9 | 0 |
| rep | 34 | 1 |
| req | 11 | 0 |
| rev | 9 | 0 |
| rif | 11 | 0 |
| rlc | 13 | 1 |
| rose | 7 | 0 |
| rsr | 20 | 5 |
| rune | 10 | 4 |
| rvn | 17 | 2 |
| sai | 38 | 0 |
| sc | 28 | 0 |
| scrt | 2 | 0 |
| seele | 5 | 0 |
| shr | 6 | 0 |
| sngls | 6 | 0 |
| snt | 31 | 1 |
| snx | 44 | 5 |
| sol | 19 | 8 |
| solve | 8 | 0 |
| srm | 15 | 3 |
| srn | 10 | 0 |
| steem | 16 | 0 |
| storj | 31 | 3 |
| strat | 15 | 0 |
| stx | 10 | 0 |
| susd | 6 | 0 |
| sushi | 31 | 10 |
| swap | 4 | 0 |
| swrv | 14 | 2 |
| sxp | 23 | 6 |
| sys | 7 | 0 |
| tel | 7 | 0 |
| tfuel | 9 | 0 |
| theta | 17 | 10 |
| tmtg | 4 | 0 |
| tnb | 9 | 0 |
| tnt | 9 | 0 |
| tomo | 15 | 4 |
| trac | 8 | 0 |
| trb | 13 | 3 |
| trx | 106 | 176 |
| trx_eth | 0 | 0 |
| tt | 5 | 0 |
| tusd | 75 | 0 |
| ubt | 6 | 0 |
| uma | 26 | 2 |
| uni | 46 | 12 |
| uos | 6 | 0 |
| uqc | 4 | 0 |
| usdc | 136 | 0 |
| usdk | 31 | 0 |
| usdt | 2797 | 727 |
| usdt_eth | 2 | 0 |
| usdt_trx | 0 | 0 |
| ust | 13 | 0 |
| utk | 19 | 0 |
| vet | 34 | 5 |
| via | 6 | 0 |
| vib | 11 | 0 |
| vlx | 4 | 0 |
| vsys | 15 | 0 |
| vtc | 4 | 0 |
| vtho | 10 | 0 |
| wan | 8 | 0 |
| waves | 34 | 7 |
| waxp | 19 | 0 |
| wbtc | 22 | 0 |
| weth | 1 | 0 |
| wicc | 8 | 0 |
| wnxm | 12 | 2 |
| wpr | 7 | 0 |
| wrx | 11 | 0 |
| wtc | 15 | 0 |
| wxt | 9 | 0 |
| xaut | 5 | 6 |
| xem | 30 | 2 |
| xhv | 4 | 0 |
| xlm | 72 | 10 |
| xmr | 51 | 12 |
| xns | 4 | 0 |
| xrp | 119 | 190 |
| xtz | 54 | 14 |
| xvg | 21 | 0 |
| xvs | 6 | 0 |
| xyo | 3 | 0 |
| xzc | 14 | 0 |
| yamv2 | 6 | 0 |
| yfi | 38 | 12 |
| yfii | 19 | 6 |
| yoyow | 8 | 0 |
| zb | 6 | 0 |
| zec | 65 | 13 |
| zen | 20 | 3 |
| zil | 30 | 4 |
| zrx | 55 | 4 |
Exchanges
| Exchange | Number of markets spot | Number of markets futures |
|---|---|---|
| bibox | 202 | 0 |
| binance | 1290 | 160 |
| binance.us | 108 | 0 |
| bitbank | 11 | 0 |
| bitfinex | 466 | 23 |
| bitflyer | 6 | 37 |
| bithumb | 91 | 0 |
| bitmex | 0 | 270 |
| bitstamp | 46 | 0 |
| bittrex | 798 | 0 |
| bybit | 0 | 10 |
| cex.io | 199 | 0 |
| coinbase | 145 | 0 |
| deribit | 0 | 63 |
| ftx | 391 | 912 |
| gate.io | 997 | 0 |
| gatecoin | 80 | 0 |
| gemini | 51 | 0 |
| hitbtc | 1300 | 0 |
| huobi | 883 | 1855 |
| itbit | 9 | 0 |
| kraken | 299 | 49 |
| kucoin | 643 | 0 |
| lbank | 334 | 0 |
| liquid | 435 | 0 |
| lmax | 16 | 0 |
| localbitcoins | 112 | 0 |
| mt.gox | 16 | 0 |
| okex | 583 | 1215 |
| poloniex | 370 | 0 |
| therocktrading | 24 | 0 |
| upbit | 434 | 0 |
| zb.com | 277 | 0 |