v1

latestOpenAPI 3.0.02026-07-2224101.3 MB
BTC Market Data

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.

NameExchangeSymbolAvailable Since
All Exchangesall_exchangeThe earliest time in the exchanges below.
BinancebinanceBTC-USDT2019-09-08 17:57:00
BybitbybitBTC-USD2019-11-07 00:00:00
BitmexbitmexBTC-USD2015-09-25 12:34:00
DeribitderibitBTC-PERPETUAL2019-03-30 00:00:00
HTX Globalhtx_globalBTC-USD2020-03-28 00:00:00
OKXokxBTC-USD2019-03-30 00:00:00

📖 Data Guide: Taker Buy Sell Volume/Ratio — definition, interpretation, and chart examples.

get/btc/market-data/taker-buy-sell-stats

Query parameters

exchangestring required

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

windowstring

Currently we support day, hour, and min.

fromstring

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

tostring

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

limitinteger

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

formatstring

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

Response

Taker Buy, Sell volume and ratio