---
title: "Spot taker buy/sell imbalance"
method: GET
path: "/api/v1/taker-imbalance"
tags: ["History"]
---

# Spot taker buy/sell imbalance

`GET /api/v1/taker-imbalance`

## Request

- Base URL: `https://tradingstrategies.work`
- URL: `https://tradingstrategies.work/api/v1/taker-imbalance`
- Auth: HTTP bearer

Daily SPOT taker-buy share for a Binance pair: taker-buy volume divided by total volume, one value per UTC day (0..1; 0.5 = balanced aggressor flow, above 0.5 taker buys dominate). Derived ratio only — raw volumes are not redistributed. This is spot aggressor flow, NOT futures positioning; for leverage positioning use /api/v1/funding-rate. The forming day is excluded because its share still moves. Returns series ascending plus latest, window_mean and n_days. Window via `days`, tier-capped (Free 30d, Pro 365d, Power 3650d); the `range` block declares requested vs. granted.

## Query parameters

- `days` integer
- `pair` string

## Response `200`

Window container: series[] plus latest, n_days, range and tier echo.

- object

## Other responses

- `400`: Invalid input — fehlt Pflichtfeld oder Wert außerhalb des erlaubten Bereichs.
- `401`: Unauthenticated — kein gültiger Bearer-Token im Authorization-Header.
- `403`: Tier-Insufficient — Endpoint braucht höheren API-Tier. Response enthält upgrade_url.
- `404`: Not-Found — Resource existiert nicht oder gehört nicht dem aktuellen User.
- `429`: Rate-Limit überschritten — Tier-Quota (hourly/daily) oder Per-Endpoint-Quota erreicht. Retry-After-Header gesetzt.
- `500`: Internal Error.
- `503`: Upstream-Failure — Datenquelle nicht erreichbar (Binance, EODHD, etc.).

---

[API](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api.md) · [All operations](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/revisions/f82e8d6eecd7?raw)