Aggregator settings

The Aggregator settings allow you to customize how, where and what instruments your client trades.

Aggregator Setting DEFAULT are used in technical accounts where price feed and order execution are not required.

We recommend using the DEFAULT setting for Nominal type accounts, i.e. technical accounts used as correspondent accounts for trades from Personal and Real type accounts.

General

In this section in the Name field you can set the name of your setting. In the Routing type setting the default value is Account. The alternative value - Connector is available only for platform administrators and is necessary to configure quotes flow routing and execution.

When you enable the Reorder checkbox, the settings editing mode will change, and you will be able to drag any group of instruments by clicking and dragging them by six dots:

The Add button opens a selector where one of two options can be chosen:

Add new fund - to add a setting containing fund instruments created in the broker;
Add account - to add a price/execution source for any else instrument types.

Please note! When editing the Bbook executor setting, Override instrument settings checkbox can be enabled. This allows to override the instrument settings (for the ABook and BBook sources) set according to the information from the liquidity provider. Available settings are described in the article Overriding Instrument Settings.

The Extra button opens a sidepage where you can enable support for multiple sources for the same instruments to the client:

Please note! When enabling this setting, a Stream IDname must be specified for each source: This name will be displayed in thePrices section, as well as in the trading terminal, and will be available for the client to select in the Ticket and Watchlist widgets.

Step-by-step configuration is available in the Aggregator Settings and Instruments Availability guide.

Routing type = Account

This Aggregator settings type allows you to define what data you will provide to customers.

Click Add account to select and configure the account from which you will receive prices.

Account source type - type of account on which orders will be executed.

Name	Description
Abook	external execution
Bbook	internal execution
Indicative	price feed without order execution
Manual	manual execution

Important! If the Indicative setting is enabled for a provider account, the client will not be able to place trading orders for instruments available on that account.

Account ID - Real type account, from which the prices will be transferred to the clients' accounts.

Close only instrument groups allows selecting instrument groups for which only reduction of open positions will be available.

Show Instruments allows you to view the list of instruments for a specific setting. In edit mode, you can also select or exclude groups of instruments to which the setting will be applied:

The search functionality allows you to quickly find the desired instrument within a group.

To apply the configured filter of included and excluded instrument groups, click the Apply Included and Excluded Groups button.

The Proxy errors setting allows to send comments to the client account with information about errors when placing/rejecting trade orders on the provider account.

Please note! The client will also be able to see information about such errors.

The Manual execution conditions setting allows you to specify the quote amount threshold at which orders will be sent for manual execution. Orders below that threshold will be executed automatically.

ABook execution configuring

In the Account source type field select ABook. In the Account ID field select an external account (the filter on provider accounts is set by default) to which clients' orders will be sent for execution. When the provider account is selected - you will see the number of instruments available for this account and can customize them in Show instruments.

Example: you have NTPro and IRESS provider accounts that are already configured in the platform. You want to configure the client to be able to trade Iress on all instruments. FX are held in the NTPro account. Accordingly, to see the groups of instruments available for trading in this stream, you need to select the NTPro account in the list.

