v1

latestOpenAPI 3.0.02026-07-2224101.3 MB
BTC Market Data

Price OHLCV

This endpoint returns metrics related to BTC price. We provide two types of price, CryptoQuant's BTC Index Price and USD or USDT price of BTC of global exchanges.

Price OHLCV data consists of five metrics.  open, the opening price at the beginning of the window, close, USD closing price at the end of the window,  high, the highest USD price in a given window, low, the lowest USD price in a given window, and volume, the total volume traded in a given window.

At this endpoint, metrics are calculated by Minute, Hour and Day.

BTC Index Price is calculated by taking VWAP(Volume Weighted Average Price) of BTC price data aggregated from all exchanges we provide. The exchanges we provide are as follows.

<br>

Supported Exchanges By Market

NameMarketSupported Exchanges
SpotspotAll Exchange*, Binance, Binance US, Bitfinex, Bittrex, Coinbase Advanced, FTX**, Gemini, HTX Global, Kraken, OKX
PerpetualperpetualAll Exchange*, Binance, Bitmex, Bybit, Deribit, FTX**, HTX Global, OKX

(*) Default exchange <br> (**) Use in cautions due to the deprecation (no data update)

In order to get USD or USDT price of BTC of specific exchange from above (eg. btcusdt pair of binance), you must specify market, exchange and symbol of BTC pair.

For volume metric, the unit of volume could be USD, USDT or BTC. This is because exchanges have their own price data policy. All Exchange's volume is in BTC and available since the earliest time of exchanges. Please refer to volume unit of each exchange from below table.

<br>

Supported Pairs By Exchange

◦ Spot

NameExchangeSymbolVolume UnitAvailable Since
All Exchangeall_exchangebtc_usd*BTC2009-01-03 18:15:00
Binancebinancebtc_usdt*BTC2017-08-17 04:00:00
Binance USbinance_usbtc_usd* <br/> btc_usdtBTC2019-09-17 10:17:00 <br/> 2019-09-23 08:34:00
Bitfinexbitfinexbtc_usd* <br/> btc_usdtBTC2013-04-01 00:07:00 <br/> 2019-03-11 10:05:00
Bittrexbittrexbtc_usd* <br/> btc_usdtUSD <br/> USDT2018-05-31 16:26:00 <br/> 2015-12-12 14:59:00
Coinbase Advancedcoinbase_advancedbtc_usd*BTC2015-07-20 21:37:00
FTX**ftxbtc_usd* <br/> btc_usdtUSD <br/> USDT2019-07-21 13:11:00 <br/> 2020-03-28 14:40:00
Geminigeminibtc_usd*BTC2019-08-30 00:00:00
HTX Globalhtx_globalbtc_usdt*BTC2019-11-19 00:00:00
Krakenkrakenbtc_usd* <br/> btc_usdtBTC2013-10-06 21:34:00 <br/> 2019-12-19 18:06:00
OKXokxbtc_usdt*BTC2019-10-01 00:00:00

◦ Perpetual

ExchangeExchange SymbolPair SymbolVolumeHistorical Starting Point
All Exchangeall_exchangebtc_usd*BTCThe earliest time in the exchanges below.
Binancebinancebtc_usd* <br/> btc_usdtCont <br/> BTC2020-08-11 07:02:00 <br/> 2019-09-08 17:57:00
Bitmexbitmexbtc_usd*USD2015-09-25 12:34:00
Bybitbybitbtc_usd* <br/> btc_usdtUSD <br/> BTC2018-11-14 16:00:00 <br/> 2020-03-25 10:36:00
Deribitderibitbtc_usd*USD2018-08-14 10:34:00
FTX**ftxbtc_usd*USD2019-07-20 12:35:00
HTX Globalhtx_globalbtc_usd* <br/> btc_usdtCont <br/> BTC2020-03-25 09:45:00 <br/> 2020-10-21 09:08:00
OKXokxbtc_usd* <br/> btc_usdtCont <br/> BTC2019-03-30 00:00:00 <br/> 2019-12-25 00:00:00

(*) Default exchange <br> (**) Use in cautions due to the deprecation (no data update)

We calculate the OHLCV data of a day from the beginning of UTC 00:00:00. However, the OHLCV data in official sites of HTX and OKX are calculated from the beginning of UTC 16:00:00. Thus, be aware that there may be some intended discrepancy between those.

<br>

Supported Windows By Market

MarketSupported Windows
Spotmin, hour, day*
Perpetualmin, hour, day*

(*) Default exchange

get/btc/market-data/price-ohlcv

Query parameters

marketstring

A market type from the table that we support. See here

exchangestring

A exchange from the table that we support. See here.

symbolstring

A BTC pair symbol from the table that we support. See here

windowstring

A window from the table that we support. See here

fromstring

This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.

tostring

This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.

limitinteger

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

formatstring

A format type about return message type. Supported formats are json, csv.

Response

Price OHLCV Data