Gemini Crypto Exchange Logo
Examples

Market Data Responses

These are some examples of FIX market data sent from GEMINIMKT to TESTMKT001 with price, liquidity, and trade information. Note that this is public data, so no assumption about the trade’s counterparty should be made.


Full Snapshot

The initial response to a Market Data Request <V> is a Market Data - Snapshot / Full Refresh <W> message containing a full snapshot of current state.

HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 19924
       34                     MsgSeqNum: 4
       35                       MsgType: MarketDataSnapshotFullRefresh (W)
       49                  SenderCompID: GEMINIMKT
       52                   SendingTime: 20180121-03:48:39.102
       56                  TargetCompID: TESTMKT001
BODY
       55                        Symbol: ETHBTC
      262                       MDReqID: 39
      268                   NoMDEntries: count = 685
      269                   MDEntryType: BID (0)
      270                     MDEntryPx: 0.00001
      271                   MDEntrySize: 10111
      ----
      269                   MDEntryType: BID (0)
      270                     MDEntryPx: 0.08989
      271                   MDEntrySize: 8.918
      ----
      269                   MDEntryType: BID (0)
      270                     MDEntryPx: 0.0899
      271                   MDEntrySize: 8.8828
      ----
      269                   MDEntryType: OFFER (1)
      270                     MDEntryPx: 0.09032
      271                   MDEntrySize: 45.134
      ----
      269                   MDEntryType: OFFER (1)
      270                     MDEntryPx: 0.09049
      271                   MDEntrySize: 1.2
      ----
      269                   MDEntryType: OFFER (1)
      270                     MDEntryPx: 1000.00000
      271                   MDEntrySize: 3
TRAILER
       10                      CheckSum: 084
txt

Quantity

Adding Quantity For a Given Price

This message shows a new bid for 2.8749 ETH priced at 988.88 USD.

HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 125
       34                     MsgSeqNum: 5696449
       35                       MsgType: MarketDataIncrementalRefresh (X)
       49                  SenderCompID: GEMINIMKT
       52                   SendingTime: 20180123-04:07:42.101
       56                  TargetCompID: TESTMKT001
BODY
      262                       MDReqID: 40
     9008                       EventId: 123456789
      268                   NoMDEntries: count = 1
       55                        Symbol: ETHUSD
      269                   MDEntryType: BID (0)
      270                     MDEntryPx: 988.88
      271                   MDEntrySize: 2.8749
      279                MDUpdateAction: NEW (0)
TRAILER
       10                      CheckSum: 187
txt

Changing Quantity For a Given Price

This message shows a new offer for 0.20503505 BTC available at price 10949.04 USD.

HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 131
       34                     MsgSeqNum: 5696384
       35                       MsgType: MarketDataIncrementalRefresh (X)
       49                  SenderCompID: GEMINIMKT
       52                   SendingTime: 20180123-04:07:40.057
       56                  TargetCompID: TESTMKT001
BODY
      262                       MDReqID: 38
     9008                       EventId: 123456789
      268                   NoMDEntries: count = 1
       55                        Symbol: BTCUSD
      269                   MDEntryType: OFFER (1)
      270                     MDEntryPx: 10949.04
      271                   MDEntrySize: 0.20503505
      279                MDUpdateAction: CHANGE (1)
TRAILER
       10                      CheckSum: 199
txt

Removing Quantity For a Given Price

This message shows an ETHBTC bid priced at 0.09156 BTC being removed.

HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 115
       34                     MsgSeqNum: 5696454
       35                       MsgType: MarketDataIncrementalRefresh (X)
       49                  SenderCompID: GEMINIMKT
       52                   SendingTime: 20180123-04:07:42.279
       56                  TargetCompID: TESTMKT001
BODY
      262                       MDReqID: 39
     9008                       EventId: 123456789
      268                   NoMDEntries: count = 1
       55                        Symbol: ETHBTC
      269                   MDEntryType: BID (0)
      270                     MDEntryPx: 0.09156
      279                MDUpdateAction: DELETE (2)
TRAILER
       10                      CheckSum: 197
txt

Trades

This message provides information about a new trade and a corresponding offer deletion. This message implies that the incoming order was a bid because the standing offer priced at 10907.54 USD was deleted.

HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 166
       34                     MsgSeqNum: 5696411
       35                       MsgType: MarketDataIncrementalRefresh (X)
       49                  SenderCompID: GEMINIMKT
       52                   SendingTime: 20180123-04:07:40.740
       56                  TargetCompID: TESTMKT001
BODY
      262                       MDReqID: 38
     9008                       EventId: 123456789
      268                   NoMDEntries: count = 2
       55                        Symbol: BTCUSD
      269                   MDEntryType: TRADE (2)
      270                     MDEntryPx: 10907.54
      271                   MDEntrySize: 0.00059578
      279                MDUpdateAction: NEW (0)
     ----
       55                        Symbol: BTCUSD
      269                   MDEntryType: OFFER (1)
      270                     MDEntryPx: 10907.54
      279                MDUpdateAction: DELETE (2)
