Application level messages (Other)

Route status request

Request status information for TraderEvolution routes.

Tag	Field Name	Required	Comments
	Standard Header	Y	MsgType = UAR (uppercase)
18200	GatewayStatusReqId	Y	ID for this route status request.
263	SubscriptionRequestType	N	Not supported.
	Standard Trailer	Y

Route status

The Route Status message is sent on client logon or returned by the server in response to a Route Status Request.

Tag	Field Name	Required	Comments
	Standard Header	Y	MsgType = UAT (uppercase)
20009	NodeID	Y	ID of the node, where this route was started
18200	GatewayStatusReqId	N	ID for this route status request.
18201	NoGatewayStatus	Y	Number of status messages contained in this repeating group.
18202	Gateway status		Current status of the route. Possible values include: • 1: Halted • 2: Open • 3: Closed. Generally, to user will be send only Route Status message with GatewayStatus=2
207	SecurityExchange	Y	Route name.
20015	QuoteSecurityExchange	Y	Info route name. If group with SubExchangeGateway=1 is not set, subscription process should use this security Exchange
18203	ExchangeGateway	Y	Route name
18204	SubExchangeGateway	Y	Type of TraderEvolution route. Valid values include: 1 - Price, 2 - Order (i.e. trade)
	Standard Trailer	Y

Account status message

The Account Status Message is used for sending account info to clients. It is sent by the server on client logon and when account info is changed.

Tag	Field Name	Required	Description
	Standard Header	Y	MsgType = UAA (uppercase)
