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 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

Example Responses
[
  [
    1714126740000,
    68038,
    68038,
    68038,
    68038,
    0
  ],
  [
    1714126680000,
    68038,
    68038,
    68038,
    68038,
    0
  ]
]
PreviousList CandlesNextGet Current Order Book