developers:apiv2

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
developers:apiv2 [2026/09/07 13:35] chaddevelopers:apiv2 [2026/09/07 13:43] (current) chad
Line 1: Line 1:
-====== T4 WebSocket API (V2) ======+====== Plus500 Futures Technologies WebSocket API (V2) ======
  
 A single, streaming WebSocket connection for real-time market data, account/position updates and order routing. Messages are encoded with [[https://protobuf.dev/|Google Protocol Buffers]]. A single, streaming WebSocket connection for real-time market data, account/position updates and order routing. Messages are encoded with [[https://protobuf.dev/|Google Protocol Buffers]].
  
 **Proto Files:** the ''.proto'' files define every message and field. This wiki explains the connection model and the common flows. For message field details, see the proto files and the [[developers:apiv2:reference|Message Catalog]]. **Proto Files:** the ''.proto'' files define every message and field. This wiki explains the connection model and the common flows. For message field details, see the proto files and the [[developers:apiv2:reference|Message Catalog]].
- 
-===== Message Model ===== 
- 
-All messages travel inside a transport envelope, one Protobuf message per WebSocket **binary** frame: 
- 
-  * ''ClientMessage''  — everything you send to the server. 
-  * ''ServerMessage''  — everything the server sends to you. 
- 
-Each envelope is a ''oneof'': exactly one payload is set. Read the ''payload'' case to know what you received. 
- 
-<code> 
-message ClientMessage { 
-  oneof payload { 
-    Heartbeat            heartbeat          = 1; 
-    auth.LoginRequest    login_request      = 2; 
-    market.MarketSubscribe    market_subscribe   = 100; 
-    account.AccountSubscribe  account_subscribe  = 200; 
-    orderrouting.OrderSubmit  order_submit       = 300; 
-    // ... 
-  } 
-} 
- 
-message ServerMessage { 
-  oneof payload { 
-    Heartbeat            heartbeat          = 1; 
-    auth.LoginResponse   login_response     = 2; 
-    market.MarketSnapshot     market_snapshot    = 108; 
-    account.AccountSnapshot   account_snapshot   = 205; 
-    orderrouting.OrderUpdate  order_update       = 300; 
-    // ... 
-  } 
-} 
-</code> 
- 
-The full envelope is in ''proto/t4/v2/service.proto''. See the [[developers:apiv2:reference|Message Catalog]] for the complete list. 
  
 ===== Key Capabilities ===== ===== Key Capabilities =====
  • developers/apiv2.1788788133.txt.gz
  • Last modified: 2026/09/07 13:35
  • by chad