60	TransactTime	Y	The time when the message was sent
20033	MessageMode	Y	Defines type of action: 0 - Account is created, 1 - Account is updated
20034	AccountCreationDate	Y	Account creation date
7001	AccountId	Y	Account id
20035	AccountStatus	Y	Defines the status of the account. Possible values: 0 – Offline, 1 – Online, 2 – Removed
1	Account	N	Account name
20036	AccountMode	N	Mode. Possible values: 0 – Demo, 1 – Live, 2 – Contest
7008	TradingAccountStatus	N	Account status. The tag will be sent when the account was created or the parameter was changed. Possible values: 0 – Active, 1 – Closed, 2 – Suspend, 3 - Trading is disabled by risk rules, 4 - FINRA Day trader pattern, 5 - Liquidation only
15	Currency	N	Account currency
20038	StopTradingReason	N	Stop trading reason. Can be sent, if TradingAccountStatus(7008)=Trading is disabled by risk rules (3). Possible values: 0 - None, 1 - Unknown, 2 - Max daily loss is reached, 4 - Max weekly loss is reached, 5 - Max trailing drawdown is reached, 6 - Max unrealized loss is reached, 7 - Max daily profit is reached, 9 - Max orders count per day, 11 - Relative drawdown level is reached
20039	AccountVisibility	N	Defines why account is available for logged user. Possible values: 1 - own account, 2 - account is visible by user group, 4 - account is visible , because it was linked to current user, 8 - account is visible , because it was added to MAM group, 16 - account is visible , because it was added to portfolio system, Another value - account is visible for the current user by combination of this rule
7002	UserId	N	User id
553	Username	N	User login
7006	GroupId	N	User group identifier
20143	TotalPositionsValue	N	Sum of all position values
20144	AvailableCash	N	Amount of funds available for investment before utilizing leverage
20040	Phone	N	Phone number
20041	FirstName	N	First name
20042	LastName	N	Last name
20043	MiddleName	N	Middle name
164	EmailThreadID	N	E-mail
7016	CommissionId	N	Commission plan identifier
20044	MarkupId	N	Markup plan identifier
20045	RiskId	N	Risk plan identifier
20046	CustodialId	N	Custodial plan identifier
20047	SpreadId	N	Spread plan Id
20048	FundingRateId	N	Funding rate markup plan
20049	InterestOnBalanceId	N	Interest on balance Id
20050	SwapId	N	Swap plan Id
20051	MaxDrawdownLevel	N	The setting defines the minimal allowed Projected balance value (in the account currency) for the account not to trigger a Stop out.
20052	WeeklyLossLimit	N	Maximum possible loss in account currency which a trader can have during a week.
20053	MaxPositionQty	N	Maximum possible qty in lots of all positions and orders for all trading instruments.
20054	UnrealisedLossLimit	N	Maximum possible unrealized loss in account currency which a trader can have.
20055	DailyLossLimit	N	Maximum possible loss in account currency which a trader can have during a trading day.
20056	MaxOrdersPerDay	N	The number of orders that the user can place or modify per day
20057	MaxPositionsNumber	N	Maximum number of positions which can be opened by one account
20058	MaxPendingOrders	N	Maximum quantity of pending orders which can be placed by account. When sending a new pending order (Limit, Stop, Stop limit, Tr. stop), the quantity of existed pending orders by all instruments for this account is checked.
20059	MaxOrderCapital	N	The maximum order capital which can be sent by user in account currency
20060	MaxTrailingDrawdown	N	Maximum drawdown level for an account.
20061	LossLimitPerTrade	N	Loss limit per trade in %
20062	MarginWarningLevel	N	Margin warning in %
20063	StopOutLevel	N	Maintenance margin level value needed for the stop out to occur (In %)
20064	MaxOrderAmount	N	The maximum amount for a single order measured in the instrument units.
20065	DayTraderPatternStatus	N	Day trader pattern status. Possible values: 0 - not activated, 1 - activated
20066	DayTraderPatternProtection	N	Protection against accidental marking the account as the Day trader pattern. Possible values: 0 - not activated, 1 - activated
20067	AvailableDayTrade	N	Defines the number of intraday trades that can be performed before the system classifies this account as a Day trader pattern. The tag can be sent if DayTraderPatternProtection = activated
20068	OptionPremium	N	Option premium requirement
20069	InitialMarginWithoutWaived	N	Initial margin without waived
20071	UnusedSettledCashForStocks	N	Unused settled cash for stocks
20072	MaintanceMargin	N	Total margin used for maintenance of a current portfolio in account currency.
20073	UnusedSettledCollateral	N	Unused settled collateral
20074	UnusedIntradayInitialMargin	N	Unused intraday initial margin
20075	UsedOvernightInitialMarginForIntraday	N	Used overnight initial margin for intraday
20076	StockReq	N	Total margin blocked for orders with Stock pre-paid margin type.
20077	StockLiquidity	N	Stocks liquidity
20078	WarningMargin	N	Warning margin requirement for positions and orders.
20079	MarginBeforeWarning	N	Margin available before warning triggering.
20080	UsedMargin	N	Amount of initial margin blocked for all positions and orders taking into account a margin crossing.
20081	WithdrawalAvailable	N	Withdrawal available
20082	WaivedMargin	N	Waived margin value in account currency
20083	CurrentDailyLoss	N	Current daily loss
20084	CurrentWeeklyLoss	N	Current weekly loss
7010	Balance	N	Balance
7034	TradeCount	N	A number of trades done for today
7038	CashBalance	N	A current cash position for an account with taken into account unsettled profit/loss.
20085	CalculatedDrawDown	N	Calculated Drawdown level
20086	CurrentTrailingDrawdownLevel	N	Current Trailing Drawdown level
7037	CreditValue	N	Credit Value
7011	BlockedSum	N	Balance blocked by a broker or by a user for withdrawal or transfer.
7039	ReservedBalance	N	Cash sum of unsettled account operations, which have not been settled
7032	PnL	N	A total profit or loss realized from positions today.
7033	TodayFees	N	Fees paid today.
7035	Amount	N	A total volume traded for today.
20088	UsedUnsettledNegativeCashForStocks	N	Used unsettled negative cash for stocks
20089	UnsettledDeposit	N	Unsettled Deposit
20090	AccruedDividend	N	Accrued dividends
20091	UnsettledLossAvailableForWithdrawal	N	Unsettled loss available for withdrawal
20092	UnsettledProfit	N	Unsettled profit
20093	UnsettledLoss	N	Unsettled loss
20094	UnsettledCollateral	N	Unsettled collateral
20095	WithdrawableUnsettledCollateral	N	Withdrawable unsettled collateral
20096	Collateral	N	Collateral
7031	BeginBalance	N	Begin balance
20097	TodayRebates	N	Today’s rebates
20098	TodayTurnover	N	Today turnover
20099	WithdawableOptionsPremium	N	Withdrawable options premium
20100	UnsettledNegativePremium	N	Unsettled negative premium
20101	UnsettledPositivePremium	N	Unsettled positive premium
20102	UnsettledPremiumFormOpenSell	N	Unsettled premium from open sell
20103	PremiumFromOpenSell	N	Premium from open sell
20104	UnsettledNegativeCashForStocks	N	Used unsettled negative cash for stock
20105	UnsettledPositiveCashForStock	N	Unsettled positive cash for stock
20106	UnusedUnsettledNegativePremium	N	Unused unsettled negative premium
20107	UnusedPremiumFromOpenSell	N	Unsettled option premium from opening short positions
20108	MarginMarketValue	N	Margin market value
20109	MarginTradedBalance	N	Margin traded balance
20110	ShortTradedBalance	N	Short traded balance
20111	MarginEquity	N	Margin Equity
20112	SMAEquity	N	SMA Equity
20113	WithdrawableCashForStocks	N	Withdrawable cash for Stocks
20114	WithdrawableUnsettledPnL	N	Withdrawable unsettled PnL
20115	ProjectedBalance	N	Projected balance
454	NoSecurityAltID	N	Number of repeating groups for available routes. Each group contains two parameters SecurityAltID(455) and SecurityAltIDSource(456)
455	SecurityAltID	N	Route type:Q – info route; T – trade route; TQ – trade + info route.
456	SecurityAltIDSource	N	Route name.
955	BlockedForStocks	N	Funds blocked for stock trading.
956	AvailableMargin	N	Amount of funds which can be used for trading.
957	TotalFee	N	Total commission for the trade.
958	AfterTradeFunds	N	Funds remaining after the trade.
959	ImpactOnFunds	N	Impact of the trade on available funds.
960	AfterTradeMargin	N	Margin after the trade.
961	ImpactOnMargin	N	Difference between current margin and margin after the trade.
20125	RelativeDailyLoss	N	Relative daily loss calculated as: (Current daily loss / Daily loss limit) * 100
20126	RelativeWeeklyLoss	N	Relative weekly loss calculated as: (Current weekly loss / Weekly loss limit) * 100
20127	CurrentUnrealizedLoss	N	Current value of the Unrealized loss limit rule
20128	RelativeUnrealizedLoss	N	Relative Unrealized loss calculated as: (Current unrealized loss / Unrealized loss limit) * 100
20129	CurrentDailyProfit	N	Current value of the Daily profit
20130	RelativeDailyProfit	N	Relative Daily profit calculated as: (Current daily profit / Daily profit target) * 100
20131	RelativeTrailingDrawdownLevel	N	Relative trailing drawdown calculated as: (Trailing drawdown level / Projected balance) * 100
20132	RelativeMaxDrawdown	N	Relative maximum drawdown calculated as: (Max drawdown level / Projected balance) * 100
20133	RelativeMaxRelativeDrawdown	N	Relative maximum relative drawdown calculated as: (Max relative drawdown level / Projected balance) * 100
20134	CurrentTotalPositionQty	N	Current positions qty for Total max position qty rule
20135	CurrentPositionsNumber	N	Current positions number for Max positions # rule
20136	CurrentPendingOrdersNumber	N	Current pending orders number for Max pending orders # rule
20137	CurrentOrdersCountPerDay	N	Current orders number placed per day for Max orders count per day rule
20138	EodTrailingDrawdownLevel	N	EOD trailing drawdown level calculated as: EOD Trailing drawdown level = Current projected balance - EOD trailing drawdown
20139	RelativeEodTrailingDrawdownLevel	N	Relative EOD trailing drawdown level calculated as: (Relative EOD Trailing drawdown level/Projected balance) * 100
20158	CurrentVolumeLimit	N	Current value of the Exposure limit rule counter.
20159	RelativeVolumeLimit	N	Percentage ratio of the current exposure to the exposure limit: (Current exposure / Exposure limit) * 100, rounded to two decimal places.
	Standard Trailer	Y

