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
    Fund Management API
    Instant Orders API
    WebSocket API
    FIX API
      Overview
      Order Entry
      Market Data
        Introduction
        Workflow
        Exchange-Bound Messages
        Client-Bound Messages
          Market Data Snapshot (Full Refresh)Market Data Incremental RefreshMarket Data Request RejectSymbol List
        Examples
        Identifiers
      Drop Copy
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
Client-Bound Messages

Market Data - Incremental Refresh <X>

The initial response to a Market Data Request <V> is a full snapshot of current state followed by multiple incremental update messages.

See Examples: Market Data Responses for examples of bids, offers, and trade events.


Fields

TagNameReqDescription
Standard HeaderYMsgType = X
262MDReqIDYUnique identifier of the Market Data Request <V> this message is in response to.
9008EventIdNEvent ID of the event causing the generation of the update in this message.
268NoMDEntriesYNumber of entries in this message.
⇒ 279MDUpdateActionYType of market data update.

Valid values:
0 = New
1 = Change
2 = Delete
⇒ 269MDEntryTypeYType of market data entry.

Valid values:
0 = Bid
1 = Offer
2 = Trade
R = MarkPrice
S = FundingAmount
⇒ 55SymbolNSymbol of market data entry.

Required when MDEntryType is not 3 = Index Value.
⇒ 270MDEntryPxYPrice of market data entry.
⇒ 271MDEntrySizeN*Quantity of market data entry.

*Required when MDEntryType is not 3 = Index Value.
⇒ 273MDEntryTimeN*The time that the most recent indicative price has been published.
⇒ 9002MDEntryMakerSideN*Custom field indicating the maker side of a trade. Enabled by sending a Market Data Request <V> with the custom field EnableMDEntryMakerSide <9003> set to TRUE. Appears when MDEntryType <269> has value 2 = Trade.

Valid values:
1 = Buy
2 = Sell

See Examples: Showing Maker Side For Trades.
⇒ 9009MDEntryFundingIsRealizedN*Custom field used in Market Data – Incremental Refresh <X> MDEntry groups when MDEntryType had the value S = Funding Amount to indicate the IsRealized field of Funding Amount.

Valid values:
Y = Yes
N = No
Standard TrailerY
Market Data Snapshot (Full Refresh)Market Data Request Reject
On this page
  • Fields