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 Candles

TradingMarket DataList Candles

List Candles

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

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

GETv2/candles/BTCUSD/15m
curl --request GET \
  --url https://api.gemini.com/v2/candles/BTCUSD/15m

Path Parameters

symbolstring·required
Trading pair symbol
time_framestring·enum·required
Time range for each candle: 1m - 1 minute 5m - 5 minutes 15m - 15 minutes 30m - 30 minutes 1h - 1 hour 6h - 6 hours * 1day - 1 dayEnum values: 1m5m15m30m1h6h1d

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
[
  [
    1559755800000,
    7781.6,
    7820.23,
    7776.56,
    7819.39,
    34.7624802159
  ],
  [
    1559755800000,
    7781.6,
    7829.46,
    7776.56,
    7817.28,
    43.4228281059
  ]
]
PreviousGet TickerNextList Derivative Candles
Last modified on April 29, 2026