← THE CHARTSPOD LEDGEROPEN TERMINAL →
DATA · TAKER-BUY VOLUME TIMING

Crypto Taker-Buy Volume: Event Time vs Retrieval Time

Taker-buy volume arrives inside klines and in a separate ratio series. Each has its own time stamp and window convention.

By ChartsPod Editorial Team · Reviewed by ChartsPod Research
Published · Updated · 5 min read

Short answer

In Binance klines, taker-buy base and quote volume belong to the kline identified by its open time and ending at its close time; the live kline's taker volume is still growing. The separate takerlongshortRatio endpoint returns buyVol, sellVol and a timestamp per period for the latest 30 days. Align the two by window, not by when you fetched them, and record retrieval time to flag the live kline.

Which times the data carries

TimePresent?Meaning
Kline open/close timeYesWindow
Ratio period timestampYesPeriod
Retrieval timeNoRecord it
Live klineLast rowStill accumulating

Test Crypto Taker-Buy Volume on a perpetual chart; no account is needed to chart.

Launch ChartsPod

What to record yourself

Field to storeWhy
source (kline / ratio)Window convention
open time / timestampEvent key
retrieved_atLive detection
periodAlignment
unitBase or quote
Taker-Buy Volume: a stored recordTaker-Buy Volume: a stored record: source (kline / ratio) — Window convention; open time / timestamp — Event key; retrieved_at — Live detection; period — Alignment; unit — Base or quote.source (kline / ratio)Window conventionopen time / timestampEvent keyretrieved_atLive detectionperiodAlignmentunitBase or quote
Every taker-buy volume row carries its own clock. Original ChartsPod editorial graphic.

Example

Taker-Buy Volume: event vs retrieval (illustrative)Taker-Buy Volume: event vs retrieval (illustrative): 12:00: 5m kline opens; 12:03: Fetch: taker-buy 40 BTC so far; 12:05: Kline closes: 72 BTC; STORE: Mark 12:03 value as partial.12:005m kline opens12:03Fetch: taker-buy 40 BTC so far12:05Kline closes: 72 BTCSTOREMark 12:03 value as partial
Two clocks, one record. Original ChartsPod editorial graphic.

Illustrative: a dataset stored the 12:03 partial taker volume as the 12:00 bar's final value, understating buying by nearly half.

Related: Crypto Taker-Buy Volume: Null vs Zero - Handle Missing Fields Correctly, Binance Spot OHLCV: Event Time vs Retrieval Time.

Align the two by window, not by when you fetched them, and record retrieval time to flag the live kline.

See Crypto Taker-Buy Volume on live data in the free ChartsPod terminal.

Open the ChartsPod terminal

Questions readers ask

Which time does kline taker volume belong to?

The kline's open-to-close window.

Is the last kline final?

Usually not.

How do I align with the ratio endpoint?

By window period.

Sources and methodology

Field definitions come from DEX Screener's API reference and CoinGecko's onchain API documentation, read 17 October 2026. Where a schema doesn't document a timestamp, this guide says so and recommends recording retrieval time yourself.

  1. Binance: USD-M Futures market data API — trades, depth, funding and open interest.
  2. Binance: USD-M market data (long/short ratios, OI statistics, klines) — ratio definitions, 30-day retention, kline open/close time.

This article explains research tools and workflows. It is not financial advice, does not recommend buying or selling any asset and does not predict prices. Crypto derivatives carry a risk of rapid and total loss of margin.

CHARTSPOD EDITORIAL EDITION · RESEARCH AND EDUCATION ONLY · NOT FINANCIAL ADVICE.