---
title: "Taker Buy Sell Stats"
method: GET
path: "/xrp/market-data/taker-buy-sell-stats"
tags: ["XRP Market Data"]
---

# Taker Buy Sell Stats

`GET /xrp/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.
| Name           |   Exchange     | Symbol |
|----------------|--------------|----|
| All Exchanges  |   `all_exchange` | `all_symbol`* |
| Binance        |   `binance`  | `xrp_usdt`*  |
| Bybit          |   `bybit`    | `xrp_usd`* | 
| Bitmex         |   `bitmex`   | `xrp_usd`* | 
| HTX Global   |   `htx_global` | `xrp_usd`*  | 
| OKX            |   `okx`     | `xrp_usd`* |

**📖 Data Guide:** [Taker Buy Sell Volume/Ratio](/data-guide/market/taker-buy-sell-volume-ratio) — definition, interpretation, and chart examples.

## Query parameters

- `exchange` string, required
- `window` string
- `from` string
- `to` string
- `limit` integer
- `format` string

## Response `200`

Taker Buy, Sell volume and ratio

- object
  - `status` object, required — 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.
    - `code` integer, required — HTTP status code
    - `message` string, required — Text description of the error or success.
  - `result` object, required
    - `window` string, required — The size of window. It can be day, hour, or min and it depends on the user request.
    - `data` object[], required
      - `date` string — The date in YYYY-DD-MM. This optional field only appears when window=day is used.
      - `datetime` string — The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used.
      - `taker_buy_volume` number, required — Volume that takers buy in the given period and exchange.
      - `taker_sell_volume` number, required — Volume that takers sell in the given period and exchange.
      - `taker_buy_ratio` number, required — 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` number, required — 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` number, required — The ratio fo taker buy volume to taker sell volume in the given period and exchange.

---

[API](https://skmtc.net/cryptoquant/apis/cryptoquant-data-api.md) · [All operations](https://skmtc.net/cryptoquant/apis/cryptoquant-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cryptoquant/cryptoquant-data-api/versions/81ee223d4908/schema)