---
title: "Taker Buy Sell"
method: GET
path: "/api/v1/market-intelligence/taker-buy-sell"
tags: ["Market Intelligence"]
---

# Taker Buy Sell

`GET /api/v1/market-intelligence/taker-buy-sell`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/market-intelligence/taker-buy-sell`
- Auth: API key in header `X-API-Key`

Taker buy/sell volume ratio by exchange, per coin (4h window).

``buy_ratio`` is a PERCENT (0..100) of taker volume that was buying, per
exchange leg. Two legs exist: ``Binance`` (BTC only, from its public
taker-volume endpoint) and, since 2026-09-09, ``Hyperliquid`` — the
collector's own trade tape (see ``/hyperliquid/trade-flow``), notional
weighted over the trailing 4h, for every HL perp with fills. A coin only
HL carries gets its own top-level entry whose aggregate is the HL figure.
No Hyperliquid leg at all means the tape is warming or the pull is not
configured — never that HL had no trades.

## Query parameters

- `symbol` string: Filter by symbol (BTC, ETH, SOL, DOGE, XRP, ADA). Omit for all.

## Response `200`

Successful Response

- MarketIntelligenceDataResponse: Generic market intelligence data wrapper.
  - `data` unknown, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)