TraderLogoutResponse
Logging out Traders
Under an established FIX Session, multiple traders/users can be authenticated with the Trader Logon message. Trader Logons allow order routing for multiple traders under the same physical connection of the FIX Session. Trader Logons must follow the successful FIX Logon of the initial Master User.
A trader that has been successfully authenticated with a Trader Logon can be logged out by the Master User with a Trader Logout message. The FIX API responds to Trader Logouts with the Trader Logout Response message.
Responding to Trader Logouts
The Trader Logout Response message identifies the trader (whose logout was attempted with a Trader Logout message) via the UserName tag (Tag 553). The success/failure result of the Trader Logout is carried in the Text tag (Tag 58).
Tag Name | Tag Number | Description |
---|---|---|
UserName | 553 | T4 User |
Text | 58 | T4 Description of Trader Logout result |
A successful attempt to log out a trader is acknowledged with a Trader Logout Response message that contains a Success description in the Text tag (Tag 58).
Failure to logout a trader will result in a failed Trader Logout Response message sent to the client. The Trader Logout Response message may contain a short description of the failure in its Text tag (Tag 58).
A failed Trader Logout does not result in a physical disconnection. The FIX Session continues with the participation of the Master User and other traders that were previously authenticated and remained logged in. The FIX Session can only be terminated by a FIX Logout message.
Message Dictionary
Tag | Field Name | Req'd | Comments |
---|---|---|---|
Standard Header | Y | MsgType = UCJ | |
49 | SenderCompID | Y | T4 Application Name (inbound trader login into FIX API server). T4 Firm Name (outbound trader login response from FIX API server). |
56 | TargetCompID | Y | T4 Firm Name (inbound trader login into FIX API server). T4 Application Name (outbound trader login response from FIX API server). |
Body | Y | ||
553 | UserName | Y | T4 User to be logged out |
58 | Text | Y | Description of Trader Logout result |
Standard Trailer | Y |
Sample
In this example:
- The T4 FIX API client requests the start of a FIX Session.
- The client enables Multi-Trader mode (Tag 372=UCG).
- The login request's success is signaled by a Login message response from the T4 FIX API — establishing the FIX Session with the Master User.
- The client sends a Trader Logon to authenticate a new Trader/User under the current FIX Session.
- The Trader Logon succeeds (Trader Logon Response = Success).
- The client sends a Trader Logout message to log out this trader.
- The FIX API responds with Success as the trader was correctly identified.
- Finally, the client requests the termination of the FIX Session with a FIX Logout message, and the FIX API confirms the logout.
Login Request from T4 FIX API Client 1 - LOGIN (in) 34=1|49=T4Example|56=ctsdev|52=20160930-16:33:21.227|91=112A04B0-5AAF-42F4-994E-FA7CB959C60B|90=36|98=None|108=25|553=MasterUser|554=***|1407=58BD-B00F-5805-98AA-BD46-0417-C2B8-9C5F|384=1|372=UCG| [MsgSeqNum] 34 = 1 [SenderCompID] 49 = T4Example [TargetCompID] 56 = ctsdev [SendingTime] 52 = 20160930-16:33:21.227 [SecureData] 91 = 112A04B0-5AAF-42F4-994E-FA7CB959C60B [SecureDataLen] 90 = 36 [EncryptMethod] 98 = None [HeartBtInt] 108 = 25 [UserName] 553 = MasterUser [Password] 554 = *** [DefaultApplExtID] 1407 = 58BD-B00F-5805-98AA-BD46-0417-C2B8-9C5F [NoMsgTypes] 384 = 1 [RefMsgType] 372 = UCG (ENABLE_TRADER_LOGINS)
Successful Login Response from T4 FIX API 2 - LOGIN (out) 34=1|49=ctsdev|56=T4Example|50=T4FIX|52=20160930-16:33:26.714|98=0|108=30|553=MasterUser|554=***|1408=4.3.62.0| [MsgSeqNum] 34 = 1 [SenderCompID] 49 = ctsdev [TargetCompID] 56 = T4Example [SenderSubID] 50 = T4FIX [SendingTime] 52 = 20160930-16:33:26.714 [EncryptMethod] 98 = 0 (NONE) [HeartBtInt] 108 = 30 [UserName] 553 = MasterUser [Password] 554 = *** [DefaultCstmApplVerID] 1408 = 4.3.62.0
Trader Logon Request from T4 FIX API Client 3 - TRADERLOGIN (in) 34=2|49=T4Example|56=ctsdev|50=Trader1|52=20160930-16:33:41.989|91=112A04B0-5AAF-42F4-994E-FA7CB959C60B|90=36|109=CTS|553=Trader1|554=***| [MsgSeqNum] 34 = 2 [SenderCompID] 49 = T4Example [TargetCompID] 56 = ctsdev [SenderSubID] 50 = Trader1 [SendingTime] 52 = 20160930-16:33:41.989 [SecureData] 91 = 112A04B0-5AAF-42F4-994E-FA7CB959C60B [SecureDataLen] 90 = 36 [ClientID] 109 = CTS [UserName] 553 = Trader1 [Password] 554 = ***
Successful Trader Logon Response from T4 FIX API 4 - TRADERLOGINRESPONSE (out) 34=57|49=ctsdev|56=T4Example|50=T4FIX|52=20160930-16:33:47.460|553=Trader1|58=Success| [MsgSeqNum] 34 = 57 [SenderCompID] 49 = ctsdev [TargetCompID] 56 = T4Example [SenderSubID] 50 = T4FIX [SendingTime] 52 = 20160930-16:33:47.460 [UserName] 553 = Trader1 [Text] 58 = Success
Trader Logout Request from T4 FIX API Client 5 - TRADERLOGOUT (in) 34=3|49=T4Example|56=ctsdev|50=Trader1|52=20160930-16:33:44.181|109=CTS|553=Trader1| [MsgSeqNum] 34 = 3 [SenderCompID] 49 = T4Example [TargetCompID] 56 = ctsdev [SenderSubID] 50 = Trader1 [SendingTime] 52 = 20160930-16:33:44.181 [ClientID] 109 = CTS [UserName] 553 = Trader1
Successful Trader Logout Response from T4 FIX API 6 - TRADERLOGOUTRESPONSE (out) 34=58|49=ctsdev|56=T4Example|50=T4FIX|52=20160930-16:33:49.605|553=Trader1|58=Success| [MsgSeqNum] 34 = 58 [SenderCompID] 49 = ctsdev [TargetCompID] 56 = T4Example [SenderSubID] 50 = T4FIX [SendingTime] 52 = 20160930-16:33:49.605 [UserName] 553 = Trader1 [Text] 58 = Success
Logout Request from T4 FIX API Client 7 - LOGOUT (in) 34=4|49=T4Example|56=ctsdev|52=20160930-16:33:49.444| [MsgSeqNum] 34 = 4 [SenderCompID] 49 = T4Example [TargetCompID] 56 = ctsdev [SendingTime] 52 = 20160930-16:33:49.444
Successful Logout Response from T4 FIX API 8 - LOGOUT (out) 34=59|49=ctsdev|56=T4Example|50=T4FIX|52=20160930-16:33:54.851|58=Successful logout upon request| [MsgSeqNum] 34 = 59 [SenderCompID] 49 = ctsdev [TargetCompID] 56 = T4Example [SenderSubID] 50 = T4FIX [SendingTime] 52 = 20160930-16:33:54.851 [Text] 58 = Successful logout upon request