# 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.

## Price OHLCV

> 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. \
> \
> \<br>\
> \
> \### Supported Exchanges By Market\
> \
> \| Name | Market  |    Supported Exchanges     |\
> \|--------|---------|----------------------------|\
> \| 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 \<br>\
> \> (\*\*) 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.  \
> \
> \<br>\
> \
> \### Supported Pairs By Exchange\
> \
> \#### ◦ Spot\
> \| Name           |   Exchange       | Symbol                    |  Volume Unit |    Available Since   |\
> \|----------------|------------------|---------------------------|--------------|-------------------------------|\
> \| 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\`\* \<br/>\`eth\_usdt\` |    ETH       | 2019-09-18 14:58:00 \<br/> 2019-09-23 08:36:00 |\
> \| Bitfinex       | \`bitfinex\`       |  \`eth\_usd\`\* \<br/>\`eth\_usdt\` |    ETH       | 2016-03-09 16:04:00 \<br/> 2019-03-11 10:03:00 |\
> \| Bittrex        | \`bittrex\`        |  \`eth\_usd\`\* \<br/>\`eth\_usdt\` |    USD \<br/> USDT | 2018-06-21 02:17:00 \<br/> 2017-04-21 13:30:00 |\
> \| Coinbase Advanced   | \`coinbase\_advanced\`   |  \`eth\_usd\`\*                |    ETH       | 2016-05-18 00:14:00 \<br/>  \
> \| FTX\*\*            | \`ftx\`            |  \`eth\_usd\`\* \<br/>\`eth\_usdt\` |    USD \<br/> USDT | 2019-09-14 21:07:00 \<br/> 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\`\* \<br/>\`eth\_usdt\` |    ETH       | 2015-08-07 14:03:00 \<br/> 2019-12-19 16:49:00 |\
> \| OKX            | \`okx\`           |  \`eth\_usdt\`\*               |    ETH       | 2019-10-01 00:00:00           |\
> \
> \#### ◦ Perpetual\
> \|    Exchange    | Exchange Symbol  |     Pair Symbol               |    Volume         |    Historical Starting Point   |\
> \|----------------|------------------|-------------------------------|-------------------|--------------------------------|\
> \| All Exchange   | \`all\_exchange\`   |  \`eth\_usd\`\*                   |    ETH            |  The earliest time in the exchanges below.         |\
> \| Binance        | \`binance\`        |  \`eth\_usd\`\* \<br/> \`eth\_usdt\`  |    Cont \<br/> ETH | 2020-08-11 07:02:00 \<br/> 2019-09-08 17:57:00 |\
> \| Bitmex         | \`bitmex\`         |  \`eth\_usd\`\*                   |    Cont           | 2015-09-25 12:34:00            |\
> \| Bybit          | \`bybit\`          |  \`eth\_usd\`\* \<br/> \`eth\_usdt\`  |    USD  \<br/> ETH | 2018-11-14 16:00:00 \<br/> 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\`\* \<br/> \`eth\_usdt\`  |    Cont \<br/> ETH | 2020-03-25 09:45:00 \<br/> 2020-10-21 09:08:00 |\
> \| OKX            | \`okx\`           |  \`eth\_usd\`\* \<br/> \`eth\_usdt\`  |    Cont \<br/> ETH | 2019-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\
> \
> \|   Market  |   Supported Windows           |\
> \|-----------|-------------------------------|\
> \| Spot      | \`min\`, \`hour\`, \`day\*\`         |\
> \| Perpetual | \`min\`, \`hour\`, \`day\*\`         |\
> \
> \> (\*) Default symbol

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"ETH Market Data","description":"This namespace contains endpoints to retrieve metrics related to the value of ETH including price, etc.\nWe 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.\nFor more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`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.\nYou 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](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"market_eth":{"description":"A market type from the table that we support. [See here](#operation/getETHPriceOHLCV)","explode":false,"in":"query","name":"market","required":false,"schema":{"type":"string","default":"spot"},"style":"form"},"eth_exchange_ohlcv":{"description":"A exchange from the table that we support. [See here](#operation/getETHPriceOHLCV).","explode":false,"in":"query","name":"exchange","required":false,"schema":{"type":"string","default":"all_exchange"},"style":"form"},"symbol_eth_ohlcv":{"description":"A ETH pair symbol from the table that we support. [See here](#operation/getETHPriceOHLCV)","explode":false,"in":"query","name":"symbol","required":false,"schema":{"type":"string"},"style":"form"},"window_mdh_eth_spotperp":{"description":"A window from the table that we support. [See here](#operation/getETHPriceOHLCV)","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"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.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"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.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"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.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"PriceOHLCV":{"description":"Price OHLCV Data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceOHLCVResponse"}}}}},"schemas":{"PriceOHLCVResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_MDHB"},"data":{"type":"array","items":{"type":"object","required":["open","high","low","close","volume"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"open":{"type":"decimal","description":"opening price at the beginning of the window."},"high":{"type":"decimal","description":"opening price at the end of the window."},"low":{"type":"decimal","description":"The highest price in a given window."},"close":{"type":"decimal","description":"The lowest price in a given window."},"volume":{"type":"decimal","description":"The total traded amount in a given window."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_MDHB":{"type":"string","description":"The size of window. It can be day, hour, min, or block and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/eth/market-data/price-ohlcv":{"get":{"tags":["ETH Market Data"],"summary":"Price OHLCV","description":"This endpoint returns metrics related to ETH price. \nWe provide two types of price, CryptoQuant's ETH Index Price and USD or USDT price of ETH of global exchanges.\n\nPrice OHLCV data consists of five metrics. \n`open`, the opening price at the beginning of the window, `close`, USD closing price at the end of the window, \n`high`, the highest USD price in a given window, `low`, the lowest USD price in a given window, \nand `volume`, the total volume traded in a given window. \n\nAt this endpoint, metrics are calculated by Minute, Hour and Day.\n\nETH 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. \n\n<br>\n\n### Supported Exchanges By Market\n\n| Name | Market  |    Supported Exchanges     |\n|--------|---------|----------------------------|\n| Spot   | `spot`  | All Exchange*, Binance, Binance US, Bitfinex, Bittrex, Coinbase Advanced, FTX**, Gemini, HTX Global, Kraken, OKX |\n| Perpetual   | `perpetual`  | All Exchange*, Binance, Bitmex, Bybit, Deribit, FTX**, HTX Global, OKX |\n\n> (*) Default exchange <br>\n> (**) Use in cautions due to the deprecation (no data update)\n\nIn order to get USD or USDT price of ETH of specific exchange from above (eg. `ethusdt` pair of `binance`), \nyou must specify `market`, `exchange` and `symbol` of ETH pair.  \n\nFor `volume` metric, the unit of volume could be USD, USDT or ETH. \nThis is because exchanges have their own price data policy. All Exchange's `volume` is in ETH. \nPlease refer to volume unit of each exchange from below table.  \n\n<br>\n\n### Supported Pairs By Exchange\n\n#### ◦ Spot\n| Name           |   Exchange       | Symbol                    |  Volume Unit |    Available Since   |\n|----------------|------------------|---------------------------|--------------|-------------------------------|\n| All Exchange   | `all_exchange`   |  `eth_usd`*                |    ETH       |  The earliest time in the exchanges below.      |\n| Binance        | `binance`        |  `eth_usdt`*               |    ETH       | 2017-08-17 04:00:00           |\n| Binance US     | `binance_us`     |  `eth_usd`* <br/>`eth_usdt` |    ETH       | 2019-09-18 14:58:00 <br/> 2019-09-23 08:36:00 |\n| Bitfinex       | `bitfinex`       |  `eth_usd`* <br/>`eth_usdt` |    ETH       | 2016-03-09 16:04:00 <br/> 2019-03-11 10:03:00 |\n| Bittrex        | `bittrex`        |  `eth_usd`* <br/>`eth_usdt` |    USD <br/> USDT | 2018-06-21 02:17:00 <br/> 2017-04-21 13:30:00 |\n| Coinbase Advanced   | `coinbase_advanced`   |  `eth_usd`*                |    ETH       | 2016-05-18 00:14:00 <br/>  \n| FTX**            | `ftx`            |  `eth_usd`* <br/>`eth_usdt` |    USD <br/> USDT | 2019-09-14 21:07:00 <br/> 2020-03-28 14:40:00 |\n| Gemini         | `gemini`         |  `eth_usd`*                |    ETH       | 2019-08-30 00:00:00           |\n| HTX Global   | `htx_global`   |  `eth_usdt`*               |    ETH       | 2019-11-19 00:00:00           |\n| Kraken         | `kraken`         |  `eth_usd`* <br/>`eth_usdt` |    ETH       | 2015-08-07 14:03:00 <br/> 2019-12-19 16:49:00 |\n| OKX            | `okx`           |  `eth_usdt`*               |    ETH       | 2019-10-01 00:00:00           |\n\n#### ◦ Perpetual\n|    Exchange    | Exchange Symbol  |     Pair Symbol               |    Volume         |    Historical Starting Point   |\n|----------------|------------------|-------------------------------|-------------------|--------------------------------|\n| All Exchange   | `all_exchange`   |  `eth_usd`*                   |    ETH            |  The earliest time in the exchanges below.         |\n| Binance        | `binance`        |  `eth_usd`* <br/> `eth_usdt`  |    Cont <br/> ETH | 2020-08-11 07:02:00 <br/> 2019-09-08 17:57:00 |\n| Bitmex         | `bitmex`         |  `eth_usd`*                   |    Cont           | 2015-09-25 12:34:00            |\n| Bybit          | `bybit`          |  `eth_usd`* <br/> `eth_usdt`  |    USD  <br/> ETH | 2018-11-14 16:00:00 <br/> 2020-03-25 10:36:00 |\n| Deribit        | `deribit`        |  `eth_usd`*                   |    USD            | 2018-08-14 10:34:00  |\n| FTX**            | `ftx`            |  `eth_usd`*                   |    USD            | 2019-07-20 12:35:00  |\n| HTX Global   | `htx_global`   |  `eth_usd`* <br/> `eth_usdt`  |    Cont <br/> ETH | 2020-03-25 09:45:00 <br/> 2020-10-21 09:08:00 |\n| OKX            | `okx`           |  `eth_usd`* <br/> `eth_usdt`  |    Cont <br/> ETH | 2019-03-30 00:00:00 <br/> 2019-12-25 00:00:00 |\n\n> (*) Default exchange <br>\n> (**) Use in cautions due to the deprecation (no data update)\n\n> We calculate the OHLCV data of a day from the beginning of UTC 00:00:00. \n> However, the OHLCV data in official sites of HTX and OKX are calculated from the beginning of UTC 16:00:00. \n> Thus, be aware that there may be some intended discrepancy between those.\n\n<br>\n\n### Supported Windows By Market\n\n|   Market  |   Supported Windows           |\n|-----------|-------------------------------|\n| Spot      | `min`, `hour`, `day*`         |\n| Perpetual | `min`, `hour`, `day*`         |\n\n> (*) Default symbol","operationId":"getETHPriceOHLCV","parameters":[{"$ref":"#/components/parameters/market_eth"},{"$ref":"#/components/parameters/eth_exchange_ohlcv"},{"$ref":"#/components/parameters/symbol_eth_ohlcv"},{"$ref":"#/components/parameters/window_mdh_eth_spotperp"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/PriceOHLCV"}}}}}}
```

## Open Interest

> 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.\
> \
> \| Name           |   Exchange     | Symbol |  Available Since   |\
> \|----------------|--------------|-------------|-----------------------------|\
> \| All Exchanges  |   \`all\_exchange\` | \`all\_symbol\`   | The earliest time in the exchanges below. |\
> \| Binance        |   \`binance\`  |    \`all\_symbol\` \<br/> \`eth\_usd\` \<br/> \`eth\_usdt\`  | The earliest time in the symbols. \<br/> 2020-08-18 00:00:00 \<br/> 2020-05-14 00:00:00     |\
> \| Bitfinex       |   \`bitfinex\` |    \`all\_symbol\` \<br/> \`eth\_usdt\`  | The earliest time in the symbols. \<br/> 2020-06-01 00:00:00  |\
> \| Bitmex         |   \`bitmex\`   |    \`all\_symbol\` \<br/> \`eth\_usd\`  | The earliest time in the symbols. \<br/> 2019-03-30 00:00:00  |\
> \| Bybit          |   \`bybit\`    |    \`all\_symbol\` \<br/> \`eth\_usd\` \<br/> \`eth\_usdt\` | The earliest time in the symbols. \<br/> 2019-11-07 00:00:00 \<br/> 2020-10-21 00:00:00 |\
> \| Deribit        |   \`deribit\`  |    \`all\_symbol\` \<br/> \`eth\_usd\`  | The earliest time in the symbols. \<br/> 2019-03-31 00:00:00        |\
> \| FTX\*\*            |   \`ftx\`      |    \`all\_symbol\` \<br/> \`eth\_usd\` | The earliest time in the symbols. \<br/> 2020-05-09 00:00:00  |\
> \| Gate.io        |   \`gate\_io\`  | \`all\_symbol\` \<br/> \`eth\_usd\` \<br/> \`eth\_usdt\` | The earliest time in the symbols. \<br/> 2020-07-01 00:00:00 \<br/> 2020-07-01 00:00:00 |\
> \| HTX          |   \`htx\_global\`    | \`all\_symbol\` \<br/> \`eth\_usd\` \<br/> \`eth\_usdt\` | The earliest time in the symbols. \<br/> 2020-06-24 00:00:00 \<br/> 2021-08-26 05:00:00 |\
> \| Kraken         |   \`kraken\`   | \`all\_symbol\` \<br/> \`eth\_usd\` | The earliest time in the symbols. \<br/> 2019-03-30 00:00:00  |\
> \| OKX            |   \`okx\`     | \`all\_symbol\` \<br/> \`eth\_usd\` \<br/> \`eth\_usdt\` | The earliest time in the symbols. \<br/> 2019-09-05 00:00:00 \<br/> 2020-01-01 00:00:00 |\
> \
> \> (\*\*) Use in cautions due to the deprecation (no data update)

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"ETH Market Data","description":"This namespace contains endpoints to retrieve metrics related to the value of ETH including price, etc.\nWe 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.\nFor more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`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.\nYou 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](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"eth_exchange_oi":{"description":"A derivative exchange from the table that we support. [See here](#operation/ETHgetOpenInterest).","explode":false,"in":"query","name":"exchange","required":true,"schema":{"type":"string"},"style":"form"},"window_mhd":{"description":"Currently we support `day`, `hour`, and `min`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"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.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"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.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"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.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"OpenInterest":{"description":"Open Interest in USD","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenInterestResponse"}}}}},"schemas":{"OpenInterestResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_MDH"},"data":{"type":"array","items":{"type":"object","required":["open_interest"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"open_interest":{"type":"string","description":"The amount of open interest in the given period and exchange. The standard unit can differ from each exchange."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_MDH":{"type":"string","description":"The size of window. It can be day, hour, or min and it depends on the user request."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/eth/market-data/open-interest":{"get":{"tags":["ETH Market Data"],"summary":"Open Interest","description":"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.\n\n| Name           |   Exchange     | Symbol |  Available Since   |\n|----------------|--------------|-------------|-----------------------------|\n| All Exchanges  |   `all_exchange` | `all_symbol`   | The earliest time in the exchanges below. |\n| Binance        |   `binance`  |    `all_symbol` <br/> `eth_usd` <br/> `eth_usdt`  | The earliest time in the symbols. <br/> 2020-08-18 00:00:00 <br/> 2020-05-14 00:00:00     |\n| Bitfinex       |   `bitfinex` |    `all_symbol` <br/> `eth_usdt`  | The earliest time in the symbols. <br/> 2020-06-01 00:00:00  |\n| Bitmex         |   `bitmex`   |    `all_symbol` <br/> `eth_usd`  | The earliest time in the symbols. <br/> 2019-03-30 00:00:00  |\n| Bybit          |   `bybit`    |    `all_symbol` <br/> `eth_usd` <br/> `eth_usdt` | The earliest time in the symbols. <br/> 2019-11-07 00:00:00 <br/> 2020-10-21 00:00:00 |\n| Deribit        |   `deribit`  |    `all_symbol` <br/> `eth_usd`  | The earliest time in the symbols. <br/> 2019-03-31 00:00:00        |\n| FTX**            |   `ftx`      |    `all_symbol` <br/> `eth_usd` | The earliest time in the symbols. <br/> 2020-05-09 00:00:00  |\n| Gate.io        |   `gate_io`  | `all_symbol` <br/> `eth_usd` <br/> `eth_usdt` | The earliest time in the symbols. <br/> 2020-07-01 00:00:00 <br/> 2020-07-01 00:00:00 |\n| HTX          |   `htx_global`    | `all_symbol` <br/> `eth_usd` <br/> `eth_usdt` | The earliest time in the symbols. <br/> 2020-06-24 00:00:00 <br/> 2021-08-26 05:00:00 |\n| Kraken         |   `kraken`   | `all_symbol` <br/> `eth_usd` | The earliest time in the symbols. <br/> 2019-03-30 00:00:00  |\n| OKX            |   `okx`     | `all_symbol` <br/> `eth_usd` <br/> `eth_usdt` | The earliest time in the symbols. <br/> 2019-09-05 00:00:00 <br/> 2020-01-01 00:00:00 |\n\n> (**) Use in cautions due to the deprecation (no data update)","operationId":"ETHgetOpenInterest","parameters":[{"$ref":"#/components/parameters/eth_exchange_oi"},{"$ref":"#/components/parameters/window_mhd"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/OpenInterest"}}}}}}
```

## Funding Rates

> 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.\
> \
> \| Name           |   Exchange     | Symbol |  Available Since   |\
> \|----------------|--------------|----|-------------------------|\
> \| 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        |

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"ETH Market Data","description":"This namespace contains endpoints to retrieve metrics related to the value of ETH including price, etc.\nWe 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.\nFor more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`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.\nYou 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](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"exchange_fr":{"description":"A derivative exchange from the table that we support. [See here](#operation/getFundingRates).","explode":false,"in":"query","name":"exchange","required":true,"schema":{"type":"string"},"style":"form"},"window_mhd":{"description":"Currently we support `day`, `hour`, and `min`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"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.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"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.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"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.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"FundingRates":{"description":"Funding Rates in percentage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundingRatesResponse"}}}}},"schemas":{"FundingRatesResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_MDH"},"data":{"type":"array","items":{"type":"object","required":["funding_rates"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"funding_rates":{"type":"decimal","description":"Funding rates in the given period and exchange. The standard unit is percentage."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_MDH":{"type":"string","description":"The size of window. It can be day, hour, or min and it depends on the user request."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/eth/market-data/funding-rates":{"get":{"tags":["ETH Market Data"],"summary":"Funding Rates","description":"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.\n\n| Name           |   Exchange     | Symbol |  Available Since   |\n|----------------|--------------|----|-------------------------|\n| All Exchanges  |   `all_exchange` | | The earliest time in the exchanges below. |\n| Binance        |   `binance`  | ETH-USDT  | 2019-11-29 00:00:00        |\n| Bybit          |   `bybit`    | ETH-USD | 2019-01-25 08:00:00        |\n| Bitmex         |   `bitmex`   | ETH-USD | 2018-08-02 12:00:00  |\n| Deribit        |   `deribit`  | ETH-PERPETUAL | 2019-10-04 00:00:00        |\n| HTX Global   |   `htx_global` | ETH-USD  | 2020-07-04 00:01:00       |\n| OKX            |   `okx`     | ETH-USD | 2019-04-02 02:00:00        |","operationId":"ETHgetFundingRates","parameters":[{"$ref":"#/components/parameters/exchange_fr"},{"$ref":"#/components/parameters/window_mhd"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/FundingRates"}}}}}}
```

## Taker Buy Sell Stats

> 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.\
> \
> \| Name           |   Exchange     | Symbol |  Available Since   |\
> \|----------------|--------------|------|-----------------------------|\
> \| 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        |

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"ETH Market Data","description":"This namespace contains endpoints to retrieve metrics related to the value of ETH including price, etc.\nWe 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.\nFor more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`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.\nYou 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](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"exchange_lss":{"description":"A derivative exchange from the table that we support. [See here](#operation/getLongShortStats).","explode":false,"in":"query","name":"exchange","required":true,"schema":{"type":"string"},"style":"form"},"window_mhd":{"description":"Currently we support `day`, `hour`, and `min`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"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.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"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.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"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.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"TakerBuySellStats":{"description":"Taker Buy, Sell volume and ratio","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakerBuySellStatsResponse"}}}}},"schemas":{"TakerBuySellStatsResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_MDH"},"data":{"type":"array","items":{"type":"object","required":["taker_buy_volume","taker_sell_volume","taker_buy_ratio","taker_sell_ratio","taker_buy_sell_ratio"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"taker_buy_volume":{"type":"decimal","description":"Volume that takers buy in the given period and exchange."},"taker_sell_volume":{"type":"decimal","description":"Volume that takers sell in the given period and exchange."},"taker_buy_ratio":{"type":"decimal","description":"The ratio of taker buy volume to taker total volume in the given period and exchange. Taker total volume is sum of taker buy and sell volume."},"taker_sell_ratio":{"type":"decimal","description":"The ratio of taker sell volume to taker total volume in the given period and exchange. Taker total volume is sum of taker buy and sell volume."},"taker_buy_sell_ratio":{"type":"decimal","description":"The ratio fo taker buy volume to taker sell volume in the given period and exchange."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_MDH":{"type":"string","description":"The size of window. It can be day, hour, or min and it depends on the user request."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/eth/market-data/taker-buy-sell-stats":{"get":{"tags":["ETH Market Data"],"summary":"Taker Buy Sell Stats","description":"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.\n`taker_buy_volume` is volume that takers buy.\n`taker_sell_volume` is volume that takers sell.\n`taker_total_volume` is the sum of `taker_buy_volume` and `taker_sell_volume`.\n`taker_buy_ratio` is the ratio of `taker_buy_volume` divided by `taker_total_volume`.\n`taker_sell_ratio` is the ratio of `taker_sell_volume` divided by `taker_total_volume`.\n`taker_buy_sell_ratio` is the ratio of `taker_buy_volume` divided by `taker_sell_volume`.\nNote we unify the unit of return value to USD for each exchange where its contract specification may vary.\n\n| Name           |   Exchange     | Symbol |  Available Since   |\n|----------------|--------------|------|-----------------------------|\n| All Exchanges  |   `all_exchange` | | The earliest time in the exchanges below. |\n| Binance        |   `binance`  | ETH-USDT | 2019-12-04 00:00:00        |\n| Bybit          |   `bybit`    | ETH-USD | 2019-12-04 00:00:00        |\n| Bitmex         |   `bitmex`   | ETH-USD | 2018-09-01 00:00:00  |\n| Deribit        |   `deribit`  | ETH-PERPETUAL | 2019-09-04 00:00:00       |\n| HTX Global   |   `htx_global`    | ETH-USD  | 2020-04-18 00:00:00       |\n| OKX            |   `okx`     | ETH-USD | 2019-08-04 00:00:00        |","operationId":"ETHgetTakerBuySellStats","parameters":[{"$ref":"#/components/parameters/exchange_lss"},{"$ref":"#/components/parameters/window_mhd"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/TakerBuySellStats"}}}}}}
```

## Liquidations

> 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]\(<https://binance-docs.github.io/apidocs/futures/en/#change-log>), which makes the distribution of the data has changed after that.\
> \
> \| Name           |   Exchange     |    Symbol    |   Available Since           |\
> \|----------------|----------------|--------------|-----------------------------|\
> \| All Exchanges  | \`all\_exchange\` | \`all\_symbol\` | The earliest time in the exchanges below. |\
> \| Binance        | \`binance\`      | \`all\_symbol\` \<br/> \`eth\_usdt\` \<br/> \`eth\_usd\` | The earliest time in the symbols. \<br/> 2019-11-30 00:00:00 \<br/> 2020-08-21 00:00:00 |\
> \| Bitfinex       | \`bitfinex\`     | \`all\_symbol\` \<br/> \`eth\_usdt\` | The earliest time in the symbols. \<br/> 2019-09-17 00:00:00 |\
> \| Bitmex         | \`bitmex\`       | \`all\_symbol\` \<br/> \`eth\_usd\` | The earliest time in the symbols. \<br/> 2019-04-02 00:00:00 |\
> \| Bybit          | \`bybit\`        | \`all\_symbol\` \<br/> \`eth\_usd\` \<br/> \`eth\_usdt\` | The earliest time in the symbols. \<br/> 2020-12-20 00:00:00 \<br/> 2020-12-18 00:00:00 |\
> \| Deribit        | \`deribit\`      | \`all\_symbol\` \<br/> \`eth\_usd\` | The earliest time in the symbols. \<br/> 2019-05-25 00:00:00 |\
> \| FTX\*\*            | \`ftx\`          | \`all\_symbol\` \<br/> \`eth\_usd\` | The earliest time in the symbols. \<br/> 2019-08-04 00:00:00 |\
> \| Gate.io        | \`gate\_io\`      | \`all\_symbol\` \<br/> \`eth\_usd\` \<br/> \`eth\_usdt\` | The earliest time in the symbols. \<br/> 2018-12-28 11:00:00 \<br/> 2019-11-21 11:00:00 |\
> \| HTX Global   | \`htx\_global\` | \`all\_symbol\` \<br/> \`eth\_usd\` \<br/> \`eth\_usdt\` | The earliest time in the symbols. \<br/> 2020-06-26 00:00:00 \<br/> 2021-09-23 14:00:00 |\
> \| OKX            | \`okx\`          | \`all\_symbol\` \<br/> \`eth\_usd\` \<br/> \`eth\_usdt\` | The earliest time in the symbols. \<br/> 2020-12-20 00:00:00 \<br/> 2020-12-17 00:00:00 |\
> \
> \> (\*\*) Use in cautions due to the deprecation (no data update)

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"ETH Market Data","description":"This namespace contains endpoints to retrieve metrics related to the value of ETH including price, etc.\nWe 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.\nFor more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`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.\nYou 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](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"exchange_liq_eth":{"description":"A derivative exchange from the table that we support. [See here](#operation/ETHgetLiquidations).","explode":false,"in":"query","name":"exchange","required":true,"schema":{"type":"string"},"style":"form"},"symbol_liq_eth":{"description":"A ETH pair symbol from the table that we support. [See here](#operation/ETHgetLiquidations)","explode":false,"in":"query","name":"symbol","required":false,"schema":{"type":"string","default":"all_symbol"},"style":"form"},"window_mhd":{"description":"Currently we support `day`, `hour`, and `min`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"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.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"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.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"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.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"Liquidations":{"description":"Amount of long/short liquidations orders","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiquidationsResponse"}}}}},"schemas":{"LiquidationsResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_MDH"},"data":{"type":"array","items":{"type":"object","required":["long_liquidations","short_liquidations","long_liquidations_usd","short_liquidations_usd"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"long_liquidations":{"type":"decimal","description":"Amount of liquidated orders in long positions."},"short_liquidations":{"type":"decimal","description":"Amount of liquidated orders in short positions."},"long_liquidations_usd":{"type":"decimal","description":"Amount of liquidated orders in long positions in USD."},"short_liquidations_usd":{"type":"decimal","description":"Amount of liquidated orders in short positions in USD."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_MDH":{"type":"string","description":"The size of window. It can be day, hour, or min and it depends on the user request."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/eth/market-data/liquidations":{"get":{"tags":["ETH Market Data"],"summary":"Liquidations","description":"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.\nNote that Binance's liquidation data collection policy has changed since [2021-04-27](https://binance-docs.github.io/apidocs/futures/en/#change-log), which makes the distribution of the data has changed after that.\n\n| Name           |   Exchange     |    Symbol    |   Available Since           |\n|----------------|----------------|--------------|-----------------------------|\n| All Exchanges  | `all_exchange` | `all_symbol` | The earliest time in the exchanges below. |\n| Binance        | `binance`      | `all_symbol` <br/> `eth_usdt` <br/> `eth_usd` | The earliest time in the symbols. <br/> 2019-11-30 00:00:00 <br/> 2020-08-21 00:00:00 |\n| Bitfinex       | `bitfinex`     | `all_symbol` <br/> `eth_usdt` | The earliest time in the symbols. <br/> 2019-09-17 00:00:00 |\n| Bitmex         | `bitmex`       | `all_symbol` <br/> `eth_usd` | The earliest time in the symbols. <br/> 2019-04-02 00:00:00 |\n| Bybit          | `bybit`        | `all_symbol` <br/> `eth_usd` <br/> `eth_usdt` | The earliest time in the symbols. <br/> 2020-12-20 00:00:00 <br/> 2020-12-18 00:00:00 |\n| Deribit        | `deribit`      | `all_symbol` <br/> `eth_usd` | The earliest time in the symbols. <br/> 2019-05-25 00:00:00 |\n| FTX**            | `ftx`          | `all_symbol` <br/> `eth_usd` | The earliest time in the symbols. <br/> 2019-08-04 00:00:00 |\n| Gate.io        | `gate_io`      | `all_symbol` <br/> `eth_usd` <br/> `eth_usdt` | The earliest time in the symbols. <br/> 2018-12-28 11:00:00 <br/> 2019-11-21 11:00:00 |\n| HTX Global   | `htx_global` | `all_symbol` <br/> `eth_usd` <br/> `eth_usdt` | The earliest time in the symbols. <br/> 2020-06-26 00:00:00 <br/> 2021-09-23 14:00:00 |\n| OKX            | `okx`          | `all_symbol` <br/> `eth_usd` <br/> `eth_usdt` | The earliest time in the symbols. <br/> 2020-12-20 00:00:00 <br/> 2020-12-17 00:00:00 |\n\n> (**) Use in cautions due to the deprecation (no data update)","operationId":"ETHgetLiquidations","parameters":[{"$ref":"#/components/parameters/exchange_liq_eth"},{"$ref":"#/components/parameters/symbol_liq_eth"},{"$ref":"#/components/parameters/window_mhd"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/Liquidations"}}}}}}
```

## Coinbase Premium Index

> 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.<br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"ETH Market Data","description":"This namespace contains endpoints to retrieve metrics related to the value of ETH including price, etc.\nWe 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.\nFor more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`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.\nYou 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](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_mhd":{"description":"Currently we support `day`, `hour`, and `min`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"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.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"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.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"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.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"ETHCoinbasePremiumIndex":{"description":"Coinbase Premium Index in percentage and Coinbase Premium Gap","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ETHCoinbasePremiumIndexResponse"}}}}},"schemas":{"ETHCoinbasePremiumIndexResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_MDH"},"data":{"type":"array","items":{"type":"object","required":["coinbase_premium_gap","coinbase_premium_index"],"properties":{"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime_MH"},"coinbase_premium_gap":{"type":"decimal","description":"The gap between Coinbase Advanced price(USD pair) and Binance price(USDT pair)."},"coinbase_premium_index":{"type":"decimal","description":"The percent difference from Binance price(ETHUSDT) to Coinbase price(ETHUSD)."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_MDH":{"type":"string","description":"The size of window. It can be day, hour, or min and it depends on the user request."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime_MH":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=min or window=hour is used."}}},"paths":{"/eth/market-data/coinbase-premium-index":{"get":{"tags":["ETH Market Data"],"summary":"Coinbase Premium Index","description":"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.\n","operationId":"getETHCoinbasePremiumIndex","parameters":[{"$ref":"#/components/parameters/window_mhd"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/ETHCoinbasePremiumIndex"}}}}}}
```

## Capitalization

> 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. <br>

```json
{"openapi":"3.0.0","info":{"title":"CryptoQuant Data API","version":"1.3.0"},"tags":[{"name":"ETH Market Data","description":"This namespace contains endpoints to retrieve metrics related to the value of ETH including price, etc.\nWe 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.\nFor more detailed information, please refer to the description of each metric."}],"servers":[{"url":"https://api.cryptoquant.com/v1/","description":"Default server"}],"security":[{"Access Token":[]}],"components":{"securitySchemes":{"Access Token":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"For each API request, include this HTTP header:\n`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.\nYou 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](https://cryptoquant.com/pricing) to Professional or Premium plan. You'll be able to see your access token on the [API tab](https://cryptoquant.com/settings/api) of your profile page after the subscription."}},"parameters":{"window_dbh":{"description":"Currently we support `day`, `hour`, and `block`.","explode":false,"in":"query","name":"window","schema":{"type":"string","default":"day"},"style":"form"},"from":{"description":"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.","explode":false,"in":"query","name":"from","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"to":{"description":"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.","explode":false,"in":"query","name":"to","required":false,"schema":{"YYYYMMDDTHHMMSS":{"type":"string"}},"style":"form"},"limit":{"description":"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.","explode":false,"in":"query","name":"limit","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":100000},"style":"form"},"format":{"description":"A format type about return message type. Supported formats are json, csv.","explode":false,"in":"query","name":"format","required":false,"schema":{"type":"string","default":"json"},"style":"form"}},"responses":{"responses_Capitalization":{"description":"Market capitalization of Ethereum, calculated by total_supply * price_usd_close.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/schemas_CapitalizationResponse"}}}}},"schemas":{"schemas_CapitalizationResponse":{"type":"object","required":["status","result"],"properties":{"status":{"$ref":"#/components/schemas/Status"},"result":{"type":"object","required":["window","data"],"properties":{"window":{"$ref":"#/components/schemas/Window_DBH"},"data":{"type":"array","items":{"type":"object","required":["market_cap"],"properties":{"blockheight":{"$ref":"#/components/schemas/Blockheight"},"date":{"$ref":"#/components/schemas/Date"},"datetime":{"$ref":"#/components/schemas/Datetime"},"market_cap":{"type":"decimal","description":"Market capitalization of ETH, calculated by circulating_supply * price_usd_close."}}}}}}}},"Status":{"type":"object","description":"The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.","properties":{"code":{"type":"integer","format":"int32","description":"HTTP status code"},"message":{"type":"string","description":"Text description of the error or success."}},"required":["code","message"]},"Window_DBH":{"type":"string","description":"The size of window. It can be day, hour, or block, and it depends on the user request."},"Blockheight":{"type":"string","description":"The height of the block. This optional field only appears when window=block is used."},"Date":{"type":"string","description":"The date in YYYY-DD-MM. This optional field only appears when window=day is used."},"Datetime":{"type":"string","description":"The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used."}}},"paths":{"/eth/market-data/capitalization":{"get":{"tags":["ETH Market Data"],"summary":"Capitalization","description":"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. \n","operationId":"ETHgetCapitalization","parameters":[{"$ref":"#/components/parameters/window_dbh"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/format"}],"responses":{"200":{"$ref":"#/components/responses/responses_Capitalization"}}}}}}
```