Differences

This shows you the differences between two versions of the page.

--- developers:apiv2:markets [2026/09/07 18:05] – [Market Data] chad
+++ developers:apiv2:markets [2026/09/07 18:16] (current) – [What you receive] chad
@@ Line 3: / Line 3: @@
 [[developers:apiv2|◀ WebSocket API (V2)]]
-Send a ''[[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L9|MarketSubscribe]]'' message in order to subscribe for market data. You may have multiple active market subscriptions (up to the subscription limit set for your user.)
+Send a [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L9|MarketSubscribe]] message in order to subscribe for market data. You may have multiple active market subscriptions (up to the subscription limit set for your user.)
 ^ Feed ^ Description ^
@@ Line 30: / Line 30: @@
 </code>
-The [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/common/enums.proto#L95|Quotes enum]]**''quotes''** (''Quotes'' enum) selects the market data feed:
+The [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/common/enums.proto#L95|Quotes]] enum selects the market data feed:
 ^ Value ^ You receive ^
-| ''QUOTES_NONE'' | Nothing — **unsubscribes** the market. |
+| ''QUOTES_NONE'' | **Unsubscribes** the market |
-| ''QUOTES_TOP_OF_BOOK'' | Best bid / best offer only, as ''MarketDepth''. |
+| ''QUOTES_TOP_OF_BOOK'' | Best bid / best offer (TOB) market depth feed |
-| ''QUOTES_FULL_ORDER_BOOK'' | Full depth ladder (volume aggregated per price), as ''MarketDepth''. |
+| ''QUOTES_FULL_ORDER_BOOK'' | Top-10 bids and offfers (FOB) market depth feed |
-| ''QUOTES_MARKET_BY_ORDER'' | Every individual resting order, as ''MarketByOrder*''. |
+| ''QUOTES_MARKET_BY_ORDER'' | Market by order (MBO) feed |
-**''ticker''** — when true, trade prints stream as ''MarketTrade'' messages.
+**''ticker''** — when true, trade prints stream as [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L119|MarketTrade]] messages.
-**Unsubscribe** — resend ''MarketSubscribe'' for the same market with ''quotes: QUOTES_NONE''.
+**Unsubscribe** — Send a [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L9|MarketSubscribe]] for the same market with ''quotes: QUOTES_NONE''.
-===== What you receive =====
+===== What You Receive =====
 **Quote Feed** (''TOP_OF_BOOK'' / ''FULL_ORDER_BOOK''):
-  * ''MarketSnapshot'' — full current state on subscribe (bundles depth, trades, high/low, price limits, settlement).
+  * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L190|MarketSnapshot]] — full current state on subscribe (bundles depth, trades, high/low, price limits, settlement).
-  * ''MarketDepth'' — incremental bid/offer/implied updates thereafter.
+  * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L79|MarketDepth]] — incremental bid/offer/implied updates thereafter.
 **Market by Order Feed** (''MARKET_BY_ORDER''):
-  * ''MarketByOrderSnapshot'' — all resting orders plus ''last_sequence''.
+  * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L213|MarketByOrderSnapshot]] — all resting orders plus ''last_sequence''.
-  * ''MarketByOrderUpdate'' — per-order changes; each has a ''sequence'' and ''updates[]'' of type ''ADD_OR_UPDATE'', ''DELETE'' or ''CLEAR''. Apply in order; on a gap, resubscribe.
+  * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L231|MarketByOrderUpdate]] — per-order changes; each has a ''sequence'' and ''updates[]'' of type ''ADD_OR_UPDATE'', ''DELETE'' or ''CLEAR''. Apply in order; on a gap, resubscribe.
 **Ticker Feed**
-  * ''MarketTrade'' — when ''ticker'' is set. For an MBO subscription it also carries the trade ''sequence'' and the participating resting orders
+  * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L119|MarketTrade]] — when ''ticker'' is set. For an MBO subscription it also carries the trade ''sequence'' and the participating resting orders
 **Always:**
-  * ''MarketDetails'' — the instrument definition.
+  * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L29|MarketDetails]] — the instrument definition.
-  * ''MarketHighLow'', ''MarketPriceLimits'', ''MarketSettlement'' — as they occur.
+  * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L144|MarketHighLow]], [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L155|MarketPriceLimits]], [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L165|MarketSettlement]] — as they occur.
-  * ''MarketSubscribeReject'' — subscription refused; check ''mode''.
+  * [[https://github.com/CTS-Futures/t4-api-tools/blob/main/proto/t4/v2/market/market.proto#L21|MarketSubscribeReject]] — subscription refused.
-Every message carries a ''mode'' (''MarketMode'': open, closed, halted, …) and a ''delayed'' flag.
-===== Reference =====
-Messages and every field: ''proto/t4/v2/market/market.proto''. Enums (''Quotes'', ''MarketMode'', ''BidOffer''): ''proto/t4/v2/common/enums.proto''. See the [[developers:apiv2:reference|Message Catalog]].