GeminiGemini
SandboxGet API key
  • Crypto Trading
  • Prediction Markets
Changelog
Gemini Crypto Exchange LogoGemini Crypto Exchange Logo

© 2026 Gemini Space Station, Inc.

REST APIs
    Orders
    Market Data
      List SymbolsGet Symbol DetailsGet TickerList CandlesList Derivative CandlesList Fee PromosGet Current Order BookList TradesList PricesFX RateGet Assets for NetworkGet Network
    Derivatives
    Margin Trading
    Staking
    Clearing
    Instant Orders
WebSocket
    AuthenticationMessage Format
    Streams
      Book TickerL2 Partial DepthL2 Differential DepthTrade StreamOrder EventsBalance Updates
    Playground
      Overviewconninfopingtimesubscribeunsubscribelist_subscriptionsdepthorder.placeorder.cancelorder.cancel_allorder.cancel_session
Agentic
FIX

List Derivative Candles

TradingMarket DataList Derivative Candles

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

Responses

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
Example Responses
[
  [
    1714126740000,
    68038,
    68038,
    68038,
    68038,
    0
  ],
  [
    1714126680000,
    68038,
    68038,
    68038,
    68038,
    0
  ]
]
PreviousList CandlesNextList Fee Promos
Last modified on April 29, 2026