The Candles endpoint provides OCHL (Open, Close, High, Low) and volume data for the specified funding currency or trading pair. The endpoint provides the last 100 candles by default, but a limit and a start and/or end timestamp can be specified.

get/candles/{candle}/{section}

Request

  • Base URL
    https://api-pub.bitfinex.com/v2
  • URL
    https://api-pub.bitfinex.com/v2/candles/{candle}/{section}
  • Auth
    none required

Path parameters

candlestring required

Check Available candles table to understand how to compose this argument.

sectionstring required

Available values: "last", "hist".

Query parameters

sortinteger

+1: sort in ascending order | -1: sort in descending order (by MTS field).

startinteger

If start is given, only records with MTS >= start (milliseconds) will be given as response.

endinteger

If end is given, only records with MTS <= end (milliseconds) will be given as response.

limitinteger

Number of records in response (max. 10000).

Response

200

Changes

    • breaking

      for the query request parameter limit, default value 120 was added

    • breaking

      for the query request parameter sort, default value -1 was added