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
        Get TickerGet Current Order BookList Trades
      Candlestick Data
    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

Get Current Order Book

TradingMarket DataGet Current Order Book

Get Current Order Book

GEThttps://api.gemini.com/v1/book/{symbol}

This will return the current order book as two arrays (bids / asks).

Note

The quantities and prices returned are returned as strings rather than numbers. The numbers returned are exact, not rounded, and it can be dangerous to treat them as floating point numbers.

GETv1/book/BTCUSD
curl --request GET \
  --url https://api.gemini.com/v1/book/BTCUSD

Path Parameters

symbolstring·required
Trading pair symbol BTCUSD, etc. See symbols and minimums.

Query Parameters

limit_bidsnumber
Limit the number of bid (offers to buy) price levels returned. Default is 50. May be 0 to return the full order book on this side.
limit_asksnumber
Limit the number of ask (offers to sell) price levels returned. Default is 50. May be 0 to return the full order book on this side.

Responses

The response will be two arrays. The bids and the asks are grouped by price, so each entry may represent multiple orders at that price. Each element of the array will be a JSON object.

bidsarray
The bid price levels currently on the book. These are offers to buy at a given price.
bids[].pricestring (decimal)
The price
bids[].amountstring (decimal)
The total quantity remaining at the price
bids[].timestampstring
**DO NOT USE** - this field is included for compatibility reasons only and is just populated with a dummy value.
asksarray
The ask price levels currently on the book. These are offers to sell at a given price.
asks[].pricestring (decimal)
The price
asks[].amountstring (decimal)
The total quantity remaining at the price
asks[].timestampstring
**DO NOT USE** - this field is included for compatibility reasons only and is just populated with a dummy value.
Example Responses
{
  "bids": [
    {
      "price": "3607.85",
      "amount": "6.643373",
      "timestamp": "1547147541"
    }
  ],
  "asks": [
    {
      "price": "3607.86",
      "amount": "14.68205084",
      "timestamp": "1547147541"
    }
  ]
}
PreviousList Derivative CandlesNextList Trades