Quickstart: connect your engine
This path proves the smallest useful contract: Logon, send one order, receive an acknowledgement, and produce a fill.
1. Open a session
Sign in, open Dashboard, and select the session you were provisioned. On Overview, open Connection details and copy the endpoint, protocol version, CompIDs, and any required authentication values. The panel also provides client configuration and code samples.
2. Configure the initiator
For QuickFIX-style configuration, describe the connection from your initiator's perspective:
[SESSION]
ConnectionType=initiator
BeginString=FIX.4.4
SenderCompID=YOUR_INITIATOR
TargetCompID=SIMULATOR
SocketConnectHost=<host shown in FixPortal>
SocketConnectPort=<port shown in FixPortal>
StartTime=00:00:00
EndTime=00:00:00
UseDataDictionary=Y
DataDictionary=<matching dictionary path>For FIXT.1.1, use the transport dictionary plus the FIX 5.0 SP2 application dictionary and set DefaultApplVerID=FIX.5.0SP2. Add any provisioned authentication fields exactly as supplied; do not copy development secrets into production configuration.
3. Log on
Start the initiator and wait for both sides to report a connected session. If Logon fails, compare BeginString, both CompIDs, credentials, clock, and sequence store before changing simulation behaviour.
4. Send one order
Send a New Order Single with a unique ClOrdID, side, quantity, order type, and a valid instrument identity. Keep the first test simple: one order, no routing rule, no instrument override.
The inbound blotter should show the order. With automatic acknowledgement enabled, the outbound blotter should show an Execution Report assigning an OrderID.
5. Produce a fill
Use Blotter In to choose an available order action, or configure automatic fills in Sim Config. Verify LastQty, LastPx, CumQty, LeavesQty, AvgPx, ExecType, and OrdStatus on the resulting report.
If the TCP socket opens but no FIX Logon completes, treat it as a session-identity, authentication, dictionary, or sequence problem. Fill settings cannot repair a failed session handshake.
Continue with Sessions and Sim Config.
Updated 2026-09-08 · Edit on GitHub