Украинская биржа 
FIX Protocol 4.2 
Техническая спецификация 
Версия 1.9 									 15.03.2019
Оглавление
1.	Введение
1.1.	История изменений
2.	Список поддерживаемых сообщений
2.1.	Session Level
2.2.	Application Level
3.	Message Structure And General Messages
3.1.	Header
3.2.	Trailer
3.3.	Heart Beat
3.4.	Logon
3.5.	Logout
3.6.	Test Request
3.7.	Resend Request
3.8.	Reject
3.9.	Sequence Reset
4.	Market Data Messages
4.1.	Market Data Request
4.2.	Market Data Request Reject
4.3.	Market Data – Snap Shot / Full Refresh
4.4.	Security Definition Request
4.5.	Security Definition
4.6.	Security Status Request
4.7.	Security Status
5.	Trading Messages
5.1.	New Single Order
5.2.	Order Cancel Request
5.3.	Execution Report
5.4.	Order Cancel Reject
5.5.	Order Status Request

1.	Введение
Документ содержит описание сообщений, блоков и полей протокола FIX версии 4.2, адаптированного для использования в торговой системе Украинской биржи (далее – УБ). 
Описание интерфейса базируется на спецификации протокола FIX (Financial Information Exchange, http://www.fixprotocol.org) версии 4.2; предполагается, что читатель уже знаком с основами этого протокола.
Серым цветом выделены пункты, не реализованные на момент публикации данной версии спецификации, но которые планируется реализовать в будущем.

1.1.	История изменений
Версия	Дата	Описание	
1.7	05.07.2018	Первая публичная версия 	
1.8	30.01.2019	Новые значения в поле 269 по согласованию с Refinitiv (ex Thomson Reuters); Сообщения уровня приложения явным образом разделены на Market Data (Глава 4) and Trading Messages (Глава 5)	
1.9	15.03.2019	Новые типы инструментов в поле 167 – SHS, BON, FND, ADR, GDR, CMD, MSC	
2.	Список поддерживаемых сообщений
2.1.	Session Level
Сообщение	Тип сообщения	
Heart Beat	«0»	
Logon	«A»	
Logout	«5»	
Test Request	«1»	
Resend Request	«2»	
Reject	«3»	
Sequence Reset	«4»	

2.2.	Application Level
Сообщение	Тип сообщения	
New Single Order	«D»	
Order Cancel Request	«F»	
Execution Report	«8»	
Trade Capture Report	«AE»	
Trade Capture Report Request	«AD»	
Order Cancel Reject	«9»	
Market Data Request	«V»	
Market Data Request Reject	«Y»	
Market Data Incremental Refresh	«X»	
Market Data – Snap Shot / Full Refresh	«W»	
Security Definition Request	«c»	
Security Definition	«d»	
Order Status Request	«H»	
Security Status Request	«e»	
Security Status	«f»	
3.	Message Structure And General Messages
Header
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
BeginString	8	О	Значение: «FIX.4.2» – для протокола версии 4.2		
BodyLength	9	О	Длина сообщения в байтах (исключая тэги 8, 9, 10).		
MsgType	35	О	Тип сообщения		
SenderCompID	49	О	Идентификатор отправителя сообщения	CLIENT	
TargetCompID	56	О	Идентификатор получателя сообщения	UXP1	
MsgSeqNum	34	О	Идентификатор сообщения в рамках сессии		
PossDupFlag	43	Н	«Y» – заполняется только для сообщений, отправленных в ответ на ResendRequest		
SendingTime	52	О	Время отправки данного сообщения в формате «YYYYMMDD-HH:MM:SS» (всегда в UTC)	20070830-09:38:26	
OrigSendingTime	122	Н	Время отправки пересылаемого сообщения в формате «YYYYMMDD-HH:MM:SS» (всегда в UTC). Заполняется только для сообщений, отправленных в ответ на ResendRequest.	20070830-09:38:26	

3.2.	Trailer
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
CheckSum	10	О	Контрольная сумма сообщения		

3.3.	Heart Beat
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «0»		
TestReqID	112	Н	Клиентский идентификатор запроса		

3.4.	Logon
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «A»		
EncryptMethod	98	О	Значение: «0» (не использовать криптование)		
HearBitInt	108	О	В секундах		
Password	554	Н	пароль		
ResetSeqNumFlag	141	Н	Сброс счетчика сессии в 1, очистка файла-хранилища отправленных сообщений. Значение: «Y»		

3.5.	Logout
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «5»		
Text	58	Н	Причина закрытия FIX-сессии		

3.6.	Test Request
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «1»		
TestReqID	112	О	Клиентский идентификатор запроса		

3.7.	Resend Request
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «2»		
BeginSeqNo	7	О	Нижняя граница запрашиваемого интервала сообщений		
EndSeqNo	16	О	Верхняя граница запрашиваемого интервала сообщений.
Если «0» или отсутствует, то отсылаются все сообщения, начиная с BeginSeqNo		

3.8.	Reject
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «3»		
Text	58	Н	Причина отклонения сообщения		
SessionRejectReason	373	Н	Код причины отклонения сообщения		
RefTagID	371	О	Номер тэга, при обработке которого возникла ошибка		

3.9.	Sequence Reset
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «4»		
GapFillFlag	123	Н	Значение: «N»		
NewSeqNo	36	О	Номер следующего сообщения, которое будет отправлено Модулем		

4.	Market Data Messages
4.1.	Market Data Request
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «V»		
MDReqID	262	О	Клиентский идентификатор запроса		
NoRelatedSym	146	О	Количество инструментов в данном сообщении. 	1	
Symbol	55	О	Краткое наименование инструмента, не обязательный при заданном SecurityID	CEEN	
SecurityID	48	Н	Код инструмента, не обязательный при заполненных Symbol и SecurityType.	4911	
IDSource	22	Н	Способ идентификации инструмента. Значение: «8» – код биржи		
SecurityType        	167	У	Класс инструмента не обязательный при заданном SecurityID	SHS
	
SubscriptionRequestType	263	О	Тип подписки. Значение: 
●	«1» – SNAPSHOT_PLUS_UPDATES
●	«2» – DISABLE_PREVIOS		
MarketDepth	264	О	Возможные значения:
●	«0» – Full Book,
●	«1» – Top of Book,
●	«N>1» – Best N Prices		
MDUpdateType	265	У	Обязательный тэг при SubscriptionRequestType=1. Возможные значения:
●	«0» – Full Refresh (по умолчанию),
●	«1» – Incremental Refresh		
NoMDEntryTypes	267	О	Количество повторяющихся групп 		
MDEntryType	269	О	Возможные значения:
●	«0» – покупка,
●	«1» – продажа,
●	«2» – последняя сделка
●	«3» – значение индекса
●	«4» – цена открытия,
●	«5» – цена закрытия,
●	«6» – расчетная цена (только для производных инструментов),
●	«7» – максимальное значение за сессию,
●	«8» – минимальное значение за сессию,
●	«9» – средневзвешенное значение за сессию,
●	«v» – количество инструментов (ценных бумаг/контрактов) за сессию,
●	«t» – объём торгов за сессию (в гривнах),
●	«m» – количество сделок за сессию,
●	«r» – crossrate,
●	«s» – real minstep,
●	«Q» – Auction Clearing Price		

4.2.	Market Data Request Reject
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «Y»		
MDReqID	262	О	Клиентский идентификатор запроса		
Text	58	Н	Текстовое описание причины отклонения запроса		
MDReqRejReason	281	Н	Код причины отклонения запроса		

4.3.	Market Data – Snap Shot / Full Refresh
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «W»		
MDReqID	262	Н	Идентификатор запроса		
Symbol	55	О	Краткое наименование инструмента		
SecurityID	48	О	Код инструмента		
SecurityType	167	О	Возможные значения:
«FUT» – для фьючерсов;
«OPT» – для опционов;
«SHS» – для акций;
«BON» – для облигаций;
«FND» – для инвестфондов;
«ADR» – для американских депозитарных расписок;
«GDR» – для глобальных депозитарных расписок;
«CMD» – для товаров;
 «MSC» – для прочих типов инструментов		
NoMDEntriese	268	О	Количество MDEntry-групп в данном сообщении 		
MDEntryType	269	Н	Возможные значения:
●	«0» – покупка,
●	«1» – продажа,
●	«2» – последняя сделка
●	«3» – значение индекса
●	«4» – цена открытия,
●	«5» – цена закрытия,
●	«6» – расчетная цена (только для производных инструментов),
●	«7» – максимальное значение за сессию,
●	«8» – минимальное значение за сессию,
●	«9» – средневзвешенное значение за сессию,
●	«v» – количество инструментов (ценных бумаг/контрактов) за сессию,
●	«t» – объём торгов за сессию (в гривнах),
●	«m» – количество сделок за сессию,
●	 ●	«r» – crossrate
●	«s» – real minstep
●	«Q» – Auction Clearing Price		
MDEntryPx	270	Н	Ценовое значение параметра, указанного в MDEntryType		
MDEntrySize	271	Н	Количественное значение параметра, указанного в MDEntryType		
MDEntryDate	272	Н	Дата последнего изменения параметра		
MDEntryTime	273	Н	Время последнего изменения параметра		
TradingSessionSubID	625	Н	Биржевая сессия		
MDEntryTradeType	20003	Н	MDEntryTradeType посылается только по сделкам в формате <Тип сделки><Признак репо><Часть репо>.
Возможные типы сделок:
• 'Q' – сделка по котировке
• 'B' – двухсторонняя (переговорная) сделка
• 'A' – автоматическая сделка по безадресным заявкам
• 'I' – сделка первичного размещения
Возможные признаки репо:
• ' ' (space) – обычная (не репо) сделка
• 'R' – сделка репо
Возможные части репо:
• '18' – Ближняя часть (1-я сделка) репо 
• '19' – Дальняя часть (2-я нога) репо	<A>< ><>
<B>< ><>
<B><R><18>	

4.4.	Security Definition Request
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «c»		
SequrityReqID	320	О	Клиентский идентификатор запроса		
SecurityReqType	321	О	Возможные значения:
●	«3» – Request List Securities		
IDSource	22		Способ идентификации инструмента. Используется при SecurityReqType=0. Значение: «8» – код биржи		
SecurityID	48		Код инструмента. Используется при SecurityReqType=0		
Symbol	55		Краткое наименование инструмента		
SecurityType        	167		Класс инструмента 	

4.5.	Security Definition
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «d»		
SequrityReqID	320	О	Клиентский идентификатор запроса		
SecurityResponseType	323	Н	Значение: «4» – List Securities returned per request.		
IDSource	22	Н	Значение: «8» – exchange symbol		
TotalNumSecurities	393	Н	Общее количество инструментов		
NoRelatedSym	146	О	Количество инструментов в данном сообщении. =1		
Symbol	55	О	Описание инструмента		
SecurityID	48	О	Код инструмента		
SecurityDesc	107	Н	•	ISIN – для инструментов, у которых он есть 
•	Код в торговой системе для инструментов срочного рынка
•	В других случаях поле может отсутствовать 		
Text	58	Н	Наименование инструмента		
ContractMultiplier	231	Н	Количество единиц базового актива в инструменте.
(для производных инструментов)		
SymbolSfx	65	Н	шаг цены		
MinPriceIncrementAmount	1146	Н	Стоимость шага цены.
(для производных инструментов)		
Currency	15	Н	Валюта инструмента		
RatioQty	319	Н	Размер лота		
TradingSessionID	336	Н	Тип торговой сессии:
• '1' - дневная сессия
• '3' - утренняя сессия
• '5' - вечерняя сессия		
SecurityType	167	О	Возможные значения:
«FUT» – для фьючерсов;
«OPT» – для опционов;
«SHS» – для акций;
«BON» – для облигаций;
«FND» – для инвестфондов;
«ADR» – для американских депозитарных расписок;
«GDR» – для глобальных депозитарных расписок;
«CMD» – для товаров;
 «MSC» – для прочих типов инструментов		
MaturityMonthYear	200	Н	Год и месяц экспирации (для производных инструментов)
В формате yyyymm		
MaturityDay	205	Н	День экспирации (для производных инструментов)		
PutOrCall	201	Н	Для опционов. Возможные значения:
«0» – «CALL»,
«1» – «PUT» 		
StrikePrice	202	Н	Для опционов 		
UnderlyingSymbol	311	Н	Код базового актива.( для производных инструментов)		
UnderlyingSecurityID	309	Н	Код фьючерсного инструмента (для опционов)		

4.6.	Security Status Request
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «e»		
SecurityStatusReqID	324	О	Уникальный идентификатор запроса		
IDSource	22	Н	Способ идентификации инструмента. Значение: «8» – код биржи		
SecurityID	48	У	Код инструмента		
Symbol	55	У	Краткое наименование инструмента		
SecurityType        	167	У	Возможные значения:
«FUT» – для фьючерсов;
«OPT» – для опционов;
«SHS» – для акций;
«BON» – для облигаций;
«FND» – для инвестфондов;
«ADR» – для американских депозитарных расписок;
«GDR» – для глобальных депозитарных расписок;
«CMD» – для товаров;
«MSC» – для прочих типов инструментов	
	
4.7.	Security Status
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «f»		
SecurityStatusReqID	324	О	Уникальный идентификатор запроса		
Symbol	55	Н	Краткое наименование инструмента		
IDSource	22	Н	Способ идентификации инструмента. Значение: «8» – код биржи		
SecurityID	48	Н	Код инструмента		
SecurityType	167	Н	Возможные значения:
«FUT» – для фьючерсов;
«OPT» – для опционов;
«SHS» – для акций;
«BON» – для облигаций;
«FND» – для инвестфондов;
«ADR» – для американских депозитарных расписок;
«GDR» – для глобальных депозитарных расписок;
«CMD» – для товаров;
«MSC» – для прочих типов инструментов		
SecurityTradingStatus	326	Н	Статус торговли инструментом. Возможные значения:
●	«2» – Trading Halt, если статус торговой сессии равен «Заморожена»;
●	«17» – Ready to trade, если статус торговой сессии равен «Открыта»;
●	«18» – Not Available for trading, если статус торговой сессии равен «Закрыта».		
HighPx	332	Н	Максимальная цена сделки за сессию		
LowPx	333	Н	Минимальная цена сделки за сессию		
LastPx	31	Н	Цена последней сделки		
TransactTime	60	Н	Время последней сделки		
5.	Trading Messages
5.1.	New Single Order
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «D»		
ClOrdID	11	О	Уникальный идентификатор заявки (цифровой 0 - 4294967295)		
HandlInst	21	О	Значение: «1»		
Symbol	55	О	Краткое наименование инструмента		
Side	54	О	Возможные значения:
●	«1» – покупка,
●	«2» – продажа		
OrdType	40	О	Тип заявки. Возможные значения:
●	 «2» – лимитированная
●	«R» -- адресная 
		
Account	1	О	Торговый счет.		
ClientID	109	Н	Код клиента. 		
Price	44	O	Цена		
OrderQty	38	О	Количество в заявке в штуках.		
IDSource	22	Н	Способ идентификации инструмента. Значение: «8» – код биржи		
SecurityID	48	Н	Код инструмента		
SecurityType	167	О	Возможные значения:
«FUT» – для фьючерсов;
«OPT» – для опционов;
«SHS» – для акций;
«BON» – для облигаций;
«FND» – для инвестфондов;
«ADR» – для американских депозитарных расписок;
«GDR» – для глобальных депозитарных расписок;
«CMD» – для товаров;
«MSC» – для прочих типов инструментов		
NoPartyID 
	453	Н	Количество элементов в PartyIDs группе, Возможные значения: 1
Заполняется для OrdType = «R»		
PartyID 
	448	У	Идентификатор или код стороны. 
Обязательный при наличии NoPartyID 		
PartyIDSource 
	447	У	Класс/тип или источник идентификаторов сторон. Обязательный при наличии NoPartyID 
Для каждой определенной стороны, поле должно содержать константное значение ‘D’ (Частный/специальный код). 		
PartyRole 
	452	У	‘1’ (Фирма-исполнитель) 
‘3’ (Идентификатор клиента) 
Обязательный при наличии NoPartyID		
5.2.	Order Cancel Request
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «F»		
ClOrdID	11	О	Уникальный идентификатор заявки		
OrderID	37	O	Идентификатор отменяемой заявки в торговой системе.
		
Side	54	О	Возможные значения:
●	«1» – покупка,
●	«2» – продажа		
5.3.	Execution Report
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «8»		
ClOrdID	11	Н	Уникальный идентификатор заявки. 		
OrderID	37	О	Уникальный идентификатор заявки в торговой системе. 		
ExecID	17	О	Уникальный идентификатор сделки. 		
OrdStatus	39	О	Текущее состояние заявки. Значения:
●	«0» – New,
●	«1» – Partially Fill,
●	«2» – Fill,
●	«3» – Done For Day,
●	«4» – Canceled,
●	«5» – Replaced,
●	«6» – Pending Cancel,
●	«8» – Rejected,
●	«E» – Pending Replace
●	«A» – Pending New		
ExecType	150	О	Тип отчета. Значения:
●	«0» – New,
●	«1» – Partially Fill,
●	«2» – Fill,
●	«3» – Done For Day,
●	«4» – Canceled,
●	«6» – Pending Cancel,
●	«5» – Replace,
●	«8» – Rejected,
●	«E» – Pending Replace,
●	 «I» – Order Status,
●	«L» – Triggered or Activated by System		
OrderQty	38	Н	Количество в заявке в штуках,		
CumQty	14	О	Исполненное количество в штуках		
LastQty	32	У	Количество в текущей сделке в штуках. Обязательно при ExecType=1 или 2		
LastPx	31	У	Цена сделки. Обязательно при ExecType=1 или 2		
SecondaryExecID	527	У	Номер сделки. Обязательно при ExecType=1 или 2		
LeavesQty	151	О	Оставшееся количество в штуках		
Symbol	55	О	Краткое наименование инструмента		
SecurityType	167	О	Возможные значения:
«FUT» – для фьючерсов;
«OPT» – для опционов;
«SHS» – для акций;
«BON» – для облигаций;
«FND» – для инвестфондов;
«ADR» – для американских депозитарных расписок;
«GDR» – для глобальных депозитарных расписок;
«CMD» – для товаров;
«MSC» – для прочих типов инструментов		
IDSource	22	Н	Значение: «8» (exchange symbol)		
Side	54	О	Возможные значения:
●	«1» – покупка,
●	«2» – продажа		
AvgPx	6	О	Средняя цена в исполненных сделках		
Price	44	Н	Цена заявки		
Account	1	Н	Торговый счет. 		
SecurityID	48	Н	Код инструмента		
Text	58	Н	Текстовый ответ торговой системы/Комментарий клиента		
TransactTime	60	Н	Дата и время транзакции / исполнения неторгового поручения		
OrderType	40	Н	Тип заявки. Возможные значения:
●	«2» – лимитированная		
5.4.	Order Cancel Reject
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «9»		
OrderID	37	О	Уникальный идентификатор заявки в торговой системе		
OrigClOrdID	41	О	Предыдущее значение ClOrdID		
ClOrdID	11	О	Уникальный идентификатор заявки		
Symbol	55	О	Краткое наименование инструмента		
Side	54	О	Возможные значения:
●	«1» – покупка,
●	«2» – продажа		
SecurityID	48	Н	Код инструмента		
SecurityType	167	Н	Возможные значения:
«FUT» – для фьючерсов;
«OPT» – для опционов;
«SHS» – для акций;
«BON» – для облигаций;
«FND» – для инвестфондов;
«ADR» – для американских депозитарных расписок;
«GDR» – для глобальных депозитарных расписок;
«CMD» – для товаров;
«MSC» – для прочих типов инструментов		
TransactTime	60	Н	Время транзакции		
OrdStatus	39	О	Текущее состояние заявки. Значения:
●	«0» – New,
●	«1» – Partially Fill,
●	«2» – Fill,
●	«4» – Canceled,
●	«5» – Replaced,
●	«6» – Pending Cancel,
●	«8» – Rejected		
CxlRejResponseTo	434	О	Значение: «1» – «Order Cancel Request»		
Text	58	Н	Текстовый ответ торговой системы		
CxlRejReason	102	Н	Возможные значения:
●	 "0" Too late to cancel - Отмена запоздала, заявка ис-полнена.
●	 "1" Unknown order - Заявка не найдена.
●	 "3" Order already in Pending Cancel or Pending Replace status - Заявка находится в процессе отме-ны или изменения.
●	 "99" Other - Другое.		
5.5.	Order Status Request
Список поддерживаемых тэгов:
Наименование	Тэг	наличие	Комментарий	Пример значения	
MsgType	35	О	Тип сообщения. Значение: «H»		
ClOrdID	11	О	Уникальный идентификатор заявки		
Symbol	55	О	Краткое наименование инструмента		
Side	54	О	Возможные значения:
●	«1» – покупка,
●	«2» – продажа		
SecurityID	48	Н	Код инструмента		
SecurityType	167	Н	Возможные значения:
«FUT» – для фьючерсов;
«OPT» – для опционов;
«SHS» – для акций;
«BON» – для облигаций;
«FND» – для инвестфондов;
«ADR» – для американских депозитарных расписок;
«GDR» – для глобальных депозитарных расписок;
«CMD» – для товаров;
«MSC» – для прочих типов инструментов