ETH Market Data
This namespace contains endpoints to retrieve metrics related to the value of ETH including price, etc. We provide USD and USDT spot price of ETH from global exchanges and ETH index price. CryptoQuant's ETH index price is VWAP(Volume Weighted Average Price) of aggregated price data from all exchanges we provide. For more detailed information, please refer to the description of each metric.
This endpoint returns metrics related to ETH price. We provide two types of price, CryptoQuant's ETH Index Price and USD or USDT price of ETH 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.
ETH Index Price is calculated by taking VWAP(Volume Weighted Average Price) of ETH price data aggregated from all exchanges we provide. The exchanges we provide are as follows.
Supported Exchanges By Market
Spot
spot
All Exchange*, Binance, Binance US, Bitfinex, Bittrex, Coinbase Advanced, FTX**, Gemini, HTX Global, Kraken, OKX
Perpetual
perpetual
All Exchange*, Binance, Bitmex, Bybit, Deribit, FTX**, HTX Global, OKX
(*) Default exchange (**) Use in cautions due to the deprecation (no data update)
In order to get USD or USDT price of ETH of specific exchange from above (eg. ethusdt pair of binance), you must specify market, exchange and symbol of ETH pair.
For volume metric, the unit of volume could be USD, USDT or ETH. This is because exchanges have their own price data policy. All Exchange's volume is in ETH. Please refer to volume unit of each exchange from below table.
Supported Pairs By Exchange
◦ Spot
All Exchange
all_exchange
eth_usd*
ETH
The earliest time in the exchanges below.
Binance
binance
eth_usdt*
ETH
2017-08-17 04:00:00
Binance US
binance_us
eth_usd*
eth_usdt
ETH
2019-09-18 14:58:00 2019-09-23 08:36:00
Bitfinex
bitfinex
eth_usd*
eth_usdt
ETH
2016-03-09 16:04:00 2019-03-11 10:03:00
Bittrex
bittrex
eth_usd*
eth_usdt
USD USDT
2018-06-21 02:17:00 2017-04-21 13:30:00
Coinbase Advanced
coinbase_advanced
eth_usd*
ETH
2016-05-18 00:14:00
FTX**
ftx
eth_usd*
eth_usdt
USD USDT
2019-09-14 21:07:00 2020-03-28 14:40:00
Gemini
gemini
eth_usd*
ETH
2019-08-30 00:00:00
HTX Global
htx_global
eth_usdt*
ETH
2019-11-19 00:00:00
Kraken
kraken
eth_usd*
eth_usdt
ETH
2015-08-07 14:03:00 2019-12-19 16:49:00
OKX
okx
eth_usdt*
ETH
2019-10-01 00:00:00
◦ Perpetual
All Exchange
all_exchange
eth_usd*
ETH
The earliest time in the exchanges below.
Binance
binance
eth_usd*
eth_usdt
Cont ETH
2020-08-11 07:02:00 2019-09-08 17:57:00
Bitmex
bitmex
eth_usd*
Cont
2015-09-25 12:34:00
Bybit
bybit
eth_usd*
eth_usdt
USD ETH
2018-11-14 16:00:00 2020-03-25 10:36:00
Deribit
deribit
eth_usd*
USD
2018-08-14 10:34:00
FTX**
ftx
eth_usd*
USD
2019-07-20 12:35:00
HTX Global
htx_global
eth_usd*
eth_usdt
Cont ETH
2020-03-25 09:45:00 2020-10-21 09:08:00
OKX
okx
eth_usd*
eth_usdt
Cont ETH
2019-03-30 00:00:00 2019-12-25 00:00:00
(*) Default exchange (**) 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.
Supported Windows By Market
Spot
min, hour, day*
Perpetual
min, hour, day*
(*) Default symbol
For each API request, include this HTTP header:
Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required.
You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.
A market type from the table that we support. See here
spotExample: spotA exchange from the table that we support. See here.
all_exchangeExample: binanceThis 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.
20191001T100000This 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.
20191001T103025The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.
100Example: 100A format type about return message type. Supported formats are json, csv.
jsonExample: jsonPrice OHLCV Data
curl "https://api.cryptoquant.com/v1/eth/market-data/price-ohlcv?window=day&from=20191001&limit=2"Price OHLCV Data
{
"status": {
"code": 200,
"message": "success"
},
"result": {
"window": "day",
"data": [
{
"date": "2019-10-02",
"open": null,
"high": null,
"low": null,
"close": null,
"volume": null
},
{
"date": "2019-10-01",
"open": null,
"high": null,
"low": null,
"close": null,
"volume": null
}
]
}
}This endpoint returns ETH Perpetual Open Interest from derivative exchanges. Supported exchanges for Open Interest are below. Note we unify the unit of return value to USD for each exchange where its contract specification may vary.
All Exchanges
all_exchange
all_symbol
The earliest time in the exchanges below.
Binance
binance
all_symbol
eth_usd
eth_usdt
The earliest time in the symbols. 2020-08-18 00:00:00 2020-05-14 00:00:00
Bitfinex
bitfinex
all_symbol
eth_usdt
The earliest time in the symbols. 2020-06-01 00:00:00
Bitmex
bitmex
all_symbol
eth_usd
The earliest time in the symbols. 2019-03-30 00:00:00
Bybit
bybit
all_symbol
eth_usd
eth_usdt
The earliest time in the symbols. 2019-11-07 00:00:00 2020-10-21 00:00:00
Deribit
deribit
all_symbol
eth_usd
The earliest time in the symbols. 2019-03-31 00:00:00
FTX**
ftx
all_symbol
eth_usd
The earliest time in the symbols. 2020-05-09 00:00:00
Gate.io
gate_io
all_symbol
eth_usd
eth_usdt
The earliest time in the symbols. 2020-07-01 00:00:00 2020-07-01 00:00:00
HTX
htx_global
all_symbol
eth_usd
eth_usdt
The earliest time in the symbols. 2020-06-24 00:00:00 2021-08-26 05:00:00
Kraken
kraken
all_symbol
eth_usd
The earliest time in the symbols. 2019-03-30 00:00:00
OKX
okx
all_symbol
eth_usd
eth_usdt
The earliest time in the symbols. 2019-09-05 00:00:00 2020-01-01 00:00:00
(**) Use in cautions due to the deprecation (no data update)
For each API request, include this HTTP header:
Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required.
You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.
A derivative exchange from the table that we support. See here.
binanceCurrently we support day, hour, and min.
dayExample: dayThis 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.
20191001T100000This 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.
20191001T103025The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.
100Example: 100A format type about return message type. Supported formats are json, csv.
jsonExample: jsonOpen Interest in USD
curl "https://api.cryptoquant.com/v1/eth/market-data/open-interest?window=day&from=20191001&exchange=bitmex"Open Interest in USD
{
"status": {
"code": 200,
"message": "success"
},
"result": {
"window": "day",
"data": [
{
"date": "2019-10-02",
"open_interest": null
},
{
"date": "2019-10-01",
"open_interest": null
}
]
}
}Funding rates represents traders' sentiments of which position they bet on in perpetual swaps market. Positive funding rates implies that many traders are bullish and long traders pay funding to short traders. Negative funding rates implies many traders are bearish and short traders pay funding to long traders.
All Exchanges
all_exchange
The earliest time in the exchanges below.
Binance
binance
ETH-USDT
2019-11-29 00:00:00
Bybit
bybit
ETH-USD
2019-01-25 08:00:00
Bitmex
bitmex
ETH-USD
2018-08-02 12:00:00
Deribit
deribit
ETH-PERPETUAL
2019-10-04 00:00:00
HTX Global
htx_global
ETH-USD
2020-07-04 00:01:00
OKX
okx
ETH-USD
2019-04-02 02:00:00
For each API request, include this HTTP header:
Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required.
You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.
A derivative exchange from the table that we support. See here.
bitmexCurrently we support day, hour, and min.
dayExample: dayThis 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.
20191001T100000This 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.
20191001T103025The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.
100Example: 100A format type about return message type. Supported formats are json, csv.
jsonExample: jsonFunding Rates in percentage
curl "https://api.cryptoquant.com/v1/eth/market-data/funding-rates?window=day&from=20191001&exchange=bitmex"Funding Rates in percentage
{
"status": {
"code": 200,
"message": "success"
},
"result": {
"window": "day",
"data": [
{
"date": "2019-10-02",
"funding_rates": null
},
{
"date": "2019-10-01",
"funding_rates": null
}
]
}
}Taker Buy/Sell Stats represent takers' sentiment of which position they are taking in the market. This metric is calculated with perpetual swap trades in each exchange. taker_buy_volume is volume that takers buy. taker_sell_volume is volume that takers sell. taker_total_volume is the sum of taker_buy_volume and taker_sell_volume. taker_buy_ratio is the ratio of taker_buy_volume divided by taker_total_volume. taker_sell_ratio is the ratio of taker_sell_volume divided by taker_total_volume. taker_buy_sell_ratio is the ratio of taker_buy_volume divided by taker_sell_volume. Note we unify the unit of return value to USD for each exchange where its contract specification may vary.
All Exchanges
all_exchange
The earliest time in the exchanges below.
Binance
binance
ETH-USDT
2019-12-04 00:00:00
Bybit
bybit
ETH-USD
2019-12-04 00:00:00
Bitmex
bitmex
ETH-USD
2018-09-01 00:00:00
Deribit
deribit
ETH-PERPETUAL
2019-09-04 00:00:00
HTX Global
htx_global
ETH-USD
2020-04-18 00:00:00
OKX
okx
ETH-USD
2019-08-04 00:00:00
For each API request, include this HTTP header:
Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required.
You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.
A derivative exchange from the table that we support. See here.
bitmexCurrently we support day, hour, and min.
dayExample: dayThis 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.
20191001T100000This 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.
20191001T103025The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.
100Example: 100A format type about return message type. Supported formats are json, csv.
jsonExample: jsonTaker Buy, Sell volume and ratio
curl "https://api.cryptoquant.com/v1/eth/market-data/taker-buy-sell-stats?window=day&from=20191001&exchange=bitmex"Taker Buy, Sell volume and ratio
{
"status": {
"code": 200,
"message": "success"
},
"result": {
"window": "day",
"data": [
{
"date": "2019-10-02",
"taker_buy_volume": null,
"taker_sell_volume": null,
"taker_buy_ratio": null,
"taker_sell_ratio": null,
"taker_buy_sell_ratio": null
},
{
"date": "2019-10-01",
"taker_buy_volume": null,
"taker_sell_volume": null,
"taker_buy_ratio": null,
"taker_sell_ratio": null,
"taker_buy_sell_ratio": null
}
]
}
}Liquidations are sum of forced market orders to exit leveraged positions caused by price volatility. Liquidations indicate current price volatility and traders' sentiment which side they had been betting. Note that Binance's liquidation data collection policy has changed since 2021-04-27, which makes the distribution of the data has changed after that.
All Exchanges
all_exchange
all_symbol
The earliest time in the exchanges below.
Binance
binance
all_symbol
eth_usdt
eth_usd
The earliest time in the symbols. 2019-11-30 00:00:00 2020-08-21 00:00:00
Bitfinex
bitfinex
all_symbol
eth_usdt
The earliest time in the symbols. 2019-09-17 00:00:00
Bitmex
bitmex
all_symbol
eth_usd
The earliest time in the symbols. 2019-04-02 00:00:00
Bybit
bybit
all_symbol
eth_usd
eth_usdt
The earliest time in the symbols. 2020-12-20 00:00:00 2020-12-18 00:00:00
Deribit
deribit
all_symbol
eth_usd
The earliest time in the symbols. 2019-05-25 00:00:00
FTX**
ftx
all_symbol
eth_usd
The earliest time in the symbols. 2019-08-04 00:00:00
Gate.io
gate_io
all_symbol
eth_usd
eth_usdt
The earliest time in the symbols. 2018-12-28 11:00:00 2019-11-21 11:00:00
HTX Global
htx_global
all_symbol
eth_usd
eth_usdt
The earliest time in the symbols. 2020-06-26 00:00:00 2021-09-23 14:00:00
OKX
okx
all_symbol
eth_usd
eth_usdt
The earliest time in the symbols. 2020-12-20 00:00:00 2020-12-17 00:00:00
(**) Use in cautions due to the deprecation (no data update)
For each API request, include this HTTP header:
Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required.
You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.
A derivative exchange from the table that we support. See here.
deribitA ETH pair symbol from the table that we support. See here
all_symbolExample: eth_usdCurrently we support day, hour, and min.
dayExample: dayThis 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.
20191001T100000This 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.
20191001T103025The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.
100Example: 100A format type about return message type. Supported formats are json, csv.
jsonExample: jsonAmount of long/short liquidations orders
curl "https://api.cryptoquant.com/v1/eth/market-data/liquidations?window=day&from=20191001&exchange=deribit"Amount of long/short liquidations orders
{
"status": {
"code": 200,
"message": "success"
},
"result": {
"window": "day",
"data": [
{
"date": "2019-10-02",
"long_liquidations": null,
"short_liquidations": null,
"long_liquidations_usd": null,
"short_liquidations_usd": null
},
{
"date": "2019-10-01",
"long_liquidations": null,
"short_liquidations": null,
"long_liquidations_usd": null,
"short_liquidations_usd": null
}
]
}
}Coinbase Premium Index is calculated as percent difference from Binance price(ETHUSDT) to Coinbase price(ETHUSD). Coinbase Premium Gap is calculated as gap between Coinbase price(ETHUSD) and Binance price(ETHUSDT). The higher the premium, the stronger the spot buying pressure from Coinbase.
For each API request, include this HTTP header:
Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required.
You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.
Currently we support day, hour, and min.
dayExample: dayThis 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.
20191001T100000This 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.
20191001T103025The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.
100Example: 100A format type about return message type. Supported formats are json, csv.
jsonExample: jsonCoinbase Premium Index in percentage and Coinbase Premium Gap
curl "https://api.cryptoquant.com/v1/eth/market-data/coinbase-premium-index?window=day&from=20191001T000000&limit=2"Coinbase Premium Index in percentage and Coinbase Premium Gap
{
"status": {
"code": 200,
"message": "success"
},
"result": {
"window": "day",
"data": [
{
"date": "2019-10-02",
"coinbase_premium_gap": null,
"coinbase_premium_index": null
},
{
"date": "2019-10-01",
"coinbase_premium_gap": null,
"coinbase_premium_index": null
}
]
}
}This endpoint returns metrics related to market capitalization. We provide market_cap, which is total market capitalization of ETH, calculated by multiplying the circulating supply with its USD price.
For each API request, include this HTTP header:
Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required.
You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.
Currently we support day, hour, and block.
dayExample: dayThis 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.
20191001T100000This 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.
20191001T103025The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.
100Example: 100A format type about return message type. Supported formats are json, csv.
jsonExample: jsonMarket capitalization of Ethereum, calculated by total_supply * price_usd_close.
curl "https://api.cryptoquant.com/v1/eth/market-data/capitalization?window=day&from=20191001&limit=2"Market capitalization of Ethereum, calculated by total_supply * price_usd_close.
{
"status": {
"code": 200,
"message": "success"
},
"result": {
"window": "day",
"data": [
{
"date": "2019-10-02",
"market_cap": null
},
{
"date": "2019-10-01",
"market_cap": null
}
]
}
}Last updated
Was this helpful?