BBook-execution set up

---

Please note! A more detailed and visual description of the setup steps is available in the guide on Aggregator Settings and Instruments Availability.

---

1. Creating Aggregator settings for the BBook account.

Account source type = Indicative should be selected, because this type of account needs only indicative prices, which will be executed inside the platform.

Account ID - here it is necessary to select the provider account (Real), from which the price flow will go to BBook account and further to the accounts of clients, who have BBook-execution configured.

Important: All Account IDs of Real accounts, which receive prices for the required instruments, must be added to the setting.

It is also necessary to enable the BBook executor setting for all added Real accounts - this will allow orders to be executed and will also open additional settings. Click Edit to make the necessary changes and turn on the BBook executor:

• Group orders interval (ms) - if less time has elapsed between orders with the same trade side and volume for the same instrument than the time specified in this setting, they will be grouped and executed together.

• Same price interval (ms) - guarantees that if between the orders with one side of the trade and volume for one instrument less time has passed than the time specified in this parameter, such orders will be executed at the same price.

• Execute any volume - allows accounts with this aggregator setting to close positions regardless of liquidity in the stack.

• Override instrument sets - allows to set individual settings for each instruments group (after saving changes in the current sidepage):

• • separate Schedules - schedules of the trading calendar.
• • separate Order type set - set of order types available for trading.
• • Active sessions - sessions available for trading. If no session is selected, all sessions will be selected as available for trading.
• • separate MPI (Minimum Price Increment) - minimum possible price change.
• • separate Min. order size and Max. order size.
• • Stop limit prohibited range - prohibits placing SL/TP orders close to the market price. If the price in the order is closer to the market price by a value greater than the value specified in this field, the client will not be able to place the order.

When finished editing, press Create or Save to save the created / edited setting.

2. Creating and setting up an account for BBook-execution

To create this type of account, go to Access ➝ Accounts section, click Create account and make the following settings:

Name	Description
Client ID	profile of the broker for which the account is created
Accounting type	Personal
Management type	Brokerage
Provider ID	the profile of the quotes provider. Orders of clients with a configured BBook execution will be executed on the BBook account of this provider
Aggregator settings	here it is necessary to specify the setting created in the previous section of the instruction

Please note! You will not be able to trade on this account, as it receives only indicative prices. For trading, you need to create a separate account (or select an existing one) and apply the setting from the next step to it.

3. Aggregator settings for the accounts with BBook execution

Next, it is necessary to create the Aggreagtor Setting for the accounts of clients with BBook-execution. In this setting it is necessary to select Account source type - BBook, and in the Account ID field - select the internal account for BBook-execution (created at the previous step).

Please note! To trade on BBook, it is mandatory to have this setting applied to the client account.

Bbook executor sidepage

When the Bbook executor checkbox is enabled, a number of settings become available:

• The Group orders interval (ms) field determines the wait time before grouping trading orders before they are executed.
• The Same price interval (ms) field determines the interval before which orders with the same side and amount for an instrument can be executed at only one price.
• The Execute any volume setting allows to close positions on the account regardless of the liquidity in the order book.
• The Override instrument sets setting adds the ability to overwrite instrument sets configured according to information from the liquidity provider.

Overriding instrument sets

If the Bbook executor and Override instrument sets checkboxes are enabled, a table with instrument groups and their settings appears in the aggregator settings:

To open the sidepage with available settings, click the Edit button in the row with the desired instrument group.

The sidepage is divided into several settings blocks:

Name	Description
Instrument group	Instrument Group, for which the settings set is applied.
Schedule	Schedule, according to which the instruments included in the group are traded.
Order type set	Order type sets applied to the instrument group.
Active sessions	Trading sessions available for the instrument group.
MPI	MPI applied to the instruments in the group.
Min. order size	Minimum available amount for placing a trade order.
Max order size	Maximum available amount for placing a trade order.
Order step	The amount step allowed to the client when placing a trade order.
Stop limit prohibited range	This field specifies the range relative to the instrument's market price within which stop-loss or take-profit orders cannot be placed.

Additional options:

No holidays - if enabled, the system ignores holidays for instrument currencies. T+0 settlement - if enabled, netting occurs on the position opening day, regardless of the instrument tenor. For positions already open at the time this setting is enabled, the netting date does not change. Override value date - When enabled, the value date received from the provider will be overwritten according to the instrument tenor. Override commission - When enabled, the Commission set in the account tariff overwrites the commission sent by the liquidity provider.

---

Settings in Internal limit support section allows to set the rules to automatically cancel orders for instruments in the group placed in the liquidity provider's account.

Please note! The Internal limit support section settings apply to trading orders with IOC and FOK durations. When setting the section, the Limit if touch order will remain in the client account and will not be sent to the provider's account until it is triggered. After the order is triggered in the client's account, a corresponding Limit order with an IOC or FOK duration will appear in the provider's account.

Name	Description
Retry attempts	This field specifies the number of attempts to send an order to the execution on the liquidity provider's side.
Retry delay	The delay between retrying the order sending.
Retry delay multiplier	The multiplier applied to retry delays.

Example of calculating intervals of sending the order for execution: - Retry Attempts = 3 - Retry Delay = 1000 - Retry Delay Multiplier = 2 In this case, the retry intervals would be as follows: - First attempt: 1 x 2 x 1000 = 2000 ms - Second attempt: 2 x 2 x 1000 = 4000 ms - Third attempt: 3 x 2 x 1000 = 6000 ms

---

Name	Description
Duration	This field allows you to set the duration of the OHLC bar whose price will be added to the quotes stream at the specified time.
Previous Bar	When this setting is enabled, the previous OHLC bar will be used to obtain ticks instead of the current one.
Time of day	The time (according to the instrument's time zone) at which prices from the OHLC bar will be added to the quotes stream.
TTL	The time during which quotes for the instrument will be valid within the specified trading session.
Instant order auto cancel interval	This field specifies the time after which a request to cancel a placed trade order will be sent. Applies to orders with IOC and FOK durations. If the time is not specified, then in the lack of prices for the instrument on the BBook-execution account, if a trading order is placed on it, it will remain there until a price for the instrument appears on it. That is, if the price does not appear, the order will remain on the account for an unlimited period of time.