Request for positions

Tag	Field Name	Required	Comments
	Standard Header	Y	MsgType = AN
710	PosReqID	Y	Unique identifier for the Request for Positions as assigned by the submitter
724	PosReqType	Y	0 = Positions only
55	Symbol	N	If not defined - for all visible instruments
1	Account	Y	TraderEvolution account name
60	TransactTime	Y	Current time in UTC
100	ExDestination	N	Defines how instrument will be identified on the server side. Possible values: Not specified or 100 – instrument is identified from a message; 101 – instrument is identified by the tag set SecurityID(48) + ExDestination(100)
48	SecurityID	N	Tradable instrument ID
	Standard Trailer	Y

Example:

8=FIX.4.4|9=132|35=AN|34=10|49=User|56=TEORDER|52=20131202-

13:06:49.468|60=20131202-13:06:49.467|710=11|1=User|724=0|715=20131202-

13:06:49.467|10=031|

Position report

Tag	Field Name	Required	Comments
	Standard Header	Y	MsgType = AP
1	TraderEvolution Account	Y	TraderEvolution account name
44	Opened price	Y	Opening price
48	SecurityID	Y	Tradable instrument ID
55	Symbol	Y	Symbol name
207	Security exchange	Y	Security exchange route
460	Type ID	Y	Identification number of type
710	Request ID	Y	Identification number of request
721	Position ID	Y	Identification number of position
100	ExDestination	N	Defines route identifier
728	Request Result	Y	Result of request
12	Commission	Y	Commission
20028	Swap	Y	Swap
702	Number of position	N	Position’s number
704	Long Qty	Y	Long quantity
705	Short Qty	Y	Short quantity
	Standard Trailer	Y

Example of the Position report:

> 8=FIX.4.4|9=148|35=AP|34=32|49=TEORDER|52=20200122-14:05:15.719|56=User|1=User|44=1.10908|48=311|55=EUR/USD|207=SAT|460=1|710=12345|721=180311|728=0|702=1|704=1|10=203|

Initial data set

The initial data set message is delivered by the server after sending the list of symbols, accounts, and open positions.

Tag	Field Name	Required	Comments
	Standard Header	Y	MsgType = IDS
58	Text	N	"finishblocktransfer" will always be the value
	Standard Trailer	Y