Exchange

Download one hour of klines for an instrument as a Lastra segment

Same shape and semantics as /exchange/{exchangeId}/tickers/{base}/{quote}, but serves klines (aggregated bars) instead of raw ticks. One Lastra segment = one hour of klines at the exchange's native kline cadence, aligned to UTC.

Klines use the same columnar layout as tickers — readers that handle one format read the other with the same code. Use this endpoint when a per-tick payload would be too large for the window of interest.

get/exchange/{exchangeId}/klines/{base}/{quote}

Request

  • Base URL: https://api.qtsurfer.net/v1
  • URL: https://api.qtsurfer.net/v1/exchange/{exchangeId}/klines/{base}/{quote}
  • Auth: none declared

Path parameters

exchangeIdstring required
Example:binance

ID of the exchange (e.g. binance).

basestring required
Example:BTC

Base asset symbol.

quotestring required
Example:USDT

Quote asset symbol.

Query parameters

hourstring required
Example:2026-01-15T10

Hour selector in YYYY-MM-DDTHH (UTC). The returned segment covers [HH:00:00Z, HH+1:00:00Z).

format'lastra' | 'parquet'
Example:lastra

Response wire format. lastra (default) returns raw Lastra bytes. parquet returns Parquet via on-the-fly conversion.

Response

One hour of klines for the instrument. Content-Type is application/vnd.lastra by default or application/vnd.apache.parquet when format=parquet.

Changes

No operation changes recorded.