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

***

##


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.unblinked.com/faq/data/dataset.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.