Изображение блога
OS_Engine_team
OS_Engine_team Блог компании OsEngine
Сегодня в 18:41

Подключение OsEngine к Finam Trade API (gRPC)

Вышел в продакшен коннектор к Finam Trade API по протоколу gRPC. А это статья-инструкция о том, как это устроено.

Это быстрый и современный способ получать котировки, историю свечей и выставлять заявки через Финам: акции, фьючерсы, опционы, облигации, валюты, фонды и ETF на Московской бирже и СПБ, а также инструменты бирж США, Европы, Азии и крипто-площадок.

Подключение OsEngine к Finam Trade API (gRPC)

Сам OsEngine здесь: https://github.com/AlexWan/OsEngine

Исходники коннектора здесь: https://github.com/AlexWan/OsEngine/tree/master/project/OsEngine/Market/Servers/FinamGrpc

 

Далее идет инструкция о том, как наладить подключение через API из OsEngine. Разберём весь процесс по шагам.

 

Часть 1. Получаем токен (секретный ключ) Finam Trade API

Для подключения нужен секретный ключ (API Token). Получается он так:

Заходим на портал Finam Trade API и авторизуемся (если аккаунта ещё нет, то регистрируемся): https://api.finam.ru/

Подключение OsEngine к Finam Trade API (gRPC)

2) В верхнем меню открываем раздел «Токены»:

Подключение OsEngine к Finam Trade API (gRPC)

 

3) Нажимаем «Создать токен»:

Подключение OsEngine к Finam Trade API (gRPC)

 

4) Создаём новый токен и копируем его значение — это и есть секретный ключ.

Подключение OsEngine к Finam Trade API (gRPC)

1) Придумываем имя токена.

2) Выбираем счет.

3) Выбираем тип доступа. Обязательно торговля.

4) Выбираем дату, до какого числа, месяца и года будет действовать ваш токен.

5) Нажимаем «Создать».


Небольшое уточнение по выбору счета. Это не сам номер счета, а торговый код. Его можно посмотреть в личном кабинете Финама, выбрать счет и посмотреть детали счета. Это важно, если у вас несколько счетов.

Сохраняем ключ в файл. Он понадобится при подключении OsEngine.

 

ВАЖНО 1: Для торговли нужен токен с правом торговли (не «только чтение» / readonly). Если токен выписан как readonly, OsEngine сможет получать данные, но заявки выставляться не будут — они будут отклоняться.

 

ВАЖНО 2: Храните ключ в безопасности и никому не передавайте. Ключ привязан к квотам API (подробнее в конце статьи).

 

Часть 2. Подключаем OsEngine

Запускаем «Роботы Light».

Подключение OsEngine к Finam Trade API (gRPC)

 

Идём в окно «Сервера подключения» (настройки подключений).

Подключение OsEngine к Finam Trade API (gRPC)

 

В списке серверов двойным кликом выбираем «FinamGrpc» — откроется окно настройки подключения.

Подключение OsEngine к Finam Trade API (gRPC)

Подключение OsEngine к Finam Trade API (gRPC)

1) Токен — секретный ключ (API Token) с портала Finam Trade API.

2) Рынки и классы бумаг — кнопка, открывающая окно выбора рынков и классов инструментов. По умолчанию включены «Акции MOEX» и «Фьючерсы MOEX (RTSX)». Галочками можно дополнительно включить облигации, валюты, фонды и ETF, индексы, СПБ, а также биржи США, Европы, Азии и крипто-площадки.

3) Игнорировать сделки утреннего аукциона — если включено, сделки до 7:00 МСК не подаются в ленту. Принты утреннего аукциона часто идут с гэпом относительно закрытия и дают ложные сигналы в свечах, построенных по ленте сделок.

4) Полное логирование ордеров и трейдов пользователя — подробный лог для отладки. Обычно оставляем выключенным.

5) Жмём «Подключить» и ждём, пока строка подключения не станет зелёной.

 

Вот так выглядит окно «Рынки и классы бумаг»:

Подключение OsEngine к Finam Trade API (gRPC)

Выбираем нужное и нажимаем «Принять».

 

ВАЖНО!!!

Огульно клацать по всем галочкам не нужно. Если это сделать, начнут скачиваться десятки тысяч инструментов и ваш ПК, скорее всего, начнёт подвисать. Выбирайте только то, что вам действительно нужно. После изменения данного окна, коннектор надо переподключить.

 

Часть 3. Добавляем бота и настраиваем поток данных

В главном окне жмём «Добавить бота».

Подключение OsEngine к Finam Trade API (gRPC)


Выбираем робота.

Подключение OsEngine к Finam Trade API (gRPC)

1) Выбираем робота.

2) Можно воспользоваться поиском.

3) Даем ему имя.

4) Если нажать на знак вопроса, то можно получить информацию о роботе.

5) Жмем «Принять».

 

Затем нужно настроить поток данных:

Подключение OsEngine к Finam Trade API (gRPC)

1) Жмем «Чарт».

2) Затем «Управление».

3) И «Настройка данных».


Откроется окно «Настройки данных»:

Подключение OsEngine к Finam Trade API (gRPC)

1) «Торговый сервер» — выбираем FinamGrpc.

2) «Портфель для операций» — выбираем нужный портфель.

3) Ставим галочку, если хотим, чтобы торги происходили в режиме эмуляции.

4) Выбираем класс инструмента.

5) Для выбора инструмента можно воспользоваться поиском.

6) Выбираем торговый инструмент и ставим галочку.

7) Выбираем таймфрейм.

8) Жмем «Принять».

 

Появляется график:

Подключение OsEngine к Finam Trade API (gRPC)

 

Важные замечания

1) Квоты. У Finam Trade API лимит — 200 запросов в минуту на каждый метод, и квота привязана к токену. Если на одном токене работает несколько копий OsEngine или другие программы, они делят эту квоту между собой. При ошибках 429 (слишком много запросов) используйте отдельные токены на каждый экземпляр.

2) Время. На компьютере рекомендуется московское время (МСК), чтобы не было расхождений в свечах и метках времени сделок.

 

Удачных алгоритмов!
Комментарии открыты для друзей!

Стакан и лента в алго №1: Введение и оглавление

https://smart-lab.ru/company/os_engine/blog/1024149.php


Скачать OsEngine: https://github.com/AlexWan/OsEngine

Официальная поддержка OsEngine в MAX: https://max.ru/join/Yar1c0k41XMwbnBXWutnmj4rWMk3RrhXIUqpGl8wOog

Канал Научный трейдинг в MAX: https://max.ru/id2373023082_biz

Поддержка OsEngine в Телеграм: https://t.me/osengine_official_support

Канал Научный трейдинг (Bad Quant) в Телеграм: https://t.me/bad_quant

Данная публикация является личным мнением автора. Мнение владельца сайта может не совпадать с мнением автора.
0 Комментариев

Активные форумы
Что сейчас обсуждают

Старый дизайн
Старый
дизайн