Beruflich Dokumente
Kultur Dokumente
MAG-2.1.3 | Confidential
About This Document
This document describes the normalized FIX 4.2 to 4.4 messages for the inbound connectivity client-side of the MAG on EMEA equity markets.
Copyright Information
All other products or services mentioned herein may be trademarks of their respective owners.
Neither the whole nor any part of the information contained in, or the product described in, this document may be adapted or reproduced in any material form except with the prior written
permission of the copyright holder.
The product described in this document is subject to continuous development and improvement. All particulars of the product and its use contained in this document are given by Celoxica Limited
in good faith. However, all warranties implied or express, including but not limited to implied warranties of merchantability, or fitness for purpose, are excluded.
This document is intended only to assist the reader in the use of the product. Celoxica Limited shall not be liable for any loss or damage arising from the use of any information in this document, or
any incorrect use of the product. The information contained herein is subject to change without notice and is for general guidance only.
Copyright 1991 - 2017 Celoxica Limited. All rights reserved.
Sales sales@celoxica.com
Customer Support support@celoxica.com
Website http://www.celoxica.com
This section describes the MAG format of the normalized FIX 4.2 to 4.4 messages for the FIX 1.1.2.2 Borsa Italiana Millennium
session, the sponsored client inbound and outbound connectivity.
Venue Protocol
1.1 Rules of Engagement
BIT cash market Millennium Native Trading Gateway
1.1.1 Conventions
Messages are considered as inbound messages if they are sent to MAG e.g. the applicative Documentation BIT Millennium Exchange
messages sent by the sponsored client i.e. Client MAG.
MIT 203 Native Trading Gateway
Messages are considered as outbound messages if they are generated by MAG e.g. the
Version 8.3
applicative messages received by the sponsored client i.e. Client MAG.
Date September 2016
How to interpret the Required (Reqd) column: a Y marks the field as required / always
provided in MAG implementation. No entry means that the field is optional.
Click on a tag name to access to the tag definition in the tag library.
1.1.2.3 Borsa Istanbul
Refer to each market specifications to get the exchange specific values of some tags.
1.1.2.1 Bats Europe Borsa Istanbul cash market Genium INET OUCH
Version 4.00.8
Documentation Euronext Cash Regulated Markets
Date December 12, 2016
CCG Client Specifications Binary Interface
Version 2.30
Venue Protocol
1.1.2.5 LSE Millennium
Oslo Brs cash market Millennium Native Trading Gateway
Venue Protocol
Documentation Millennium Exchange - Oslo Brs cash equities and fixed income markets
LSE cash market Millennium Native Trading Gateway
OSLMIT 203 Native Trading Gateway
Version 5.1
Documentation London Stock Exchange
Date June 23, 2016
MIT 203 Native Trading Gateway
Version 11.7
Venue Protocol
1.1.2.6 Nasdaq Nordic
Turquoise cash market Millennium Native Trading Gateway
Venue Protocol
Date April 11, 2016 MAG however provides the exchange native symbology and the ISIN symbology in the
outbound messages Client MAG.
Venue Protocol
Xetra Enhanced Transaction Solution
Version R16
1.1.4 Symbology
MAG supports the following symbology in the inbound messages Client MAG:
2. ISIN symbology:
No Tag 22 Yes
present?
No Yes No Yes
Tag 55 Tag 48
present? present?
No Yes
Order Native Order Tag 22 =
rejection symbology rejection 4?
No Yes
Order Tag 207
rejection present?
Order ISIN
rejection symbology
1. The Client Order Identifier ClOrdID [11] is not forwarded to the exchange. This 2. If only tag Account [1] is set:
identifier is forwarded to the client using the Execution Report. Account [1] is used for the in-line risk controls. The default trading account
2. MAG generates its own client order identifier SecondaryClOrdID [526] instead to forwarded to the exchange is taken from the static MAG configuration settings.
guarantee the uniqueness per client FIX session and per trading day. This identifier 3. If only tag RiskAccount [10112] is set:
is forwarded to the client using the Execution Report.
RiskAccount [10112] is used for the in-line risk controls. The default trading
account forwarded to the exchange is taken from the static MAG configuration
1.1.6 Order Identifier
settings.
MAG supports tags OrderID [37] and SecondaryOrderID [198] as follows:
4. If neither tag Account [1] nor RiskAccount [10112] is set:
1. The order identifier as supplied by the venue is provided using tag
The order is rejected.
SecondaryOrderID [198]
2. MAG generates its own order identifier OrderID [37] to guarantee the uniqueness 1.1.9 Allowable Tag Values per Venue
per trading day.
The following sections provide the supported values per venue for some tags.
1.1.7 Execution Identifier
MAG supports tags ExecID [17], SecondaryExecID [527] and VenueExecID [10017] as
follows:
a. The native trade identifier as supplied by the venue for trades, trade
cancellations and trade corrections
2. MAG generates its own execution identifier ExecID [17] to guarantee the
uniqueness per trading day.
G H Q
All or none Reinstate Cancel
on on
system system
failure failure
Bats Europe
Borsa Istanbul Genium INET FIX
Borsa Istanbul Genium INET OUCH
Borsa Italiana Millennium
Euronext cash
LSE Millennium
Nasdaq Nordic Genium INET OUCH
Oslo Brs Millennium
Turquoise Millennium
Xetra ETS
1 2 3 4 6 K P
Market Limit Stop Loss Stop Limit With or Without Market With Left Over as Limit Pegged
Bats Europe
Borsa Istanbul Genium INET FIX
Borsa Istanbul Genium INET OUCH
Borsa Italiana Millennium
Euronext cash
LSE Millennium
2 4 5 99
Mid-price peg Market peg Primary peg Alternate mid-point peg
Bats Europe
Borsa Istanbul Genium INET FIX
Borsa Istanbul Genium INET OUCH
Borsa Italiana Millennium
Euronext cash
LSE Millennium
Nasdaq Nordic Genium INET OUCH
Oslo Brs Millennium
Turquoise Millennium
Xetra ETS
0 2 3 4 7 8 9 H S
Day At the Opening Fill And Kill Fill or Kill At the Close Good Through At Crossing Good for Halt Good Till End of Session
OPG IOC FOK Crossing GFA Crossing GTS
1
GFS
Bats Europe
Borsa Istanbul Genium INET FIX
Borsa Istanbul Genium INET OUCH
Borsa Italiana Millennium
Euronext cash
LSE Millennium
Nasdaq Nordic Genium INET OUCH
Oslo Brs Millennium
Turquoise Millennium
Xetra ETS
Cross orders (TimeInForce [59] = 2, 7, 8, H) are submitted as immediate or cancel orders. This ensures that any cross order does not stay live beyond the cross. As a consequence cross orders
for which unexecuted portion enters the continuous market after the cross are not supported.
1
Good For Scheduled intra-day auction
- The tag is mandatory if the Client MAG FIX session targets more than one venue. 52 SendingTime Y Time of message transmission
Tag ExDestination [100] or the default configured MIC is echoed back in LastMkt [30]. 57 TargetSubID Identifier of the message specific receptor
For Borsa Istanbul, MAG automatically routes the order to the correct exchange partition, 122 OrigSendingTime Original time of message transmission
thanks to the partition ID provided in the Genium INET FIX security definition message.
The message header identifies the type, length, destination, sequence number, time and Tag Name Reqd Description
point of origin of each message. 10 CheckSum Y Check sum
The message header is made of the following tags:
Header Y MsgType = A
108 HeartBtInt Y Heart-beat interval in seconds The Resend Request (2) message is used when a gap in the sequence numbers is detected.
Header Y MsgType = 2
Message sequence number of first message in range to be
7 BeginSeqNo Y
1.3.3 Heart-beat resent
Message sequence number of last message in range to be
The Heart-beat (0) message is used to monitor the status of the communication link during 16 EndSeqNo Y
resent
inactivity periods.
Trailer Y
The Heart-beat (0) message is made of the following tags:
The Logout (5) message is made of the following tags: The New Order Single (D) message is used to place a new order.
The New Order Single (D) message is made of the following tags:
Order amended 0 5 5
The Order Mass Cancel Request (q) message requests the cancellation of all orders.
The Execution Report (8) message is also used to relay an unsolicited order change which
The Order Mass Cancel Request (q) message is made of the following tags:
can be:
Tag Name Reqd Description
A partial fill;
Trailer Y
The Order Mass Cancel Report (r) message is made of the following tags:
Header Y MsgType = r
Execution Venue
Access Handler
8
In-line Risk
D
FIX Engine
Execution Venue
Client
Access Handler
8
In-line Risk
FIX Engine
G G
Client
Native request
D D 1xn8 1xn8
Native request
Native report
1xn8 1xn8
Native report Figure 2 Order cancel replace request kinematics
Execution Venue
Access Handler
In-line Risk
FIX Engine
Execution Venue
Access Handler
Unsolicited 8
Client
8
F
In-line Risk
F FIX Engine
Client
The request is acknowledged by the execution venue with either a native report
message or one to n generic FIX execution report. The incoming message is then
translated into an execution report message, goes through the risk management
module and is sent back to the trading application.
Execution Venue
Access Handler
Execution Venue
Access Handler
q q
In-line Risk
FIX Engine
In-line Risk
G, F FIX Engine G, F
Client
Native request
Client
Native request
9 9
1 x n 8, 9 1 x n 8, 9 & r
r Native report
Native report
An order mass cancel request is submitted to the risk management module, goes
An order cancel replace request (respectively an order cancel request) is submitted, through the risk management module, is then either translated into a native message
goes through the risk management module, is then either translated into a native request or into the generic FIX order mass cancel request and is sent to the correct
message request or into the generic FIX order cancel replace request (respectively execution venue.
order cancel request) and is sent to the correct execution venue.
The request is acknowledged by the execution venue with either native report
The request is rejected by the execution venue with either a native report message or a messages or generic FIX order mass cancel report and one to n generic FIX execution
generic FIX order cancel reject. The incoming message is then translated into an order report or order cancel reject. The incoming messages are then translated into an order
cancel reject message, goes through the risk management module and is sent back to mass cancel report and one to n execution report or order cancel reject messages, go
the trading application. through the risk management module and are sent back to the trading application.
MAG automatically generates order mass cancel requests which are sent to the
relevant execution venues on behalf of the clients.
Sponsoring
Execution reports are queued by MAG and will be delivered to the sponsoring broker
Broker
Access Handler
Client
FIX Engine
Native request
Execution Venue
1 x n 8, 9 & r
Native report
Sponsoring
Broker
Execution
Drop reports &
Copy 8 unsolicited 8
Native report
D, G, F
Client
Client
Access Handler
In-line Risk
FIX Engine
8 or 9
Access Handler
Execution Venue
In-line Risk
FIX Engine
q
3
Native request
1 x n 8, 9 & r
Native report
MAG automatically generates order mass cancel requests which are sent to the
relevant execution venues on behalf of the client. Figure 9 Business rejects kinematics
Execution reports are queued by MAG and will be delivered to the client when the
session is restored.
An order is submitted and is rejected by MAG for one of the following reasons:
The order is rejected for a reason not related to a risk check (no limit is
breached)
MAG generates an execution report or cancel reject which is sent to the trading
application.
ExecRestatementReason....................................................................................... 41
A - ............................................................................................................................ 38
ExecTransType ...................................................................................................... 42
Account...................................................................................................................38
AvgPx .....................................................................................................................38 ExecType ............................................................................................................... 42
B - ............................................................................................................................ 38 G - ........................................................................................................................... 42
BeginSeqNo ...........................................................................................................38 GapFillFlag ............................................................................................................. 42
BeginString .............................................................................................................38
H -............................................................................................................................ 42
BodyLength ............................................................................................................38
HandlInst ................................................................................................................ 42
BookingType ...........................................................................................................38
HeartBtInt ............................................................................................................... 42
C - ............................................................................................................................ 38
L - ............................................................................................................................ 42
CheckSum ..............................................................................................................38
LastLiquidityIndicator.............................................................................................. 43
ClientID ...................................................................................................................39
LastMkt................................................................................................................... 43
ClOrdID...................................................................................................................39
LastPx .................................................................................................................... 43
ComplianceID .........................................................................................................39
LastShares ............................................................................................................. 43
ContraBroker ..........................................................................................................39
LeavesQty .............................................................................................................. 43
CumQty ..................................................................................................................39
LocateReqd ............................................................................................................ 44
Currency .................................................................................................................39
CxlRejReason .........................................................................................................40 M - ........................................................................................................................... 44
CxlRejResponseTo .................................................................................................40 MarketID................................................................................................................. 44
MassCancelRequestType ...................................................................................... 44
D - ............................................................................................................................ 40
MassCancelRejectReason ..................................................................................... 44
DisplayMethod ........................................................................................................40
MassCancelResponse ........................................................................................... 44
MatchIncrement ..................................................................................................... 44
E - ............................................................................................................................ 40
MaxFloor ................................................................................................................ 44
EncryptMethod........................................................................................................40
MinQty .................................................................................................................... 45
EndSeqNo ..............................................................................................................40
ExDestination .........................................................................................................40 MsgSeqNum .......................................................................................................... 45
MsgType ................................................................................................................ 45
ExecID ....................................................................................................................41
ExecInst ..................................................................................................................41
N -............................................................................................................................ 45
ExecRefID ..............................................................................................................41
NewSeqNo ............................................................................................................. 45
Used in Header
Account
Execution Report
BookingType
Execution Report
BeginSeqNo
It is however strongly recommended to avoid the following non Description Total number of filled shares.
ASCII characters and as they can make
FIX tag 14
some tools crash when they try to display them (no utf8 encoding by
default). Used in Execution Report
See SecondaryClOrdID [526] for details on the client order ID sent to Currency
the exchange.
Description Trading currency, ISO 4217 standard.
FIX tag 11
FIX tag 15
Used in New Order Single
Used in New Order Single
Order Cancel Replace Request
Order Cancel Replace Request
Order Cancel Request
Order Cancel Reject
Order Cancel Reject
Execution Report
Execution Report
3 Order already in pending cancel or pending replace status Description Method of encryption.
EndSeqNo
Description Identifies the type of request that the Cancel Reject is in response FIX tag 16
to.
Used in Resend Request
Allowable values 1 Order cancel request
XMIL Milan
DisplayMethod
TRQX Turquoise
Description Display method.
XOSL Oslo
Allowable values 3 Random
XPAR Euronext Paris
Description Flag used to indicate that the Sequence Reset message is replacing
ExecTransType administrative or application messages that will not be resent.
Description Execution transaction type. Allowable values Y Gap Fill message, MsgSeqNum [34] field valid
Allowable values 0 New N Sequence reset, ignore MsgSeqNum [34]
1 Cancel FIX tag 123
2 Correct Used in Sequence Reset
FIX tag 20
ExecType HandlInst
Description Execution type. Description Instruction for order handling.
Allowable values 0 New Allowable values 1 Automated execution
1 Partially filled FIX tag 21
2 Filled Used in New Order Single
4 Cancelled Order Cancel Replace Request
5 Replaced
8 Rejected HeartBtInt
9 Suspended Description Heart-beat interval.
C Expired FIX tag 108
D Restated Used in Logon
FIX tag 150
LastMkt LastPx
Description Market of execution for last fill, MIC ISO 10383 standard. Description Price of the last fill.
XLON London
Y Indicates the broker is responsible for locating the stock FIX tag 532
N-
MsgSeqNum
0 Heart-beat
OrderCapacity
1 test request
Description Order capacity.
2 Resend request
Allowable values A Agency
3 Reject
P Principal
4 Sequence Reset
F Fund Order
5 Logout
21 Suspended symbol
OrdRejectReason 22 Contract not allowed
Description Order reject reason. 23 Price tolerance exceeded
MAG provides its own reject code in case of a MAG reject, see 24 Net position exceeded
OrdType
OrdStatus
Description Order type.
Description Current status of the order.
Allowable values 1 Market
In the particular case of an Order Cancel Reject, the current order
status is set as follows: 2 Limit
3 Stop Loss
PegOffsetValue
4 Stop Limit
Description Amount (signed) added to the price of the peg.
6 With or Without
FIX tag 211
K Market With Left Over as Limit
Used in New Order Single
P Pegged
FIX tag 40
PegPriceType
Used in New Order Single
Description Defines the type of peg.
Order Cancel Replace Request
Allowable values 2 Mid-price peg
Execution Report
4 Market peg
5 Primary peg
OrgClOrdID
99 Alternate mid-point peg (less aggressive on midpoint and 1
Description Original client order identifier. tick inside PBBO)
FIX tag 41 FIX tag 1094
Used in Order Cancel Replace Request Used in New Order Single
Order Cancel Request Order Cancel Replace Request
Order Cancel Reject Execution Report
Execution Report
PossDupFlag
OrigSendingTime Description Indicates possible retransmission of message
Description Original time of message transmission when transmitting orders as Allowable values Y Possible duplicate
the result of a resend request.
N Original transmission
FIX tag 122
FIX tag 43
Used in Header
Used in Header
Price SecondaryExecID
FIX tag 44 See section 1.1.7 for the execution identifier usage.
Execution Report
SecondaryClOrdID
Execution Report
ResetSeqNumFlag
Description Indicates that the both sides of the FIX session should reset SecondaryOrderID
sequence numbers.
Description Order identifier supplied by the venue.
See section 1.1.4 for the symbology usage. Used in New Order Single
Set to the destination market in inbound Client MAG messages. Order Cancel Replace Request
Set to the security primary MIC in outbound Client MAG Execution Report
messages. Order Cancel Reject
FIX tag 207
Symbol
SendingTime
Description Symbol.
Description Time of message transmission.
See section 1.1.4 for the symbology usage.
Represented in Universal Time Coordinated UTC in either
YYYYMMDD-HH:MM:SS (whole seconds) or YYYYMMDD- FIX tag 55
HH:MM:SS.sss (milliseconds) format. Used in New Order Single
FIX tag 52 Order Cancel Replace Request
Used in Header Execution Report
2 Sell TargetCompID
5 Sell short Description Identifier of the message receptor.
FIX tag 54 FIX tag 56
Used in New Order Single Used in Header
Order Cancel Replace Request
Execution Report
TargetSubID
7 At the Close
TestReqID
8 Good through Crossing (used for Good for the next
Description Test request message identifier. scheduled auction GFS)
FIX tag 112 9 At Crossing
Used in Heart-beat H Good for Halt Crossing
Test Request S Good till end of session (GTS)
FIX tag 59
When enabled at the client session level in the MAG configuration Execution Report
settings, the free text is prefixed with:
TriggerPrice TriggerSymbol
Description The price at which the trigger should hit. Description Defines the common, 'human understood' representation of the
security whose prices will be tracked by the trigger logic.
FIX tag 1102
FIX tag 1103
Used in New Order Single
Used in New Order Single
Execution Report
Execution Report
TriggerPriceDirection
TriggerTradingSessionID
Description The side from which the trigger price is reached.
Description Defines the trading session at which the order will be activated.
Allowable values U Trigger if the price of the specified type goes UP to or
Execution Report
TriggerType
Description Defines when the trigger will hit, i.e. the action specified by the
trigger instructions will come into effect.
4 Price movement
Execution Report
Allowable values 1 Client See Oslo Brs Millennium specifications for details.
C Auction 99 Only accept order if it will not match with visible contra
order. Otherwise expire order.
O Other liquidity
100 Only accept order if setting new visible BBO, otherwise
FIX tag 6001 expire order.
Used in Execution Report FIX tag 9220
Description Indicates the self-trade prevention instruction. See Nasdaq Nordic Genium INET OUCH specifications
for details.
See Euronext Cash specifications for details.
Allowable values Pass-through field as STPTraderGroup on Nasdaq
See Bats Europe specifications for details. Nordic Genium INET OUCH.
See Nasdaq Nordic Genium INET OUCH specifications FIX tag 8002
for details.
Used in New Order Single
Allowable values Pass-through field as STPIndicator on Euronext
Order Cancel Replace Request
Pass-through field as PreventMatch on Bats Europe.
For Oslo Brs, it should adhere to the standard given by Oslo Brs.
VenueExecID