> For the complete documentation index, see [llms.txt](https://docs.unblinked.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unblinked.com/faq/data/dataset.md).

# Dataset

Check [data list](/faq/data/dataset/data-list.md) to see the list of all data names.

## Interval data

Interval data are the collections of the data with the regular interval. Whole data here can be accessed by [**importing data**](/analytics/create-chart/function/1.-how-to-import-data.md) at the [analytics function mode](/analytics/create-chart/function/1.-how-to-import-data.md) or by using methods such as **get\_raw\_data** at the [analytics python mode](/analytics/create-chart/python/2.-how-to-analyze-data/how-to-write-python.md#how-to-get-market-data) and [terminal](/terminal/create-bot-strategy.md).

## 1. CEX data

CEX data is a collection of dataset from the **centralized exchanges** such [Binance](https://binance.com) and [OKX](https://okx.com). Most of it are the market data of each exchange. For example, **candlestick** data, which have open, high, low, close price, and volume could be one of the data you will be accessing most. Or you could require **funding\_history** to track the history of the funding rates of a symbol in the perpetual swap.

Whenever you try to access the data, there are four arguments required: **data\_name**, **symbol**, **start\_time**, and **end\_time**.

* **data\_name**

The name of the dataset. Usually, it contains the information of the exchange or market, dataset type, and interval. For example, **binance\_um\_futures\_mark\_candlestick\_1h** means 1 hour-interval candlestick data of the mark price in the Binance USD-M futures market.

* **symbol**

symbol is a sub-category in the dataset. Usually it corresponds to the symbol in the market or the asset name in the dataset. For example, to get the daily BTC/USDT price in the Binance spot market, then you have to set the symbol as **BTCUSDT** with the data\_name as binance\_candlestick\_1d. 

Beware that the rules of the symbol argument can be varied by the exchanges. For instance, if you want to require BTC/USDT data in OKX, you may have to write symbol as **BTC-USDT**.

In the function mode, you will set data\_name and symbol at the [select data](/analytics/create-chart/function/1.-how-to-import-data/select-data.md) step

* **start\_time** & **end\_time**

start\_time and end\_time is a time range of the data you require. Both of them should not be empty.

 In the function mode, you'll be setting them at the [select time range](/analytics/create-chart/function/1.-how-to-import-data/select-time-range.md) step. On the other hand, you'll be setting them as the **strings** in `yyyy-MM-dd HH:mm:ss` format. You can easily set them by using `strftime` in `datetime` library.

```python
# string representing now in yyyy-MM-dd HH:mm:ss format
datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')

# 60 day ago from now. using '%F %T' returns same as above.
(datetime.datetime.now() - datetime.timedelta(days=60)).strftime('%F %T')
```

### 1-1. Binance spot

#### - Binance spot candlestick

Candlestick data of the Binance spot market.

data\_name:

binance\_candlestick\_1d, binance\_candlestick\_1h and binance\_candlestick\_5min

**symbol:**

BTCUSDT, ETHUSDT, XRPBUSD, 1INCHBTC and etc.

<table><thead><tr><th width="253">values</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong> - Candlestick prices.</td></tr><tr><td><strong>base_volume</strong></td><td>Volume in base asset. In BTCUSDT, it is the sum of trades in BTC.</td></tr><tr><td><strong>quote_volume</strong></td><td>Volume in quote asset. In BTCUSDT, it is the sum of the trades in USDT. - The sum of buys in base asset.</td></tr><tr><td><strong>buy_base_volume</strong></td><td>The sum of buys in base asset.</td></tr><tr><td><strong>buy_quote_volume</strong></td><td>The sum of buys in quote asset.</td></tr><tr><td><strong>trade_count</strong></td><td>The number of the trades.</td></tr></tbody></table>

### 1-2. Binance USD-M futures

#### - Binance USD-M futures candlestick

Candlestick data of the Binance USD-M futures market.

**data\_name:**

binance\_um\_futures\_candlestick\_1d, binance\_um\_futures\_candlestick\_1h and binance\_um\_futures\_candlestick\_5min

**symbol:**

BTCUSDT, BTCUSDT\_230929, ETHBUSD and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>Candlestick prices.</td></tr><tr><td><strong>base_volume</strong></td><td>Volume in base asset. In BTCUSDT, it is the sum of trades in BTC.</td></tr><tr><td><strong>quote_volume</strong></td><td>Volume in quote asset. In BTCUSDT, it is the sum of the trades in USDT.</td></tr><tr><td><strong>buy_base_volume</strong></td><td>The sum of buys in base asset.</td></tr><tr><td><strong>buy_quote_volume</strong></td><td>The sum of buys in quote asset.</td></tr><tr><td><strong>trade_count</strong></td><td>The number of the trades.</td></tr></tbody></table>

#### - Binance USD-M futures index price

Index price data of the Binance USD-M futures market.

**data\_name:**

binance\_um\_futures\_index\_price\_1d, binance\_um\_futures\_index\_price\_1h and binance\_um\_futures\_index\_price\_5min

**symbol:**

BTCUSDT, BTCUSDT\_230929, ETHBUSD and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>OHLC of the index prices.</td></tr></tbody></table>

####

#### - Binance USD-M futures mark price

Mark price data of the Binance USD-M futures market.

**data\_name:**

binance\_um\_futures\_mark\_candlestick\_1d, binance\_um\_futures\_mark\_candlestick\_1h and binance\_um\_futures\_mark\_candlestick\_5min

**symbol:**

BTCUSDT, BTCUSDT\_230929, ETHBUSD and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>OHLC of the mark prices.</td></tr></tbody></table>

####

#### - Binance USD-M futures funding rate history

Funding history data of the Binance USD-M futures market.

**data\_name:**

binance\_um\_futures\_funding\_history

**symbol:**

BTCUSDT, 1000LUNCUSDT, ETHBUSD and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>funding_rate</strong></td><td>The rate of the funding fee. If it is positive, then it means that the long positions pay fee to the short positions.</td></tr></tbody></table>

#### - Binance USD-M futures open interest

Open interest data of Binance USD-M futures market

**data\_name:**

binance\_um\_futures\_open\_interest\_1d, binance\_um\_futures\_open\_interest\_1h, and binance\_um\_futures\_open\_interest\_5min

**symbol:**

BTCUSDT, 1000LUNCUSDT, XRPBUSD and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open_interest</strong></td><td>The size of open positions. Usually, the value of it is the <strong>base asset</strong> of the symbol.</td></tr><tr><td><strong>open_interest_value</strong></td><td> Open interest value in <strong>quote asset</strong> of the symbol.</td></tr></tbody></table>

#### - Binance USD-M futures Long/Short ratio by accounts

Long/Short ratio data by the number of accounts of the Binance USD-M futures market.

**data\_name:**

binance\_um\_futures\_long\_short\_ratio\_by\_account\_1d, binance\_um\_futures\_long\_short\_ratio\_by\_account\_1h and binance\_um\_futures\_long\_short\_ratio\_by\_account\_5min

**symbol:**

BTCUSDT, BTCUSDT\_230929, ETHBUSD and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>_long</strong></td><td>The ratio of Long position ranged from 0 to 1.</td></tr></tbody></table>

#### - Binance USD-M futures Long/Short ratio by top traders accounts

Long/Short ratio data by the number of top traders accounts of the Binance USD-M futures market.

**data\_name:**

binance\_um\_futures\_long\_short\_ratio\_by\_top\_trader\_account\_1d, binance\_um\_futures\_long\_short\_ratio\_by\_top\_trader\_account\_1h and binance\_um\_futures\_long\_short\_ratio\_by\_top\_trader\_account\_5min

**symbol:**

BTCUSDT, BTCUSDT\_230929, ETHBUSD and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>_long</strong></td><td>The ratio of Long position ranged from 0 to 1.</td></tr></tbody></table>

#### - Binance USD-M futures Long/Short ratio by top traders positions

Long/Short ratio data by the sum of  the open positions of the top traders of the Binance USD-M futures market.

**data\_name:**

binance\_um\_futures\_long\_short\_ratio\_by\_top\_trader\_position\_1d, binance\_um\_futures\_long\_short\_ratio\_by\_top\_trader\_position\_1h and binance\_um\_futures\_long\_short\_ratio\_by\_top\_trader\_position\_5min

**symbol:**

BTCUSDT, BTCUSDT\_230929, ETHBUSD and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>_long</strong></td><td>The ratio of Long position ranged from 0 to 1.</td></tr></tbody></table>

### 1-3. Binance COIN-M futures

#### - Binance COIN-M futures candlestick

Candlestick data of the Binance COIN-M futures market.

**data\_name:**

binance\_cm\_futures\_candlestick\_1d, binance\_cm\_futures\_candlestick\_1h and binance\_cm\_futures\_candlestick\_5min

**symbol:**

BTCUSD\_PERP, XRPUSD\_230929, ETHUSD\_PERP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>Candlestick prices.</td></tr><tr><td><strong>base_volume</strong></td><td>Volume in base asset. In BTCUSD_PERP, it is the sum of trades in BTC.</td></tr><tr><td><strong>cont_volume</strong></td><td>Volume in contracts. In BTCUSD_PERP, since 1 cont is same as 100USD, <code>cont_volume * 100</code> is same as the volume in USD.</td></tr><tr><td><strong>buy_base_volume</strong></td><td>The sum of buys in base asset.</td></tr><tr><td><strong>cont_buy_volume</strong></td><td>The sum of buys in contracts.</td></tr><tr><td><strong>trade_count</strong></td><td>The number of the trades.</td></tr></tbody></table>

####

#### - Binance COIN-M futures index price

Index price data of the Binance COIN-M futures market. The symbol of it is actually a **pair**, which means that the symbol are made by **base asset** and **quote asset** only. For example, BTCUSD\_PERP doesn't work here.

**data\_name:**

binance\_cm\_futures\_index\_price\_1d, binance\_cm\_futures\_index\_price\_1h and binance\_cm\_futures\_index\_price\_5min

**symbol:**

BTCUSD, ETHUSD and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>OHLC of the index prices.</td></tr></tbody></table>

####

#### - Binance COIN-M futures mark price

Mark price data of the Binance COIN-M futures market.

**data\_name:**

binance\_cm\_futures\_mark\_candlestick\_1d, binance\_cm\_futures\_mark\_candlestick\_1h and binance\_cm\_futures\_mark\_candlestick\_5min

**symbol:**

BTCUSD\_PERP, XRPUSD\_230929, ETHUSD\_PERP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>OHLC of the mark prices.</td></tr></tbody></table>

#### - Binance COIN-M futures funding rate history

Funding history data of the Binance COIN-M futures market.

**data\_name:**

binance\_cm\_futures\_funding\_history

**symbol:**

BTCUSD\_PERP, ETHUSD\_PERP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>funding_rate</strong></td><td>The rate of the funding fee. If it is positive, then it means that the long positions pay fee to the short positions.</td></tr></tbody></table>

####

#### - Binance COIN-M futures open interest

Open interest data of Binance COIN-M futures market

**data\_name:**

binance\_cm\_futures\_open\_interest\_1d, binance\_cm\_futures\_open\_interest\_1h, and binance\_cm\_futures\_open\_interest\_5min

**symbol:**

BTCUSD\_PERP, XRPUSD\_230929, ETHUSD\_PERP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open_interest</strong></td><td>The size of open positions. The unit of the value is <strong>cont</strong>(contract). For example, 1 cont of <strong>BTCUSD_PERP</strong> is 100USD. If open_interest of it is 1500, then it means that <strong>1500 cont(=150000 USD)</strong> is the size of the open positions of BTCUSD_PERP. Cont varies by the symbols.</td></tr><tr><td><strong>open_interest_value</strong></td><td> Open interest value in <strong>base asset</strong> of the symbol. Unlike USD-M, it is in base asset.</td></tr></tbody></table>

#### - Binance COIN-M futures Long/Short ratio by accounts

Long/Short ratio data by the number of accounts of the Binance COIN-M futures market.

**data\_name:**

binance\_cm\_futures\_long\_short\_ratio\_by\_account\_1d, binance\_cm\_futures\_long\_short\_ratio\_by\_account\_1h and binance\_cm\_futures\_long\_short\_ratio\_by\_account\_5min

**symbol:**

BTCUSD\_PERP, XRPUSD\_230929, ETHUSD\_PERP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>_long</strong></td><td>The ratio of Long position ranged from 0 to 1.</td></tr></tbody></table>

#### - Binance COIN-M futures Long/Short ratio by top traders accounts

Long/Short ratio data by the number of top traders accounts of the Binance COIN-M futures market.

**data\_name:**

binance\_cm\_futures\_long\_short\_ratio\_by\_top\_trader\_account\_1d, binance\_cm\_futures\_long\_short\_ratio\_by\_top\_trader\_account\_1h and binance\_cm\_futures\_long\_short\_ratio\_by\_top\_trader\_account\_5min

**symbol:**

BTCUSD\_PERP, XRPUSD\_230929, ETHUSD\_PERP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>_long</strong></td><td>The ratio of Long position ranged from 0 to 1.</td></tr></tbody></table>

#### - Binance COIN-M futures Long/Short ratio by top traders positions

Long/Short ratio data by the sum of  the open positions of the top traders of the Binance COIN-M futures market.

**data\_name:**

binance\_cm\_futures\_long\_short\_ratio\_by\_top\_trader\_position\_1d, binance\_cm\_futures\_long\_short\_ratio\_by\_top\_trader\_position\_1h and binance\_cm\_futures\_long\_short\_ratio\_by\_top\_trader\_position\_5min

**symbol:**

BTCUSD\_PERP, XRPUSD\_230929, ETHUSD\_PERP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>_long</strong></td><td>The ratio of Long position ranged from 0 to 1.</td></tr></tbody></table>

#### - Binance COIN-M futures basis

Basis rate data of the Binance COIN-M futures market.

**data\_name:**

binance\_cm\_futures\_basis\_1d, binance\_cm\_futures\_basis\_1h and binance\_cm\_futures\_basis\_5min

**symbol:**

BTCUSD\_PERP, XRPUSD\_230929, ETHUSD\_PERP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>basis_rate</strong></td><td></td></tr><tr><td><strong>basis</strong></td><td></td></tr><tr><td><strong>annualized_basis_rate</strong></td><td></td></tr></tbody></table>

### 2-1. OKX spot

#### - OKX spot candlestick

Candlestick data of the OKX spot market.

**data\_name:**

okx\_candlestick\_1d, okx\_candlestick\_1h and okx\_candlestick\_5min

**symbol:**

BTC-USDT, ETH-USDT and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>Candlestick prices.</td></tr><tr><td><strong>base_volume</strong></td><td>Volume in base asset. In BTC-USDT, it is the sum of trades in BTC.</td></tr><tr><td><strong>quote_volume</strong></td><td>Volume in quote asset. In BTC-USDT, it is the sum of the trades in USDT.</td></tr></tbody></table>

### 2-2. OKX futures

{% hint style="info" %}
In the dataset, **futures** and **perpetual swap** markets in OKX are merged into the **okx\_futures**.
{% endhint %}

#### - OKX futures & perpetual swap candlestick

Candlestick data of the OKX futures & perpetual swap markets.

**data\_name:**

okx\_futures\_candlestick\_1d, okx\_futures\_candlestick\_1h and okx\_futures\_candlestick\_5min

**symbol:**

BTC-USDC-SWAP, BTC-USD-230414,  TRX-USD-SWAP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>Candlestick prices.</td></tr><tr><td><strong>base_volume</strong></td><td>Volume in base asset.</td></tr><tr><td><strong>quote_volume</strong></td><td>Volume in quote asset.</td></tr><tr><td><strong>cont_volume</strong></td><td>Volume in contracts.</td></tr></tbody></table>

#### - OKX index price

Index price data of the OKX. In actual OKX, the index price is not compared by the market types. But in UnBlinked, you can find it at **OKX futures** category.

**data\_name:**

okx\_futures\_index\_price\_1d, okx\_futures\_index\_price\_1h and okx\_futures\_index\_price\_5min

**symbol:**

BTC-USD,  XRP-USDT, SOL-USDT and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>OHLC of the index prices.</td></tr></tbody></table>

####

#### - OKX futures & perpetual swap mark price

Mark price data of the OKX futures & perpetual swap markets

**data\_name:**

okx\_futures\_mark\_price\_1d, okx\_futures\_mark\_price\_1h and okx\_futures\_mark\_price\_5min

**symbol:**

BTC-USDC-SWAP, BTC-USD-230414,  TRX-USD-SWAP and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>OHLC of the mark prices.</td></tr></tbody></table>

### 2-3. OKX option

#### - OKX option mark price

Mark price data of the OKX option market

**data\_name:**

okx\_option\_mark\_price\_1d, okx\_option\_mark\_price\_1h and okx\_option\_mark\_price\_5min

**symbol:**

BTC-USD-230408-26000-C, BTC-USD-230414-20000-P and etc.

<table><thead><tr><th width="249">value</th><th>description</th></tr></thead><tbody><tr><td><strong>time</strong></td><td></td></tr><tr><td><strong>open</strong>, <strong>high</strong>, <strong>low</strong> and <strong>close</strong></td><td>OHLC of the mark prices.</td></tr></tbody></table>

***

##