Помощь
База знаний по нашим продуктам для клиентов
FIX-сессии счета
FIX-сессии счета
FIX (Financial Information eXchange) протокол - это протокол передачи данных, являющийся международным стандартом для обмена данными между участниками биржевых торгов в режиме реального времени. FIX-сессия - это подключение по протоколу FIX.
![]()
В данном разделе вы можете наблюдать список счетов, на которых добавлены FIX-сессии.
Для счета можно создать FIX-сессию для передачи данных по API. Для этого нажмите на Add fix session, появится сайдпейдж с выбором счета и типа сессии.
Доступно несколько типов сессий.
Ордерная сессия
Такой тип сессии позволяет клиентам сделать ордерный коннектор на своей стороне и присылать в платформу заявки по протоколу FIX. Система обработает эти заявки и отправит сообщение в процессе обработки об их состоянии в рамках счета к которому привязана FIX-сессия.
Обратите внимание! Через FIX-сессии могут быть размещены только такие типы заявок, которые поддерживаются в клиентском наборе типов заявок. Если заявка не может быть размещена - клиент получит уведомление об этом.
Маркетная сессия
Маркетная сессия позволяет получать цены по инструментам которые доступны в счете, к которому привязана сессия. Также она позволяет получать сделки от коннектора kraken.
Защита от избыточных подписок
В маркетной сессии реализована защита от чрезмерного количества ошибочных подписок на инструменты:
- Если в течение 1 минуты будет отправлено 500 или более запросов на недоступные в подписке инструменты, то подключение к сессии автоматически отключается на 1 минуту. После этого периода работа сессии может быть возобновлена. Пока сессия отключена, в колонке
Статуспод ее статусом указано, когда она включится снова:Deactivated until <дата и время>. По истечении этого времени сессия включится автоматически. - При повторной подписке на недоступный инструмент (по которому уже была получена ошибка) в течение часа — ответ не отправляется.
Детали маркетной сессии
Чтобы посмотреть, на какие инструменты подписан клиент и какие его запросы на подписку были отклонены, нажмите кнопку ... в строке маркетной сессии и выберите Детали. Откроется сайдпейдж Fix session <ID> с вкладками Инструменты и Incorrect requests.
Данные в таблицах не обновляются в реальном времени: это снимок, который обновляется примерно раз в 5 секунд.
Во вкладке Инструменты отображаются активные подписки клиента:
![]()
| Название | Описание |
|---|---|
| Инструмент | инструмент, на который подписан клиент |
| Тип сессии | текущая торговая сессия по инструменту: Главная сессия, Перед открытием рынка, После закрытия рынка или Офлайн |
| 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 и выбрать в открывшемся сайдпейдже счет и тип сессии:
![]()
После создания FIX-сессии откроется окно с параметрами подключения.
Действия с FIX-сессией собраны в меню кнопки ... в строке сессии.
Чтобы приостановить FIX-сессию, выберите в меню пункт Стоп. После этого FIX-сессия перестанет быть активной. Запустить остановленную сессию можно пунктом Старт.
Чтобы изменить пароль от FIX-сессии, выберите в меню пункт Изменить пароль. После этого появится всплывающее окно с новым паролем к FIX-сессии.
Для изменения параметров FIX-сессии выберите в меню пункт Редактировать. В открывшемся сайдпейдже можно изменить параметры сессии, добавить ее Описание и настроить расписание работы.
Расписание FIX-сессии
Для FIX-сессии можно задать пользовательское расписание, в соответствии с которым сессия будет переходить в онлайн- и офлайн-состояние.
В поле Расписание доступны следующие варианты:
Без перерывов- FIX-сессия работает непрерывно. Дополнительные параметры расписания указывать не требуется.Недельное окно- FIX-сессия работает непрерывно от указанного дня и времени начала до указанного дня и времени окончания. УкажитеЧасовой пояс, день и времяСтарта, а также день и времяОкончания.По дням недели- FIX-сессия работает в выбранные дни недели в пределах заданного интервала времени. УкажитеЧасовой пояс, необходимыеДни, а также времяНачалаиОкончания.
Чтобы использовать стандартное расписание из конфигурации FIX, очистите поле Расписание и сохраните изменения.
При сохранении система проверяет заданное расписание и не позволяет сохранить неподдерживаемую конфигурацию.
Если для FIX-сессии установлено пользовательское расписание, при копировании ее настроек в конфигурацию также передаются параметры этого расписания, включая время работы, дни недели и часовой пояс.
Обратите внимание! При редактировании сессии также можно добавить ее Описание в текстовом формате.
Для удаления FIX-сессии выберите в меню пункт Удалить.
Затем подтвердите удаление в сайдпейдже.
![]()