If you need to reduce the number of trading instruments available to your client (you can't add, only reduce!), you can select groups from the existing ones or create a specific group filled with excluded instruments to be involved.

Example: you can create a separate instrument group with only two specific instruments and select it. For example, create a group of USOil and SP500, excluding other instruments, and then you will be able to trade with only these instruments.

IMPORTANT: A separate routing must be set up for each provider. If there is more than one client and it is necessary to allow one of the clients to trade all instruments from all providers, a separate routing must be created for each provider.

Example: you have a Iress provider that provides only Equities and a “VetolNet” provider which provides only Forex. Accordingly, you need a stream for each of these provider accounts.

Details on setting up ABook execution are described in the guide on Aggregator Settings and Instruments Availability.

BBook-execution

Bbook is the execution of client orders within the system, without transferring them to liquidity providers. However, it is still necessary to receive a price stream from the liquidity provider, which the system will use to execute trades. In the platform, BBook execution occurs as follows:

After the order has been accepted for execution (i.e. all checks on the client account have been passed), the order is transferred to the BBook account. On the BBook account the TTL (time of life) of the price is checked. If the check is positive, the order is executed. If the check is negative - the order gets the status Rejected with the No quotes comment.

Important! If the Skip order margin check setting is enabled on the client's account - the check for margin collateral sufficiency is performed only after checking the TTL price on the BBook account. Accordingly, in this case, the order may not be executed if there is not enough margin collateral on the client's account for its execution. In this case, the order will move to the Rejected status with the comment No margin available.

Once the order is executed, two trades occur in the platform, one for the client's account and one for BBook's account with a reverse sign.

Example: A client bought 1,000 EUR/USD. In this case, the BUY 1000 EUR/USD trade will be displayed on the Client's account, and the SELL 1000 EUR/USD trade will be displayed on the BBook account.

Details on BBook execution settings are described in the article BBook Execution Settings, as well as in the guide on Aggregator Settings and Instruments Availability.

Configuring Indicative account source type

For Account source type - Indicative, the logic for configuring the ABook implementation is used, as described in the corresponding subsection of this manual.

Please note! For the Indicative type setting, there can be no order execution by default. Prices will be displayed, but orders will not be executed.

Configuring Manual account source type

If Account source type is set to Manual, orders will be sent to the provider for execution only after manual processing of the request.

Please note! When manually executing requests, the following logic of markups configured in tariffs is applied:

For buy trades on A-book accounts and sell trades on B-book accounts: the price of the instrument on the provider account is calculated as the price of the instrument on the client account minus the markup size set for it.
For sell trades on A-book accounts and buy trades on B-book accounts: the price of the instrument on the provider account is calculated as the price of the instrument on the client account plus the markup amount set for it.

TTL (Time-To-Live) of the quote

TTL (Time To Live) - time to live of the quote. Quote - current price announced by the seller or buyer, at which trading participants are ready to sell or buy the instrument. Server time - time of the world NTP-servers. Local time - time on the device of the current user. Delta Δ - difference between server time and local time.

When receiving the first instrument quote for validation, the TTL of the quote is compared with the current local time considering delta. If the quote time is not included in the interval equal to the TTL of the instrument, the quote is considered as expired and is hidden from the user. Otherwise, if the quote is not the first one, the timer is starting for the time equal to TTL with delta correction, or, if TTL is less than one second, without correction. After that the quote will be deleted as expired. The timer is updated when a new quote is received.

Also, after the first appearance of quotes, a timer that checks the quote every 2 seconds is starting.

If the TTL of the instrument is 5 or more seconds, then after 2/3*TTL the price is coloring yellow and a tooltip with the amount of time elapsed since the quote was received appears in place of the spread.
The warning displays if more than a minute has elapsed since receiving the quote.

When TTL expires, the quote is deleted and the warning is erased.

If TTL is not set, the system considers the last received quote valid.

You can always initiate a connection update with a price subscription as follows:

When reloading the page (F5).
When activating the browser tab where the prices are displayed (switching from another window, unfolding the browser).
every 20 minutes.
When reconnecting the Internet connection.

In Ticket:

When switching instruments
When changing the tenor of an instrument
When changing the value in the Amount field
When changing the stream
When inverting a currency pair (icon between tickers)
When changing Pricing mode in user settings
When changing the data refresh rate in user settings

In Watchlist:

When deleting/adding an instrument
When switching the tab of the Watchlist
When changing the value in the Amount field
When changing the tenor of an instrument
When changing the stream
When changing Pricing mode in user settings
When changing the data update frequency in user settings

Specifics of TTL application at B-book execution:

If TTL is set, then at the moment of order receipt on the B-book account the system checks when the last quote was received, if TTL is exceeded - the system waits 10 seconds for a new quote, if it does not come, the order is switched to the Rejected status.
If TTL is not set - then the last quote is considered valid, independently of the time of its receipt in the system.

With the TTL setting disabled, execution may proceed at the old price.

Example: One price has been in the system for 20 seconds. If TTL is not set, execution will occur at the price that was in the system during that time. If TTL is set on 5 seconds, for example, and there is no new price in the system during this time, the order will be rejected.

Please note: Market orders have a lifetime of 10 seconds. If in that time a price satisfying TTL does not appear within 5 second period - the order will be rejected. If TTL is not set, the order will be executed at the price that has been pending for 20 seconds (in our example).

If the new price comes from the liquidity provider when resubscribing, the new price is displayed; if the new price does not come, no price is displayed.

Instruments export

You can export (download) the set of the instruments included in your Aggregator setting in .xlsx format by clicking Save as XLSX button.

The table contains the next information about instruments included in your Aggregator setting:

Name	Description
Instrument ID	Identifier of the instrument's tenor in the platform.
Root ID	Identifier of the root instrument in the platform.
Ticker	Instrument's ticker.
Code	Instrument and its exchange code.
Category	Instrument's category.
AssetType	Asset type of instrument.
Tenor	Instrument's tenor (one per line).
Exchange	Exchange code.
FIX Symbol	The name of the instrument sent to the FIX session.
Account ID	The ID of the account that provides the prices.
Account name	The name of the account that provides the prices.

The final .xlsx table contains instruments divided into groups by using empty rows.

A narrowed selection of instruments can be exported from the Show existing sidepage. The exported table contains the same fields, except for Root ID, Account ID, and Account Name.

By clicking Duplicate you can create a copy of your current setting.

To save your new or edited setting click Save in the bottom right of the screen, Cancel to cancel the changes and Show usage to view on which accounts this setting is used.

To change an existing setting, click the Edit button.

In the edit mode, you can delete the setting by clicking the Delete button.

Help Center

Aggregator Settings