List Derivative Candles

GEThttps://api.gemini.com/v2/derivatives/candles/{symbol}/{time_frame}

This endpoint retrieves time-intervaled data for the provided perpetual symbol.

GETv2/derivatives/candles/BTCGUSDPERP/1m

curl --request GET \
  --url https://api.gemini.com/v2/derivatives/candles/BTCGUSDPERP/1m

Path Parameters

symbolstring·required

Trading pair symbol. Available only for perpetual pairs like BTCGUSDPERP

time_framestring·enum·required

Time range for each candle. 1m: 1 minute (only)Enum values: 1m

The response will be an array of arrays

Candlearray

Example: 1559755800000,7781.6,7820.23,7776.56,7819.39,34.7624802159,1559755800000,7781.6,7829.46,7776.56,7817.28,43.4228281059

Last modified on May 5, 2026