Помощь

База знаний по нашим продуктам для клиентов

FIX-сессии счета

FIX-сессии счета

FIX (Financial Information eXchange) протокол - это протокол передачи данных, являющийся международным стандартом для обмена данными между участниками биржевых торгов в режиме реального времени. FIX-сессия - это подключение по протоколу FIX.

account_fix_sessions_ru.png

В данном разделе вы можете наблюдать список счетов, на которых добавлены FIX-сессии.

Для счета можно создать FIX-сессию для передачи данных по API. Для этого нажмите на Add fix session, появится сайдпейдж с выбором счета и типа сессии.

Доступно несколько типов сессий.

Ордерная сессия

Такой тип сессии позволяет клиентам сделать ордерный коннектор на своей стороне и присылать в платформу заявки по протоколу FIX. Система обработает эти заявки и отправит сообщение в процессе обработки об их состоянии в рамках счета к которому привязана FIX-сессия.

Обратите внимание! Через FIX-сессии могут быть размещены только такие типы заявок, которые поддерживаются в клиентском наборе типов заявок. Если заявка не может быть размещена - клиент получит уведомление об этом.

Маркетная сессия

Маркетная сессия позволяет получать цены по инструментам которые доступны в счете, к которому привязана сессия. Также она позволяет получать сделки от коннектора kraken.

Защита от избыточных подписок

В маркетной сессии реализована защита от чрезмерного количества ошибочных подписок на инструменты:

  • Если в течение 1 минуты будет отправлено 500 или более запросов на недоступные в подписке инструменты, то подключение к сессии автоматически отключается на 1 минуту. После этого периода работа сессии может быть возобновлена. Пока сессия отключена, в колонке Статус под ее статусом указано, когда она включится снова: Deactivated until <дата и время>. По истечении этого времени сессия включится автоматически.
  • При повторной подписке на недоступный инструмент (по которому уже была получена ошибка) в течение часа — ответ не отправляется.

Детали маркетной сессии

Чтобы посмотреть, на какие инструменты подписан клиент и какие его запросы на подписку были отклонены, нажмите кнопку ... в строке маркетной сессии и выберите Детали. Откроется сайдпейдж Fix session <ID> с вкладками Инструменты и Incorrect requests.

Данные в таблицах не обновляются в реальном времени: это снимок, который обновляется примерно раз в 5 секунд.

Во вкладке Инструменты отображаются активные подписки клиента:

account_fix_session_details_ru.png

НазваниеОписание
Инструментинструмент, на который подписан клиент
Тип сессиитекущая торговая сессия по инструменту: Главная сессия, Перед открытием рынка, После закрытия рынка или Офлайн
Subscription timestampвремя подписки
Subscription typeтип подписки: Top of book - лучшая цена, Full book - весь стакан (Depth N - стакан глубиной N уровней), Trades - сделки
Min update intervalминимальный интервал отправки котировок клиенту. Под значением указан интервал, который запросил клиент (Requested). Если клиент не передал интервал, используется значение по умолчанию - 1 секунда. No throttling - без ограничения
Max update intervalмаксимальный интервал: если котировки за это время не изменились, клиенту повторно отправляется последняя. Под значением указан запрошенный клиентом интервал (Requested). Интервал не может быть меньше 10 секунд: меньшее значение система увеличивает
Время обновлениявремя последней котировки, отправленной клиенту
Sent countколичество сообщений, отправленных клиенту по подписке
MDReqIDидентификатор запроса клиента на подписку

После отключения клиента его подписки пропадают из таблицы примерно через 15 секунд.

Во вкладке Incorrect requests отображаются символы, подписку на которые система отклонила:

НазваниеОписание
Символсимвол из запроса клиента
Причинапричина отказа, например: Unknown symbol - инструмента с таким символом нет, Malformed symbol - символ не соответствует формату, Not available - инструмент недоступен на счете, Limit exceeded - превышен лимит в 1000 активных подписок на сессию
Last attemptвремя последней попытки подписки
Attemptsколичество попыток
Сообщениетекст ошибки, который получил клиент

