Help Center

Our products knowledge base for customers

Accounts FIX sessions

Accounts FIX sessions

FIX (Financial Information eXchange) protocol is a data exchange protocol, which is an international standard for exchange of data between exchange trading participants in real-time mode. A FIX session is a connection via the FIX protocol.

account_fix_sessions.png

In this section, you can see the list of accounts that have FIX sessions added.

A FIX session can be created for an account to send data over the API. To do this, click Add fix session. A sidepage will open where you can select the account and session type.

Several session types are available.

Order session

This type of session allows clients to create an order connector on their side and submit orders to the platform via the FIX protocol. The system processes these orders and sends messages about their status during processing within the account to which the FIX session is linked.

Please note! Only order types supported by the client order type set can be placed via FIX sessions. If an order cannot be placed, the client will receive a notification.

Market session

A Market session allows receiving prices for instruments available in the account to which the session is linked. It also allows receiving trades from the Kraken connector.

Protection against oversubscriptions

The Market session has protection against an excessive number of invalid instrument subscription requests:

  • If 500 or more requests for instruments unavailable for subscription are sent within 1 minute, the connection to the session is automatically disconnected for 1 minute. After this period, the session can be resumed.
  • If a subscription request is repeatedly sent within an hour for an unavailable instrument for which an error has already been received, no response is sent.

Client STP session

This type of session allows the client to ensure that a trade is recorded in the system in case of any errors or data loss. This session type is recommended for reporting or analytical systems.

Unlike Order sessions, STP sessions guarantee that trades are recorded in the system database. For reporting and trade analysis purposes, it is recommended to use STP sessions, as Order sessions alone are not sufficient. The key difference is that an STP confirmation is sent only after the trade has been recorded in the database, while an Order confirmation is sent at the moment of trade execution. Therefore, a trade may be executed but, for some reason, not recorded in the database. Under a heavy database load, there may be a slight delay between order execution and recording the trade in the database. If you plan to rely on trade information, it is better to wait for the STP confirmation.


The following FIX session characteristics are available in the table:

NameDescription
IDsession number
Accountaccount to which the session is linked
Typesession type, for example Order or Market
Is activesession activity indicator
Statussession status
Settingssession settings
Targetcompidassigned value used to identify the receiver
Descriptionsession description
Paramsparameters for sending swaps/trades for the session
ScheduleFIX session operating schedule

Params provides options for changing the parameters for sending swaps via the FIX protocol: Send - both trades and swaps are sent; Not send - swaps are not sent; Send only - only swaps are sent.

Adding FIX session

To add a FIX session to an account, click Add fix session and select the account and session type in the opened sidepage:

account_fix_session_add.jpg

Once a FIX session is created, a window with the connection parameters will appear.

To pause a FIX session, click Stop. The FIX session will stop being active.

To change the FIX session password, click Change password. A pop-up window with the new FIX session password will appear.

To change FIX session parameters, click Edit. In the opened sidepage, you can change the session parameters, add its Description, and configure its operating schedule.

FIX session schedule

You can configure a custom schedule for a FIX session. According to this schedule, the session switches between online and offline states.

The following options are available in the Schedule field:

  • Non-stop - the FIX session operates continuously. No additional schedule parameters are required.
  • Weekly window - the FIX session operates continuously from the specified start day and time to the specified end day and time. Specify the Time zone, Start day and time, and End day and time.
  • By weekdays - the FIX session operates on the selected days of the week within the specified time interval. Specify the Time zone, required Days, Start time, and End time.

To use the default schedule from the FIX configuration, clear the Schedule field and save the changes.

When saving, the system validates the specified schedule and does not allow an unsupported configuration to be saved.

If a custom schedule is configured for the FIX session, its schedule parameters are also included when copying the session settings to the configuration, including operating times, days of the week, and time zone.

Please note! When editing a session, you can also add its Description in text format.

To remove a FIX session, click Remove.

Then confirm the removal in the sidepage.

account_fix_sessions_remove.png

Didn't find what you were looking for? Contact to support@unity.finance. We will be happy to help 24/7