TRAILER
       10                      CheckSum: 209
txt

Showing Maker Side

To enable showing the maker side of trades, create a Market Data Request <V> with custom field EnableMDEntryMakerSide <9003> enabled - see Examples: Request to enable maker side on trades.

Offer Hit Standing Bid

This example shows a trade where an incoming offer hit a standing bid at for 0.001 BTC at 7544.94 USD.

RAW
8=FIX.4.4|9=125|35=X|34=3|49=GEMINI|52=20180809-15:59:16.698|56=TRADEBOTMD002|262=2|9008=123456789|268=1|279=0|269=2|55=BTCUSD|270=7544.94|271=0.001|9002=1|10=107|

HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 125
       34                     MsgSeqNum: 3
       35                       MsgType: MarketDataIncrementalRefresh (X)
       49                  SenderCompID: GEMINI
       52                   SendingTime: 20180809-15:59:16.698
       56                  TargetCompID: TRADEBOTMD002
BODY
      262                       MDReqID: 2
     9008                       EventId: 123456789
      268                   NoMDEntries: count = 1
       55                        Symbol: BTCUSD
      269                   MDEntryType: TRADE (2)
      270                     MDEntryPx: 7544.94
      271                   MDEntrySize: 0.001
      279                MDUpdateAction: NEW (0)
     9002              MDEntryMakerSide: BUY (1)
TRAILER
       10                      CheckSum: 107
txt

Bid Lifted Standing Offer

This example shows a trade where an incoming bid lifted a standing offer at for 0.001 BTC at 7549.89 USD.

RAW
8=FIX.4.4|9=125|35=X|34=3|49=GEMINI|52=20180809-15:59:22.882|56=TRADEBOTMD002|262=2|9008=123456789|268=1|279=0|269=2|55=BTCUSD|270=7549.89|271=0.001|9002=2|10=109|

HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 125
       34                     MsgSeqNum: 3
       35                       MsgType: MarketDataIncrementalRefresh (X)
       49                  SenderCompID: GEMINI
       52                   SendingTime: 20180809-15:59:22.882
       56                  TargetCompID: TRADEBOTMD002
BODY
      262                       MDReqID: 2
     9008                       EventId: 123456789
      268                   NoMDEntries: count = 1
       55                        Symbol: BTCUSD
      269                   MDEntryType: TRADE (2)
      270                     MDEntryPx: 7549.89
      271                   MDEntrySize: 0.001
      279                MDUpdateAction: NEW (0)
     9002              MDEntryMakerSide: SELL (2)
TRAILER
       10                      CheckSum: 109
txt

Rejections

Rejected Symbol

RAW
8=FIX.4.4|9=67|35=Y|34=2|49=GEMINIMKT|52=20180511-21:37:57.971|56=TESTMKT001|262=badsym|281=0|10=038|

HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 67
       34                     MsgSeqNum: 2
       35                       MsgType: MarketDataRequestReject (Y)
       49                  SenderCompID: GEMINIMKT
       52                   SendingTime: 20180511-21:37:57.971
       56                  TargetCompID: TESTMKT001
BODY
      262                       MDReqID: badsym
      281                MDReqRejReason: UNKNOWN_SYMBOL (0)
TRAILER
       10                      CheckSum: 03
txt

Rejected MD Entry Type

RAW
8=FIX.4.4|9=70|35=Y|34=2|49=GEMINIMKT|52=20180511-21:44:14.765|56=TESTMKT001|262=badmd|281=8|10=121|
HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 70
       34                     MsgSeqNum: 2
       35                       MsgType: MarketDataRequestReject (Y)
       49                  SenderCompID: GEMINIMKT
       52                   SendingTime: 20180511-21:44:14.765
       56                  TargetCompID: TESTMKT001
BODY
      262                       MDReqID: badmd
      281                MDReqRejReason: UNSUPPORTED_MDENTRYTYPE (8)
TRAILER
       10                      CheckSum: 121
txt

Rejected Subscription Request

RAW
8=FIX.4.4|9=67|35=Y|34=2|49=GEMINIMKT|52=20180514-13:59:56.187|56=TESTMKT001|262=badsub|281=4|10=048|

HEADER
        8                   BeginString: FIX.4.4
        9                    BodyLength: 67
       34                     MsgSeqNum: 2
       35                       MsgType: MarketDataRequestReject (Y)
       49                  SenderCompID: GEMINIMKT
       52                   SendingTime: 20180514-13:59:56.187
       56                  TargetCompID: TESTMKT001
BODY
      262                       MDReqID: badsub
      281                MDReqRejReason: UNSUPPORTED_SUBSCRIPTIONREQUESTTYPE (4)
TRAILER
       10                      CheckSum: 048
txt