Xmanager - User Guide V. 2.8
Xmanager - User Guide V. 2.8
v. 2.8
xManager - User Guide
v. 2.8
07.11.2015 1.8 Joanna Śliwowska Asset Class, Execution Impact, Market Snapshot added
Table of Contents
Introduction ............................................................................................................................. 4
1 Installation .......................................................................................................................... 5
2 Login ................................................................................................................................... 7
3 Menu................................................................................................................................... 9
3.1 Account ............................................................................................................................................... 9
3.2 Manager .............................................................................................................................................. 9
3.3 Reports .............................................................................................................................................. 12
3.4 Tools .................................................................................................................................................. 18
3.5 Help ................................................................................................................................................... 22
3.6 Session timeout ................................................................................................................................. 22
4 Person list.......................................................................................................................... 24
4.1 Person information ........................................................................................................................... 24
4.2 Person accounts ................................................................................................................................ 25
5 Account List ....................................................................................................................... 27
5.1 Change account status ...................................................................................................................... 28
5.2 Open position correction .................................................................................................................. 29
5.3 Bulk operations ................................................................................................................................. 29
6 Main Functionality ............................................................................................................. 32
6.1 New/Edit Account ............................................................................................................................. 32
6.2 Change Password .............................................................................................................................. 34
6.3 Check password ................................................................................................................................ 34
6.4 Cash Operations ................................................................................................................................ 35
6.5 Order tab ........................................................................................................................................... 38
6.6 Execution tab..................................................................................................................................... 41
6.7 Position tab ....................................................................................................................................... 43
6.8 Closed Trades tab .............................................................................................................................. 48
6.9 Ledger tab ......................................................................................................................................... 52
6.10 Journal tab......................................................................................................................................... 55
6.11 Dealing tab ........................................................................................................................................ 57
6.12 History Reports tab ........................................................................................................................... 59
6.13 Pending order reports ....................................................................................................................... 60
6.14 IB Accounts tab ................................................................................................................................. 61
6.15 User list tab ....................................................................................................................................... 74
6.16 Account Group list tab ...................................................................................................................... 77
6.17 Pending Orders tab ........................................................................................................................... 83
6.18 AML Report ....................................................................................................................................... 86
6.19 Cash Stock ......................................................................................................................................... 87
6.20 Promotion ......................................................................................................................................... 88
7 Opening a new transaction ................................................................................................ 89
7.1 Open position .................................................................................................................................... 89
7.2 Close/modify position ....................................................................................................................... 90
7.3 Pending order .................................................................................................................................... 95
8 Corrections ........................................................................................................................ 97
8.1 Open position correction .................................................................................................................. 97
8.2 Closed trade correction ..................................................................................................................... 97
8.3 Ledger correction .............................................................................................................................. 98
Introduction
The main goal of xManager is to process trade operations and to manage clients’ accounts.
Main functionalities:
System requirements:
1 Installation
Double-click the xManagerClient.exe file to start the installation process, and follow the instructions on the screen.
Then follow the instructions. Click Finish when the installation process is complete.
2 Login
Before the first login you will need to add a new connection:
If you use several connections, you can sort them by using two arrows (i.e. icons) located under the connection list
window - . The first listed connection will be displayed by default in the Login window.
In Login window select the Server, then enter your login and password, and click OK.
3 Menu
When the user is logged in, the list of all persons are displayed. In the top menu the following options are available:
Account
Manager
Reports
Tools
Help
3.1 Account
The functionalities listed in Account menu will be described later in this document.
3.2 Manager
In the Manager menu one can change manager's password, check permissions -granted rights, the list of available
groups, and connection information:
3.2.3 Connection
Detailed connection information is displayed when clicking “Connection...” button:
3.3 Reports
To run a report, select report origin and enter a valid hedge account number:
xRisk origin report displays orders from requested hedge account, placed as a result of xRisk hedging activity.
xStation origin report displays orders from requested hedge account, placed as a result of manual trading through
xStation trading platform.
The report uses Position Report which is generated once a day at defined time.
Example:
When the Report time (trading server setting) is set precisely to 0:00, and the Client is generating report from
14.07.2014 to 14.08.2014, the request is created on a basis of:
The report is calculated as a sum of closed trades and open positions from end of the report date minus net profit
from the beginning of the report range.
Unit profit presented in the report is calculated from closed trades section as net profit divided by number of
executed Lots.
3.4 Tools
After selecting Tools/Settings you will see a pop-up window allowing to change application style or to use advanced
application settings:
Custom mode allow user to choose which account or account group will be fetched. The accounts group which are
available to choose are dependent on user account settings and group assignments. This settings also add "Selects
Additional setting "Fetch expired accounts" allows to decide if accounts in status "Expired", "Expired Login Available"
will be fetch in both method.
Search for accounts with specified login, surname or email can have two more steps.
3.5 Help
Due to xManager user inactivity, application can be locked. In this case, session expired message is displayed. In
order to recover session user has to type correct password. Session expiration message will be followed by warning,
stating that session will expire soon.
4 Person list
To open Person Information window user can either double click on selected person or right-click and then choose
the Person Information option. User can check and change password for this person. User can edit personal
information on selected person.
On the second tab of Person Dialog is list of accounts connected to selected person.
User can create new account for selected person by clicking "New account..." button.
Person account can be transferred to another person with use of "Transfer account".
5 Account List
When you right click a selected account, the following options will be available in the context menu:
Trading information data is not refreshed automatically. Data is refreshed when application starts, and every time
when a modification on any selected account is made. In order to refresh it manually, for all accounts the Refresh
button needs to be pushed.
Active
Blocked
Expired
No trading
Close only
Expired login available
It is possible to perform bulk operations on selected accounts. In order to select several records, click the starting
record and drag the mouse to your last choice or, using keyboard, press and hold Shift and by using arrows, select
accounts.
You can arrange the view by showing/hiding the columns. Auto arrange adjusts the column width:
6 Main Functionality
Gross option allows to set net/gross account. When the account is ‘net’, buy and sell transactions will mutually net
each other.
You cannot change user’s group if a destination group has different currency, or any transaction was opened on
a selected account.
By use of the Refresh button account trading information (i.e. Margin, Free margin, Equity) can be refreshed.
select an account and choose Change Password option in Account in the top menu bar or
click Change password icon or
right-click the selected account and choose Change Password from the context menu or
double click a selected account and press Change password button.
A pop-up window will show up, allowing to change the selected person’s password.
A pop-up window will show up, allowing to check the selected account’s password.
6.4.1 Deposit
There are four ways to deposit cash to an account:
select an account and choose Cash operations from Account in the top menu bar, or
select an account and click Cash operations icon, or
right-click the selected account and choose Cash operations from the context menu, or
double click a selected account and press Cash operations button.
A new window will pop up. Set the amount of money you wish to transfer, type a comment, and click Deposit.
6.4.2 Withdrawal
To withdraw money from the account, follow the same procedure as the above.
Order tab displays a list of all orders from a selected time period.
To narrow your search you can filter data by Account and Group.
pending new/new – status before the server response, at the moment of placing an order – invisible for the
user
accepted – order accepted, not yet executed
rejected – order rejected
pending cancel – order waiting for cancellation – invisible for the user
cancelled – order cancelled (e.g. cancelled pending order)
pending modify – order waiting for modification – invisible for the user
expired – order cancelled because of expiration date
filled – order executed
partial-filled – order partially executed (e.g. pending orders, or take profit/stop loss for PRO account)
system-cancelled – cancelled by the system
limit – buy limit, sell limit (Take Profit for transaction type SELL is Buy Limit, Take Profit for transaction type
BUY is Sell Limit)
market – all other transactions
You can arrange the view by showing/hiding the columns. Auto arrange adjusts column width:
You can arrange the view by showing/hiding the columns. Auto arrange adjusts the column width:
Position tab displays a list of all open positions. Data can be sorted in all columns.
To narrow your search you can filter data by Account and Group or set your own report.
Show summary option allows you to view aggregated information arranged by Instrument names.
Financial summary may be displayed in EUR or in your local currency (as set in Tools/Settings).
Close profitable will select only position which are profitable at time user click the button.
Close Losing will select only position which are losing at time user click the button.
Operation will be summarized in short report containing succeeded and failed operations.
You can arrange the view by showing/hiding the columns. Auto arrange adjusts column width:
Closed Trades tab shows information about all closed trades. Data can be sorted in all columns.
You can arrange the view by showing/hiding the columns. Auto arrange adjusts column width:
To narrow your search you can filter data by Group and Account:
To set your own report select Report from the list and click Add:
A pop up window will be displayed. Set a name for the report and select accounts by moving them to the right
window.
You can also add groups to the report. By doing so, all the users assigned to the selected group, will be added to the
report.
The report can be exported to .csv file on your local drive. This is a comma separated values file:
To have a spreadsheet view you can open the file with MS Excel or Open Office Calc.
If you have difficulties in correct display of the spreadsheet, or if the filtering is not working properly, go to MS Excel
Options -> Advanced -> Editing Options:
Manager can change comment of the closed trades record by using "Make comment correction".
Ledger tab shows information about financial operations, closed positions and correction data.
Manager can change comment of the ledger record by using "Make comment correction".
To narrow your search you can filter data by Account and Group or set your own report.
You can arrange the view by showing/hiding the columns. Auto arrange adjusts column width:
account id;type;amount;currency;comment
Where:
In Journal tab server logs are displayed. Information for the following Action types are listed:
connected
disconnected
login
ledger operation
account info
create account info
update account info
set enable account
set trade enable account
set account password
You can specify parameters, action and login you want to display.
You can arrange the view by showing/hiding the columns. Auto arrange adjusts the column width:
Current trading activity logs from selected accounts are displayed in Dealing tab. Only 50 latest trades and orders are
displayed.
You can choose filter from Select types to narrow down positions and orders which are displayed.
The report can not be exported to .csv file on your local drive.
You can arrange the view by showing/hiding the columns. Auto arrange adjusts the column width:
History Reports tab shows account information (balances, equity etc.) for a selected time period.
You can arrange the view by showing/hiding the columns. Auto arrange adjusts the column width:
Pending order reports shows what pending order was active at selected time. Snapshot of orders are taken daily.
Report is generated for selected account.
You can arrange the view by showing/hiding the columns. Auto arrange adjusts the column width:
Introducing Broker (IB) can collect commissions based on transactions traded by his clients introduced to XOH.
To run this service the following steps should be taken by xManager User:
1. Create IB account. To do so, create a new trading account or modify an existing account. Select IB Account
option.
2. IB Client account can be assigned to IB account in the Account Window by selecting a login from the
dropdown list.
You can arrange the view by showing/hiding the columns. Auto arrange adjusts the column width:
account id;type;amount;currency;comment
Where:
6.14.2 IB details
By double clicking a selected IB account you can get details about IB. The following sections are available:
Settings
Commission pattern setup
Introduced accounts
Positions
Closed trades
IB commissions
In the next paragraphs you can find detailed information about each section.
6.14.2.1 Settings
In the Settings window IB commissions can be added and assigned to available groups. Commission pattern should
be set first. (see: Commission pattern setup tab).
IB clients information selected in Access settings section will be visible for IBs in xStation.
When creating a new commission, you can copy instrument class settings from an existing group:
The newly created group will be displayed in the Commission settings list.
Commission will be charged in the selected "Commission Pattern" currency and, if necessary, converted to the IB
Account currency.
1. Fixed Value – set as value in selected currency, calculated per 1 Lot once trade is closed
2. % of client Commission – set as % of commission calculated from executed trades (only when commission is
charged)
3. Pips per lot – set in pips according to Instrument Precision (e.g. EURUSD; Precision=5, value: 1 = 1USD)
With regard to “% of client Commission” and “Pips per lot” selected Commission currency will have no impact on
performed calculation. Finally all commissions are booked in IB account currency.
6.14.2.4 Positions
All positions opened by assigned IB clients are listed in this section.
6.14.2.6 IB commissions
All applied IB commissions per trade are listed in this section.
As a next step a proper Group(s) need to be allocated to the User. Available groups are displayed below the data
form. During first usage there can be no Groups created so the User will have no Groups assigned. Groups can be
added to the User at any time, to do so use “Update User…” option. Process of creating a New Group is described in
Account Group list section of this Manual, §6.16.
After confirmation the User appears on available Users list with additional modification options, i.e.: Copy, Update,
Delete. If necessary, the User data can be changed.
To delete a role, click "Role setup" button and select a role from the list on the right. Click "Delete" button.
User is obliged to set Group’s name, currency, mirror book type and max trade nominal.
Name - the Group name has to be unique within the XOH environment.
When a customer’s trade is passed through to a liquidity provider, this is known as Abooking. When this happens
brokerages turn a profit by marking up the Spread, or charging commission from their customers.
In case when the brokerage takes the other side of a customer’s trade it means B-booking. When this happens
brokerages total profit can often be equal to the total losses of the trades placed on their B-book.
Please be aware that for B-booking the trades, you should obtain appropriate license and meet certain capital
requirements.
Please notice that this setting (A Book/B Book) cannot be changed later. The new trading group has to be created
with a different A Book/B book setting.
What is more all the newly created B Book groups will appear in the xRisk automatically.
Max trade nominal refers to maximum value of open positions for the chosen Group. By setting "0" User agrees to
unlimited position value for this Group.
Final step of configuration is adding Instrument Class to the created Group. Each Group can have more than one
Instrument Class added.
According to agreed business conditions different Class names (with their constituents displayed next to Class
names), Execution Types and Commission Patterns shall be accessible as a default.
Deviation define maximum acceptable deviation from the market price for transaction execution (in pips).
Min lots and Max lots define trading conditions on Instruments from chosen Instrument Class.
A new group can be also created by copying an existing group. Right click a selected group and click "Copy account
group":
To delete a commission pattern, click "Commission pattern setup" button and select a pattern from the list on the
right. Click "Remove" button.
Pending Orders tab displays a list of all pending orders from a selected time period
To narrow your search you can filter data by Account, Group or Order ID.
limit – buy limit, sell limit (Take Profit for transaction type SELL is Buy Limit, Take Profit for transaction type
BUY is Sell Limit)
market – buy stop, sell stop
You can arrange the view by showing/hiding the columns. Auto arrange adjusts column width:
Group close is available for pending orders in right-click menu when more than one order is selected. After
confirmation, selected pending orders will be cancelled.
You can generate Anti Money Laundering report for chosen period of time which contains compact data with action
on account. Report can be export to CSV and PDF format.
“Export” button generate report in CSV format with all visible columns.
“Export ext.” button generate report in PDF format. Report do not have some columns (Comment, Asset class,
Origin).
Blocked quantity – informs how many stocks are sold or waiting to be sell.
6.20 Promotion
Nominal left – informs what nominal value left as a part of the promotion.
Orders left – informs what number of orders left as a part of the promotion.
“Export” button generates report in CSV format with all visible columns.
To open a new position, go to the selected Account Details and choose Position tab.
Click “New position” button. A pop up window will be displayed, allowing to open a new trade:
To close/modify a position, go to the selected Account Details and choose Position tab.
To modify position change the value of "Stop loss", "Take profit" then click Modify button. The operation will be
confirmed with:
Confirm that you really want to close that position. Operation will be confirmed with:
To close only profitable trades from the list click Close Profitable button.
To close only losing trades from the list click Close Losing button.
To modify more than one position choose positions to modify and then right click.
Change value of "Stop loss" or "Take profit" and select Modify all button.
To open a new pending order, go to the selected “Account Details” and choose “Pending Orders” tab.
Click “New order” button. A pop up window will be displayed, allowing you to open a new trade:
8 Corrections
A new entry will be created. The transaction will be listed in Order tab with the Order Origin labelled correction, and
in Position tab.
To make a correction on a closed trade, go to Closed Trades tab and right click the selected trade:
You can edit profit, swap and commission. When you click Correct, the corrected trade will be displayed with new
values.
To make a ledger correction, go to Ledgers tab and right click a selected entry:
A pop up window will be displayed. Set the correct amount and write a comment. Click OK.
A new entry will be created with a type “correction”, with a new Ledger ID.
closed trade
swap
commission.
To correct an open position, go to the Position tab and right click a selected entry:
The position will be closed and listed in the Closed Trades tab. The profit of the position will be 0.
To make a correction on an open position (modify or close), go to the Position tab and right click a selected entry:
A context menu will be displayed. Click Correction - open position. A following window will appear:
In order to correct the swap amount, enter a correct value and click "Update swap". The position swap will be
updated.
In order to close a position with your price, tick the checkbox "Close price", define the Close price and Volume, and
click "Close" button. Alternatively, you can close a position with given price and chosen Volume. The position will be
closed at the selected price, and listed in the Closed Trades tab.
To make a correction on an execution, go to the Executions tab and right click a selected entry:
A context menu will be displayed. Click Update execution settlement date. A following window will appear:
In order to correct the settlement date, enter a correct value and click "OK". The settlement date will be updated.
9 Example
1. A customer wants to open a transaction for 10 lots of EURUSD at price 1.30. He sets an order no. 1000 buy
(type: market). The order is accepted (status: accepted) and executed (status: filled). A new position is opened
with a number 1001 (position id: 1001).
In xStation application, Open Positions tab, both IDs are displayed:
open Order ID (1000) and
Position ID (1001)
The customer sets Take Profit at price 1.32 (order id: 1002, side: sell, type: limit, status: accepted).
In xManager application ,Order tab, Comment SYS column, there is information about the particular order
related to position 1001.
When the price reaches 1.32, the order is executed (status: filled). History tab in xStation shows both:
closed order id (1002) and
closed position id (1001).
If any of the following events occurred: Take Profit, Stop Loss or Stopout – the information about it will be
displayed in a ‘Comment’ column in History.
The same information is displayed in xManager application, Closed Trades tab.
2. A customer places a Sell Stop pending order for 10 lots of EURUSD at price 1.2850. The order number is: 1003
(type: market). The order is accepted (status: accepted, side: sell).
The customer sets take profit price at 1.2800 and stop loss at 1.2900 – both prices are displayed in columns:
‘Takeprofit price’ and
‘Stoploss price’.
When the order is executed (1003 order status: filled), a new position is created (position id: 1004) and there
are new entries in Order tab:
1005 (side: buy, type: market, status: accepted) – stop loss for filled order, and
1006 (side: buy, type: limit, status: accepted) – take profit for position 1004.
select Log out option in the Account in the top menu bar or
click Log out icon.
10.2 Quit
In order to quit the xManager application, select Quit option in the Account in the top menu bar.