Differences

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

--- developers:websocket [2025/03/14 17:56] – external edit 127.0.0.1
+++ developers:websocket [2025/03/14 19:15] (current) – [Message Structure Overview] chad
@@ Line 25: / Line 25: @@
 ==== Message Structure Overview ====
-All messages are wrapped within a top-level client or server message envelope. This structure ensures extensibility and consistency across different message types.
-**Example Envelope:**
+All messages sent to the server must be wrapped in a **ClientMessage** envelope, and all messages received from the server will be contained within a **ServerMessage** envelope. This ensures a consistent structure and simplifies message parsing.
-```
+=== Client Message Structure ===
+A **ClientMessage** is the top-level wrapper for all messages sent to the server. It contains fields for various message types, such as authentication requests, order submissions, and subscription requests.
+Example **ClientMessage**:
+<code>
 message ClientMessage {
   oneof payload {
-    SubscribeRequest subscribe = 1;
+    AuthenticationRequest authentication_request = 1;
-    OrderRequest order = 2;
+    MarketSubscription market_subscription = 2;
+    OrderRequest order_request = 3;
+    // ... other client messages
   }
 }
+</code>
+=== Server Message Structure ===
+A **ServerMessage** is the top-level wrapper for all responses and updates from the server. It encapsulates messages related to market data, account updates, and execution reports.
+Example **ServerMessage**:
+<code>
 message ServerMessage {
   oneof payload {
-    MarketUpdate market_data = 1;
+    AuthenticationResponse authentication_response = 1;
-    OrderResponse order_response = 2;
+    MarketSnapshot market_snapshot = 2;
+    OrderUpdate order_update = 3;
+    // ... other server messages
   }
 }
-```
+</code>
+=== Message Tools ===
+The [[https://github.com/CTS-Futures/t4-api-tools|T4 API Tools repository]] has code that makes wrapping messages from your client very easy.
+<bootnote>
+Reach out to support if you would like a API tool's for a language we have not covered yet.
+</bootnote>
+^ **Platform** ^ **Client Message Helper** ^
+| **.Net** | [[https://github.com/CTS-Futures/t4-api-tools|ClientMessageHelper.cs]]|
-This design enables efficient message parsing while maintaining flexibility.
-==== Next Steps ====
-Continue to the **[Connecting and Authenticating](developers:websocket:connecting)** section to learn how to establish a WebSocket connection and authenticate your session.