Accessing real-time and historical market data is essential for traders, developers, and analysts building applications in the cryptocurrency space. Gemini’s REST API offers a robust suite of endpoints designed to deliver accurate, up-to-date market information across spot and derivative trading pairs. Whether you're retrieving current price feeds, analyzing order books, or tracking funding rates for perpetual contracts, this guide breaks down the core functionalities of Gemini's Market Data API in a clear, developer-friendly format.
List Symbols
The List Symbols endpoint returns all tradable symbols available on Gemini. This is ideal for applications that need to dynamically update their list of supported trading pairs.
Endpoint: GET https://api.gemini.com/v1/symbols
Response:
Returns an array of strings representing active trading symbols such as btcusd, ethusd, and solusd. These symbols are foundational for interacting with other endpoints.
👉 Discover how real-time symbol data powers advanced trading strategies.
Get Symbol Details
For deeper insight into a specific trading pair, use the Get Symbol Details endpoint. It provides critical trading parameters necessary for order validation and precision.
Endpoint: GET https://api.gemini.com/v1/symbols/details/{symbol}
Path Parameter:
symbol(required): The trading pair, e.g.,btcusd.
Response Includes:
base_currency: The primary asset (e.g.,BTCinBTCUSD).quote_currency: The pricing currency (e.g.,USDinBTCUSD).tick_size: Decimal precision of the base currency (e.g.,1e-8for BTC).quote_increment: Price step size (e.g.,0.01for USD pairs).min_order_size: Minimum trade amount in base currency.status: Current trading status (open,closed,post_only, etc.).product_type: Distinguishes betweenspotandswapinstruments.contract_type: Specifies contract structure (linear,inverse, etc.).
This data ensures your application complies with exchange requirements and enhances user experience by preventing invalid order submissions.
Get Network
Understanding which blockchain networks support a given token is crucial for deposit and withdrawal operations.
Endpoint: GET https://api.gemini.com/v1/network/{token}
Path Parameter:
token: Token symbol (e.g.,BTC,ETH).
Response:
token: Requested token.network: Associated network(s), such asBitcoin,Ethereum, orSolana.
This endpoint supports multi-chain awareness in wallet integrations and custodial solutions.
Get Ticker
Retrieve real-time price data with the Get Ticker endpoint, perfect for dashboards and price alerts.
Endpoint: GET https://api.gemini.com/v1/pubticker/{symbol}
Response:
bid: Highest current buy price.ask: Lowest current sell price.last: Most recent executed trade price.volume: 24-hour trading volume object.
Ideal for monitoring market movements without polling full order books.
List Fee Promos
Stay informed about reduced-fee trading opportunities.
Endpoint: GET https://api.gemini.com/v1/feepromos
Response:
symbols: Array of trading pairs currently under fee promotions.
Use this to guide users toward cost-efficient trading options during promotional periods.
Get Current Order Book
Analyze market depth with bid and ask levels.
Endpoint: GET https://api.gemini.com/v1/book/{symbol}
Query Parameters:
limit_bids: Number of buy orders to return (default: 50).limit_asks: Number of sell orders to return (set to 0 for full book).
Response:
bids: Array of current buy offers.asks: Array of current sell offers.
This endpoint enables technical analysis tools, arbitrage detection, and liquidity monitoring.
👉 See how order book analytics can improve your trading decisions.
List Trades
Track recent executed trades for transparency and trend analysis.
Endpoint: GET https://api.gemini.com/v1/trades/{symbol}
Query Parameters:
timestamporsince: Filter trades after a specific time (90-day limit).since_tid: Filter by trade ID.limit_trades: Max number of trades (default: 50).include_breaks: Show canceled trades if true.
Response Fields:
tid: Unique trade ID.price,amount: Execution details.type: Direction (buyorsell).broken: Indicates if the trade was voided.
Useful for building trade history logs and sentiment indicators.
List Prices
Get a snapshot of all current prices across trading pairs.
Endpoint: GET https://api.gemini.com/v1/pricefeed
Response:
pair: Trading symbol.price: Current last traded price.percentChange24h: 24-hour price movement.
Perfect for portfolio trackers and market overview pages.
Get Funding Amount
Critical for perpetual swap traders, this endpoint returns funding rate details.
Endpoint: GET https://api.gemini.com/v1/fundingamount/{symbol}
Response:
fundingDateTime,fundingTimestampMilliSecs: When funding was applied.nextFundingTimestamp: Upcoming funding event.amount,estimatedFundingAmount: Current and projected funding payments.
Helps traders manage costs associated with long or short positions in perpetual contracts.
Get Funding Amount Report File
Download historical funding data in Excel format for deep analysis.
Endpoint: GET https://api.gemini.com/v1/fundingamountreport/records.xlsx
Query Parameters:
symbol: Required (e.g.,BTCGUSDPERP).fromDate,toDate: Date range filter.numRows: Max records to return (default: 8760).
Ideal for backtesting funding impact on strategy performance.
Get Ticker V2
Enhanced ticker data with historical OHLC and intraday trends.
Endpoint: GET https://api.gemini.com/v2/ticker/{symbol}
Response Adds:
open,high,low,close: 24-hour price range.changes: Hourly price array over past 24 hours.
Enables richer visualizations and volatility analysis.
List Candles
Access time-series data for technical analysis.
Endpoint: GET https://api.gemini.com/v2/candles/{symbol}/{time_frame}
Supported Time Frames:
1m, 5m, 15m, 30m, 1h, 6h, 1d
Each candle contains: [timestamp, open, high, low, close, volume]
Essential for charting libraries and algorithmic trading systems.
List Derivative Candles
Specialized candle data for perpetual swaps, currently limited to 1-minute intervals.
Endpoint: GET https://api.gemini.com/v2/derivatives/candles/{symbol}/1m
Same structure as standard candles but tailored for derivative instruments.
FX Rate
Retrieve historical foreign exchange rates used internally by Gemini for institutional reporting.
Endpoint: GET https://api.gemini.com/v2/fxrate/{symbol}/{timestamp}
Supported Pairs:
AUDUSD, EURUSD, GBPUSD, JPYUSD, and more.
Authentication Required: Auditor role API key with HMAC-SHA384 signature.
Note: For reference only — not suitable for live FX trading decisions.
Frequently Asked Questions
Q: What is the difference between tick_size and quote_increment?
A: tick_size refers to the base currency’s decimal precision (e.g., BTC), while quote_increment defines the smallest price change in the quote currency (e.g., USD).
Q: How often is the pricefeed updated?
A: The /v1/pricefeed endpoint updates frequently — typically within seconds of new trades — making it reliable for near real-time dashboards.
Q: Can I get full order book data?
A: Yes. Set limit_bids=0 and/or limit_asks=0 in the /v1/book/{symbol} request to retrieve the complete book.
Q: Are broken trades included by default?
A: No. Use the parameter include_breaks=true to include canceled trades in the response.
Q: Is there a rate limit on these endpoints?
A: While public endpoints generally allow high-frequency access, sustained aggressive polling may trigger throttling. Always implement backoff logic in production systems.
Q: Can I use FX Rate data for live trading?
A: No. This data is for historical reference only and does not reflect tradable FX rates.
👉 Unlock advanced market insights with powerful API-driven tools.
Core Keywords
market data API, cryptocurrency trading pairs, real-time price feed, order book depth, trading ticker data, funding rate API, historical candle data, REST API integration