Differences

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

--- developers:apiv2:markets [2026/09/07 18:08] – [Subscribe] 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 38: / Line 38: @@
 | ''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]].