В таблице хранятся последние 200 инструментов с ошибками. Таблица очищается, когда клиент снова подключается к сессии; при остановке сессии ошибки сохраняются.

Клиентская STP-сессия

Такой тип сессии позволяет клиенту гарантировать учет сделки в системе в случае каких-либо ошибок или потери данных. Данный тип сессии рекомендуется для использования отчетными или аналитическими системами. STP сессии, в отличие от ордерных, гарантируют, что сделки учтены в системе (записаны в БД). Для целей отчетности и анализа сделок рекомендуется использовать именно их, только Order не достаточно. Ключевое отличие в том, что в STP отбивка улетит только после записи сделки в БД, а в Order - в моменте исполнения сделки, и вот она исполнилась, а по какой то причине в БД не попало. При большой нагрузке на БД будет небольшой лаг между исполнением торговой заявки и записью сделки в БД, и если планировать как либо опираться на информацию по сделкам, то лучше подождать, пока STP отчитается.


В таблице доступны следующие характеристики FIX-сессий:

НазваниеОписание
IDномер сессии
Счетсчет, к которому привязана сессия
Типтип сессии (например, ордер или рынок)
Активениндикатор активности сессии
Статусстатус сессии
Настройкинастройки сессии
Targetcompidприсвоенное значение, используемое для идентификации получателя.
Описаниеописание сессии
Параметрыпараметры отправки свопов/сделок по сессии
Расписаниерасписание работы FIX-сессии

В разделе предусмотрены возможности для изменения настройки Параметров отправки свопов по FIX-протоколу: Send - отправляются как сделки, так и свопы; Not send - свопы не отправляются; Send only - отправляются только свопы.

Добавление FIX-сессии

Чтобы добавить FIX-сессию к счету достаточно нажать на кнопку Add fix session и выбрать в открывшемся сайдпейдже счет и тип сессии:

account_fix_session_add.jpg

После создания FIX-сессии откроется окно с параметрами подключения.

Действия с FIX-сессией собраны в меню кнопки ... в строке сессии.

Чтобы приостановить FIX-сессию, выберите в меню пункт Стоп. После этого FIX-сессия перестанет быть активной. Запустить остановленную сессию можно пунктом Старт.

Чтобы изменить пароль от FIX-сессии, выберите в меню пункт Изменить пароль. После этого появится всплывающее окно с новым паролем к FIX-сессии.

Для изменения параметров FIX-сессии выберите в меню пункт Редактировать. В открывшемся сайдпейдже можно изменить параметры сессии, добавить ее Описание и настроить расписание работы.

Расписание FIX-сессии

Для FIX-сессии можно задать пользовательское расписание, в соответствии с которым сессия будет переходить в онлайн- и офлайн-состояние.

В поле Расписание доступны следующие варианты:

  • Без перерывов - FIX-сессия работает непрерывно. Дополнительные параметры расписания указывать не требуется.
  • Недельное окно - FIX-сессия работает непрерывно от указанного дня и времени начала до указанного дня и времени окончания. Укажите Часовой пояс, день и время Старта, а также день и время Окончания.
  • По дням недели - FIX-сессия работает в выбранные дни недели в пределах заданного интервала времени. Укажите Часовой пояс, необходимые Дни, а также время Начала и Окончания.

Чтобы использовать стандартное расписание из конфигурации FIX, очистите поле Расписание и сохраните изменения.

При сохранении система проверяет заданное расписание и не позволяет сохранить неподдерживаемую конфигурацию.

Если для FIX-сессии установлено пользовательское расписание, при копировании ее настроек в конфигурацию также передаются параметры этого расписания, включая время работы, дни недели и часовой пояс.

Обратите внимание! При редактировании сессии также можно добавить ее Описание в текстовом формате.

Для удаления FIX-сессии выберите в меню пункт Удалить.

Затем подтвердите удаление в сайдпейдже.

account_fix_sessions_remove_ru.png

Не нашли то, что искали? Свяжитесь с нами support@unity.finance. Мы будем рады помочь 24/7