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

© 2026 Gemini Space Station, Inc.

List Candles

REST APIsTradingMarket 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 May 5, 2026