---
title: "Futures candles"
method: GET
path: "/api/futures/exchange-data/candles"
tags: ["Futures · Market data"]
---

# Futures candles

`GET /api/futures/exchange-data/candles`

## Request

- Base URL: `https://api.binibit.com`
- URL: `https://api.binibit.com/api/futures/exchange-data/candles`
- Auth: none declared

OHLCV for a futures pair. `volume` is turnover in the quote asset; `volumeBase` is
            quantity in the base asset.

## Query parameters

- `DateFrom` string, date-time
- `DateTo` string, date-time
- `CurrencyPair` string
- `CandleTimePeriod` 60 | 180 | 300 | 900 | 1800 | 3600 | 14400 | 28800 | 86400 | 604800 | 2592000: Candle interval. The numeric value IS the interval in seconds, so no lookup table is needed — and note the last one is a flat 30 days, not a calendar month.

## Response `200`

OK

- FuturesCandleDto[]
  - `currencyPairCode` string, nullable: Pair this candle belongs to, e.g. `BTC_USDT`.
  - `openPrice` number, double: Price of the first trade in the interval.
  - `closePrice` number, double: Price of the last trade in the interval. Still moving while the candle is the current one.
  - `maxPrice` number, double: Highest traded price in the interval.
  - `minPrice` number, double: Lowest traded price in the interval.
  - `candleTimePeriod` 60 | 180 | 300 | 900 | 1800 | 3600 | 14400 | 28800 | 86400 | 604800 | 2592000: Candle interval. The numeric value IS the interval in seconds, so no lookup table is needed — and note the last one is a flat 30 days, not a calendar month.
  - `volume` number, double: Turnover in the QUOTE asset — every trade's size times its price. This is the money figure; PublicApi.Models.Futures.FuturesCandleDto.VolumeBase is the quantity one.
  - `volumeBase` number, double: Quantity traded in the BASE asset — the plain sum of trade sizes, with no price applied.
  - `openTimestamp` string, date-time: Start of the interval (UTC), aligned to the period.
  - `closeTimestamp` string, date-time: End of the interval (UTC) — the open plus the period.

## Changes

- **2026-10-13** `13dbac1613c4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/binibit/apis/webapp/changes/api/futures/exchange-data/candles/get.md)

---

[API](https://skmtc.dev/binibit/apis/webapp.md) - [All operations](https://skmtc.dev/binibit/apis/webapp/llms.txt) - [OpenAPI document](https://skmtc.dev/binibit/apis/webapp/revisions/13dbac1613c4?raw)