GeminiGemini
Demo environmentGet API key
  • Overview
  • Crypto Trading
  • Prediction Markets
  • Perpetuals
  • Stocks
  • API Reference
  • SDKs & Tools
Changelog
Gemini logoGemini logo

© 2026 Gemini Space Station, Inc.

Overview
Spot
    OverviewGet started
    Orders API
    Market Data API
      Symbols, Prices & Networks
      Tickers & Order Books
      Candlestick Data
        List CandlesList Derivative Candles
    Fund Management API
    Instant Orders API
    WebSocket API
    FIX API
Margin
    Overview
    Margin REST API
      Get Margin Account SummaryGet Margin Interest RatesPreview Margin Order Impact
Staking
    Overview
    Staking REST API
      List Staking BalancesStake Crypto FundsUnstake Crypto FundsList Staking Event HistoryList Staking RatesList Staking Rewards
Clearing
    Clearing REST API
      Clearing Orders
      Broker & Trade Operations

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

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