Market Data

Get OHLCV candles

GET/v1/trading/candle

Returns OHLCV candles (open, high, low, close, volume) of a market between startTime and endTime. No authentication is required. Sort by the timestamp ([0]) before plotting.

The last candle is the current one and is still changing. Intervals with no trades produce no candle, so the series can have gaps: fill them on the client if a continuous series is needed.

A request returns at most limit candles. To cover a longer range, split it into windows of limit * interval and request them one after another.

Query Parameters

symbol*string

Market as BASE/QUOTE.

Match^[A-Z0-9]+/[A-Z0-9]+$
interval*string

Candle duration in minutes (1, 5, 15, 30, 60, 240, 1440), or 1D for daily candles.

Value in

  • "1"
  • "5"
  • "15"
  • "30"
  • "60"
  • "240"
  • "1440"
  • "1D"
startTime?integer

Start of the range, in Unix epoch milliseconds. Defaults to 24 hours before the request.

Formatint64
endTime?integer

End of the range, in Unix epoch milliseconds. Defaults to now; a future value is treated as now.

Formatint64
limit?integer

Maximum number of candles. Default and documented maximum 1000.

Range1 <= value <= 1000
Default1000

Response Body

application/json

application/json

application/json

application/json

Get OHLCV candles
curl --request GET \  --url 'https://gateway.bit2me.com/v1/trading/candle?symbol=BTC%2FEUR&interval=60'
[  [    1712494800000,    69321.2,    69492,    69294.3,    69346.9,    1.58942378  ],  [    1712498400000,    69344.3,    69637.2,    69225.8,    69583.7,    8.52748622  ]]