Professional Documents
Culture Documents
Account Management
Account Management
The following changes will be introduced from Portal Version v2.55 (XCore version v5.70.0).
The Margin and Risk Functionality is handled within the “Accounts” module of the XCore.
In this module, the system offers powerful controls for A-Book and B-Book exposure which perform pre-trade
margin checks and can impose limits to automatically hedge exposure to liquidity providers.
The XCore offers the ability to control margin on a per-connector or trading account basis by prohibiting
trades that would result in exceeding the allowed used margin.
As well as this, accounts can be defined for your Liquidity Providers to control flow and keep track of
exposures.
Major Changes
• Account mappings:
- Restructure of Account component into 3 different components: Account, Account Group and Account
Group Setting.
- Each Connector Account must now be linked with both a margin and a risk account under the Connector
Account component. If not already mapped, new MARGIN_POSITION and RISK_POSITION Accounts will be
created and mapped during the migration.
- Each Provider must now be linked with a margin account under the Provider component. If not already
mapped, a new MARGIN_POSITION Account will be created and mapped during the migration.
• Account Wallet Re-structure:
- Account Wallet component has been replaced by Account Profile Wallet and Account Profile Wallet Setting
components.
• Positions:
- Positions on Risk accounts and Margin Accounts linked to Providers will be booked in Reverse.
Account
Account Group
Account Profiles
Account
Account
The Account Component displays the XCore accounts defined in the system along with their settings. This
component also allows defining and deleting accounts.
The Account must be linked with an Account Group, which contains and is configured by the different
Account Profiles (Leverage, Limit, Swap, Pl, Dividends, etc.).
From the Account component, parameters such as stopout, exp_limit, and warn levels can be configured.
www.primexm.com
|1
Account Management | 2
Based on the account group type, specific rules can be defined by setting up their individual profiles.
Additionally, you can define the deposit currency and margin alert notification levels for each account group.
Free margin on XCore Accounts can be synced with an MT4 coverage account using the MT4-XCore API:
Margin Sync Tool.
Note: The XCore will process B_Book orders only if an Account Group of type RISK
is configured and enabled in the system, otherwise, it will expire the B_Book orders and report a rejection.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default attribute
field name required editable description
settings type
www.primexm.com
|2
Account Management | 3
default attribute
field name required editable description
settings type
restart
description C n/a STRING Free text for the description of the account
required
restart
enable C n/a TINYINT Specifies if the account is enabled or disabled
required
Notes:
When a new trade request is received, the system will check the relevant settings, defined under the
profiles, to identify if any set limits are already surpassed (pre trade) or will be surpassed if the received
trade request would be executed (post trade); in such case, the trade or portions of the trade request
will be flagged, and the system will take relevant actions, based on the account type:
for accounts of type MARGIN and NOP, the system will reject the entire trade request if any
www.primexm.com
|3
Account Management | 4
An account can be configured to keep track of trade requests received on one or more connectors and
connector accounts defined in the system (see Connector Account component for linking rules).
the MARGIN and NOP accounts will take all trades into account
the RISK accounts will only consider b-book trades and a-book trades placed by the broker for the
purpose of moving risk in or out of the internal book (for the latter, a specific connector trading
account must be linked to the risk account, in mode BROKER)
The system will reduce the recorded overflow a-book positions only when all the relevant account
parameters are lower than a defined percentage of the set limits (specified in underflow setting on the
Account).
Account Group
Account Group
The Account Group component displays the XCore accounts defined in the system and their settings and is also
used to create and delete account groups.
This component allows for a faster setup of new accounts as all the profile settings are already populated in
various account groups.
The Account Group component must be linked with a specific XCore account through the Account component,
and is used to select Account Profiles and additional configurations of the XCore accounts such as Warn,
Underflow, and Description.
Once the Account Group is configured through the wizard, all the settings are populated accordingly under the
Account Group Settings component.
Each account group has a type that determines its purpose and behavior. Specific rules can be defined based
on the account type by setting up their individual profiles. Additionally, the deposit currency and margin alert
notification levels can be defined for each account. The available account types are:
MARGIN – keeps track of trades and rejects any trade that would increase the exposure above the
account equity
NOP – keeps track of trades on a daily basis and rejects any trade that would increase the daily
exposure above the account equity
RISK – keeps track of b book trades and when the exposure exceeds the account equity it starts routing
trades to the Liquidity Provider
Free margin on XCore Accounts can be synced with an MT4 coverage account using the MT4-XCore API:
Margin Sync Tool.
Note: The XCore will process B_Book orders only if an Account of type RISK is configured and enabled in the
system, otherwise it will expire the B_Book orders and report a rejection.
www.primexm.com
|4
Account Management | 5
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default
field name required attribute type editable description
settings
The name of the Account Group that can
restart be used in the Account component in
Name Y – VARCHAR(64)
required order to link the Account with the
Account Group.
restart Free text to be used to easily understand
Description – – VARCHAR(128)
required that content of the Account Group.
default attribute
field name required editable description
settings type
The name of the account group
Name Y – STRING read only Note: the account is known throughout the
system via its name
The type of the account available types are:
• MARGIN
Type Y – STRING read only
• RISK
• NOP
www.primexm.com
|5
Account Management | 6
default attribute
field name required editable description
settings type
The deposit currency of the account
Note: all operations on the account, and
calculations on its positions will be converted
into the deposit currency of the account
To reduce confusion about the CCY setting on
Currency Y – STRING read only account_group level, this setting now will be
renamed to DEFAULT_CCY. If ‘ccy’ in
account_profile_settlement_setting is set to “n/a”
it will use the DEFAULT_CCY on group level
instead. DEFAULT_CCY on group level has to be
set to a valid currency
The name of the leverage symbol profile which
Profile will be assigned to the account group
restart
Leverage Y – STRING Note: For more information regarding the
required
Sym calculation please refer to the How is account
exposure calculated per symbol.
Profile Limit restart The name of the limit symbol profile which will
C n/a STRING
Sym required be assigned to the account group
The name of the leverage currency profile which
Profile will be assigned to the account group
restart
Leverage Y – STRING Note: For more information regarding the
required
Ccy calculation please refer to the How is account
exposure calculated per currency
The name of the limit currency profile which will
Profile Limit restart be assigned to the account group
C n/a STRING
Ccy required Note: the limit currency profile only applies to
currency positions formed from netting symbols
The name of the wallet profile which will be
Profile restart assigned to the account group
C n/a STRING
Wallet required Note: required mandatory to set a profile wallet
when creating account group
The name of the swap profile which will be
restart assigned to the account group
Profile Swap C n/a STRING
required Note: required if a settlement profile is assigned
to an account group
The name of the settlement profile which will be
Profile Swap restart assigned to the account group
C n/a STRING
Settlement required Note: required if a swap profile is assigned to an
account group
The name of the PL profile which will be
assigned to the account group
restart Note: when pl profile is assigned on XCore
Profile PL C n/a STRING
required Account Group it will also populate the Account
Wallet component with an indication of PL
Profile selected
The name of the settlement profile which will be
Profile PL restart assigned to the account group
C n/a STRING
Settlement required Note: required if a pl profile or swap profile or
dividend is assigned to an account group
www.primexm.com
|6
Account Management | 7
default attribute
field name required editable description
settings type
The name of the dividend profile which will be
assigned to the account group
Profile restart Note: when dividend profile is assigned on
C n/a STRING
Dividend required XCore Account Group it will also populate the
Account Wallet component with an indication of
Dividend Profile selected
The name of the settlement profile which will be
Profile
restart assigned to the account group
Dividend C n/a STRING
required Note: required if a dividend profile is assigned
Settlement
to an account group
Represents a list of percentage levels of the
account’s global exposure, at which point a high
restart utilization warning alert will be generated by the
Warn Y 50,70,90 STRING
required system
Note: default exposure utilization warning levels
are 50%, 70% and 90%
Possible values:
• 0 – false (Unticked box)
• 1 – true (Ticked box)
Represents the behavior when the system will
start reducing overflow opened with the LP, as a
result of the Risk Account Group limits being
reached.
• 0 (FALSE) – represents the case in which
b_book exposure will be closed first and XCore
restart will allow the b_book positions to be opened in
Underflow C 0 TINYINT required the opposite direction as long as it is not
violating the limits. Overflow will be affected
only if the b-book limit is reached.
• 1 (TRUE) – means that the overflow will be
closed first, followed by b_book and finally the
XCore will allow b_book positions to be opened
in the opposite direction.
Note: The underflow parameter is only
supported for b-book orders under accounts
group of type RISK
Y = Tick Box enabled
N = Tick Box disabled
If it’s disabled then during stopout trigger, the
Disable exposure limit column remains as it is and will
restart
Trading on C 0 TINYINT not be switched automatically to 0
required
Stopout If it’s enabled the during stopout trigger, the
exposure limit column will be switched
automatically to 0 making the account set to
close only mode.
restart Free text for the description of the
Description C n/a STRING
required account group
www.primexm.com
|7
Account Management | 8
The Account Group Settings component is a read only component which contains all the configurations that
were made through the Account Group when assigning different Account Profiles on the Account Group.
Specific XCore accounts can be filtered in order to check their configurations.
Technical Specifications
field default
required attribute type editable description
name settings
Group Y – SMALLINT(6) read only The name of the Account Group.
Specific configuration definitions of the
Key Y – VARCHAR(32) read only
Account Group wizard.
Defined values of the Account Group which
Value Y – VARCHAR(32) read only
were made from the Account Group wizard.
Notes:
When a new trade request is received, the system will check the relevant settings, defined under the
profiles, to identify if any set limits are already surpassed (pre trade) or will be surpassed if the received
trade request would be executed (post trade); in such case, the trade or portions of the trade request
will be flagged, and the system will take relevant actions, based on the account type:
for accounts of type MARGIN and NOP, the system will reject the entire trade request if any
portion of the trade was flagged
for accounts of type RISK, the system will send only the flagged portion of the trade request to a-
book, and will record this portion as overflow a-book position
An account can be configured to keep track of trade requests received on one or more connectors and
connector accounts defined in the system (see Connectors Account component for linking rules).
the MARGIN and NOP accounts will take all trades into account
the RISK accounts will only consider b-book trades and a-book trades placed by the broker for the
purpose of moving risk in or out of the internal book (for the latter, a specific connector trading
account must be linked to the risk account, in mode BROKER)
The system will reduce the recorded overflow a-book positions only when all the relevant account
parameters are lower than a defined percentage of the set limits (specified in underflow setting on the
Account).
Exposures set to NONE means those accounts will not perform any balance or equity based margin
checks. Limit profiles like limit_sym and limit_ccy will still work. Generally accounts assigned to
providers would have Exposure set to NONE and no other profiles assigned, in this case they would
simply track positions for those providers.
www.primexm.com
|8
Account Management | 9
Account Profiles
Account Profiles
Account profiles are linked and used by the Account group component. Profiles can be set up and used for
different purposes. The profiles are covered in greater detail in the following chapters.
The leverage profiles defined in this component can be linked to one or several XCore account groups defined
in the system, and influence the margin calculation and hence the account exposure calculation.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
Important Note:
Netting will be enabled on the Account while using the Profile Leverage Currency.
Netting will be disabled if the Profile Leverage Symbol is used (either alone or together with the Profile
Leverage Currency).
Specific symbol lines can be deleted from the Profile Leverage Symbol in case netting needs to be
enabled while using both Symbol and Currency Profiles.
If both Profile Currency and Profile Leverage Symbol are assigned on the the group then most specific
will be used which is Profile Leverage Symbol and the positions will not be netted.
default
attribute required attribute type editable description
settings
Note: The settings of a leverage currency profile can be configured in the Leverage Profile currency
www.primexm.com
|9
Account Management | 10
Setting component.
Technical Specifications
The Profile Leverage Currency Setting component has the below attributes:
Note: All changes that require XCore restart should be done from the Pending Config component
default
attribute required attribute type editable description
settings
The leverage profiles defined in this component can be linked to one or several XCore account groups defined
in the system, and influence the margin calculation and hence the account exposure calculation.
Important Note:
Netting will be enabled on the Account while using the Profile Leverage Currency.
Netting will be disabled if the Profile Leverage Symbol is used (either alone or together with the Profile
Leverage Currency).
Specific symbol lines can be deleted from the Profile Leverage Symbol in case netting needs to be
enabled while using both Symbol and Currency Profiles.
If both Profile Currency and Profile Leverage Symbol are assigned on the the group then most specific
will be used which is Profile Leverage Symbol and the positions will not be netted.
www.primexm.com
| 10
Account Management | 11
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default
attribute required attribute type editable description
settings
Note: The settings of a leverage symbol profile can be configured in the Leverage Profile Symbol
Setting component.
Technical Specifications
The Profile Leverage Symbol Setting component has the below attributes:
Note: All changes that require XCore restart should be done from the Pending Config component
Important Note: When Profile Leverage Symbol is assigned then the positions will not be netted.
default
attribute required attribute type editable description
settings
www.primexm.com
| 11
Account Management | 12
default
attribute required attribute type editable description
settings
The limit profiles defined in this component can be linked to one or several XCore account groups defined in
the system, and influence the margin calculation and hence the account exposure calculation.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default
attribute required attribute type editable description
settings
Note: The settings of a limit currency profile can be configured in the Profile Currency Setting component.
The Currency Profile Setting Component contains the settings of each currency profile defined in the system.
www.primexm.com
| 12
Account Management | 13
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default attribute
attribute required editable description
settings type
Yes (XCore
profile Y – INT Pending the name of the limit profile
Config)
Yes (XCore
this parameter allows for the limit to be expressed
Ccy Y – STRING Pending
in a currency of choice
Config)
www.primexm.com
| 13
Account Management | 14
default attribute
attribute required editable description
settings type
The limit profiles defined in this component can be linked to one or several XCore account groups defined in
the system, and influence the margin calculation and hence the account exposure calculation.
Technical Specifications
A Symbol Profile for Symbol Position Limits has the following basic attributes:
Note: All changes that require XCore restart should be done from the Pending Config component
default
attribute required attribute type editable description
settings
www.primexm.com
| 14
Account Management | 15
Note: The settings of a limit symbol profile can be configured in the Symbol Profile Setting component.
The Symbol Profile Setting Component contains the settings of each symbol profile defined in the system.
Technical Specifications
Note: All the changes that require XCore restart should be done from the Pending Config component
default attribute
attribute required editable description
settings type
Yes (XCore
profile Y – INT Pending the name of the limit profile
Config)
Yes (XCore
this parameter allows for the limit to be
Ccy Y – STRING Pending
expressed in a currency of choice
Config)
www.primexm.com
| 15
Account Management | 16
default attribute
attribute required editable description
settings type
Dividend Profile
The Account Profile Dividend component displays the dividend profiles defined in the system.
The Account Profile Dividend contains dividend amounts to be distributed per symbol. Once the Dividend
Profile is configured from the Account Profile Dividend Settings component, it must be linked with a specific
XCore Account Group.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default
attribute required attribute type editable description
settings
The name of the dividend profile.
name Y – STRING restart required Note: The dividend profile will be
referred to via its name.
free text for the description of the
description C – STRING restart required
dividend profile
www.primexm.com
| 16
Account Management | 17
The Account Profile Dividend Setting component contains the settings of the symbols to which the dividends
will apply, when the Account Profile Dividend is linked with a specific XCore account group, and there are
open positions under the XCore account.
The dividend amount is charged in the CCY of the instrument and will be applied to the open positions of the
symbols for which the dividend settings have been configured according to the time frame defined in the
settings.
The dividends are booked accordingly as cash to the balance of the XCore account.
Dividend in CCY = position base * short/long values in CCY * conv from dividend_CCY to account ccy
Note: A Settlement Profile needs to be configured separately, which would apply to the dividend profile setup
specifying the timeframe of the application on the positions
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default
attribute required attribute type editable description
settings
restart The name of the dividend profile as it has been
Profile Y – SMALLINT(5)
required configured in the Account Profile Dividend.
restart The name of the symbol as it is configured in the
Symbol Y – VARCHAR(32)
required XCore system on which the dividends will apply.
Paying taxable dividend on Long positions of the
restart
Long Y 0 DOUBLE symbol, which can be only positive.
required
Defined in Quote currency.
Paying taxable dividend on Short positions of
restart
Short Y 0 DOUBLE the symbol, which can be only positive.
required
Defined in Quote currency.
Charging Tax field allows you to enter a
restart percentage value to be deducted from a
Tax Y 0 DOUBLE
required payment, can be only positive values between
0-100.
These markups are configured as percentages
restart not as points.
Markup Y 0 DOUBLE
required Commission Value, can be only positive numbers
from 0-100.
www.primexm.com
| 17
Account Management | 18
default
attribute required attribute type editable description
settings
A pattern that is used to show in the Account
Report in the Comment section to indicate the
symbol, long/short value, and tax that was
charged.
Accepted values that can be used in the
comment section to generate the correct
indications in the reports are:
#SYM# – symbol name
#VALUE# – long/short value
#TAX# – tax value
#CONV# – conv rate which was used between
restart
Comment – – VARCHAR(64) Instrument Quote CCY and Dividend_CCY.
required
In order to have the comment with the
indication of Dividend of Symbol, long or short
value, tax value, and conv in the Report, need to
specify a pattern accordingly to the settings and
conversion rate if needed:
• #SYM#|#VALUE#|#TAX#|#CONV#
Note: If anything else is added besides the
above patterns, the comment section in the
Account Report will be populated as free text
exactly as it is written in the Account Profile
Dividend Setting in the comment column.
Comment restart
– – VARCHAR(64) Comment
2 required
Tick box indication which is marked once the
Done C False TINYINT(4) read only dividends have been charged accordingly with
the settings and time frame defined.
Note: Please note that the dividends do not apply to the symbols of security type FX.
In order to use the dividends in the XCore, an account profile dividend must be created by providing a name
and a description from the Pending Config component.
Once the dividend profile is created, the values of the symbols we need to apply dividends on must be set up,
as well as the time frame when they should apply/be charged.
www.primexm.com
| 18
Account Management | 19
The Account Profile Dividend and Profile Dividend Settlement must be linked with an Account through
the Account Group component.
The Account Group needs to be linked with a specific XCore Account in the Pending Config under the
Account field.
When the specified timeframe applies, according to the configuration under the Account Profile Dividend
Setting component, the dividends will be charged accordingly on the symbols configured to the open positions
in the XCore of the Connector linked with the XCore Account.
www.primexm.com
| 19
Account Management | 20
You can upload a list of the dividend setting into the XCore in case you have already configured them on excel.
1. Open Account Profile Dividend Setting field under the Pending Config component.
2. Press the Upload Settings button to open pop up window.
3. Press the Browse button to find the file that you have already prepared and saved locally on your PC.
4. Press the Upload after you have selected the file from your local PC to upload the settings.
5. Once the changes have uploaded successfully on the XCore they are still pending, therefore you need to
proceed with an Apply&Restart
1. Note that you can proceed with the same process through Real-Time where the changes can be
applied live to avoid the process of Apply&Restart of the XCore which results to small downtime
of the system.
PL Profile
Account Profile PL
The Account Profile PL Component displays the PL profiles defined in the system. A PL profile contains
realized PL settings per symbol.
The PL profiles defined here can be linked to the XCore account groups currently defined in the system, and
influence the time when realized PL actions are performed.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
www.primexm.com
| 20
Account Management | 21
default
attribute required attribute type editable description
settings
The PL Profile Setting component contains the settings of each pl profile defined in the system.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default
attribute required attribute type editable description
settings
www.primexm.com
| 21
Account Management | 22
default
attribute required attribute type editable description
settings
restart
Comment 2 – – VARCHAR(64) Comment
required
Settlement Profile
Profile Settlement
The Account Profile Settlement Component displays the settlement profiles defined in the system. A settlement
profile contains settlement settings per symbol.
The settlement profiles defined here can be linked to the XCore account groups currently defined in the
system, and influence the time when settlement actions (such as swap charges and NOP position
settlement) are performed.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
www.primexm.com
| 22
Account Management | 23
default
attribute required attribute type editable description
settings
Note: Settlement Profiles must be assigned to accounts of type NOP, as well as any account linked to a Swap
Profile.
The settings of a settlement profile can be configured in the Settlement Profile Setting component.
The Settlement Profile Setting component contains the settings of each settlement profile defined in the
system.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default
attribute required attribute type editable description
settings
www.primexm.com
| 23
Account Management | 24
default
attribute required attribute type editable description
settings
Swap Profile
Profile Swap
The Account Profile Swap Component displays the Swap Profiles defined in the system. A Swap Profile
contains swap settings per symbol.
The Swap Profiles defined here can be linked to the XCore account groups currently defined in the system, and
apply charges on positions held overnight.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
www.primexm.com
| 24
Account Management | 25
default
attribute name required attribute type editable description
settings
The settings of a swap profile can be configured in the Swap Profile Setting component.
The Swap Profile Setting Component contains the settings of each swap profile defined in the system.
Technical Specifications
Note: All changes that require XCore restart should be done from the Pending Config component
default
attribute required attribute type editable description
settings
www.primexm.com
| 25
Account Management | 26
default
attribute required attribute type editable description
settings
restart
Comment 2 – – VARCHAR(64) Comment
required
www.primexm.com
| 26
Account Management | 27
Related Posts
The Account Profile Wallet component displays the wallet profiles defined in the system. An account profile
wallet is a mandatory profile that must be assigned on an Account Group.
Technical Specifications
default
attribute required attribute type editable description
setting
The name of the Account Profile Wallet, also
Name Y – SMALLINT Y used in the Account Group wizard to assign the
wallet with account group.
Free text that can be added for the description
Description N – VARCHAR Y
of the Account Profile Wallet.
The account Profile Wallet Setting displays the settings of the account profile wallet indicating the Account
profile wallet name, the name and the description as well as indicating if Swap profile, Pl profile, Dividend
profile is assigned on the Account Group.
Technical Specifications
default
attribute required editable description
settings
Profile Y – read only The name of the Account Profile Wallet
restart The name as it is presented during Operations in the
Name Y –
required Account Dashboard and Specific Reports columns.
www.primexm.com
| 27
Account Management | 28
default
attribute required editable description
settings
restart
Description C n/a free text as a description.
required
The box is ticked accordingly in case the swap profile is
assigned on an Account Group.
Note: When the box is ticked, then you have the option in
Swap C – read only
the Account Dashboard to perform a balance operation
selecting this account wallet for adding manually swap
charges or corrections if needed.
The box is ticked accordingly in case the pl profile is
assigned on an Account Group.
Note: When the box is ticked, then you have the option in
PL C – read only
the Account Dashboard to perform balance operation
selecting this account wallet for adding manually pl
charges or corrections if needed.
The box is ticked accordingly in case the dividend profile
is assigned on an Account Group.
Note: When the box is ticked, then you have the option in
Dividend C – read only
the Account Dashboard to perform balance operation
selecting this account wallet for adding manually dividend
charges or corrections if needed.
The box is ticked accordingly in case the dividend tax is
Dividend Tax C – read only
configured on the dividend profile
www.primexm.com
| 28