Вышел в продакшен коннектор к Finam Trade API по протоколу gRPC. А это статья-инструкция о том, как это устроено.
Это быстрый и современный способ получать котировки, историю свечей и выставлять заявки через Финам: акции, фьючерсы, опционы, облигации, валюты, фонды и ETF на Московской бирже и СПБ, а также инструменты бирж США, Европы, Азии и крипто-площадок.
Сам 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/
2) В верхнем меню открываем раздел «Токены»:
3) Нажимаем «Создать токен»:
4) Создаём новый токен и копируем его значение — это и есть секретный ключ.
1) Придумываем имя токена.
2) Выбираем счет.
3) Выбираем тип доступа. Обязательно торговля.
4) Выбираем дату, до какого числа, месяца и года будет действовать ваш токен.
5) Нажимаем «Создать».
Небольшое уточнение по выбору счета. Это не сам номер счета, а торговый код. Его можно посмотреть в личном кабинете Финама, выбрать счет и посмотреть детали счета. Это важно, если у вас несколько счетов.
Сохраняем ключ в файл. Он понадобится при подключении OsEngine.
ВАЖНО 1: Для торговли нужен токен с правом торговли (не «только чтение» / readonly). Если токен выписан как readonly, OsEngine сможет получать данные, но заявки выставляться не будут — они будут отклоняться.
ВАЖНО 2: Храните ключ в безопасности и никому не передавайте. Ключ привязан к квотам API (подробнее в конце статьи).
Часть 2. Подключаем OsEngine
Запускаем «Роботы Light».
Идём в окно «Сервера подключения» (настройки подключений).
В списке серверов двойным кликом выбираем «FinamGrpc» — откроется окно настройки подключения.
1) Токен — секретный ключ (API Token) с портала Finam Trade API.
2) Рынки и классы бумаг — кнопка, открывающая окно выбора рынков и классов инструментов. По умолчанию включены «Акции MOEX» и «Фьючерсы MOEX (RTSX)». Галочками можно дополнительно включить облигации, валюты, фонды и ETF, индексы, СПБ, а также биржи США, Европы, Азии и крипто-площадки.
3) Игнорировать сделки утреннего аукциона — если включено, сделки до 7:00 МСК не подаются в ленту. Принты утреннего аукциона часто идут с гэпом относительно закрытия и дают ложные сигналы в свечах, построенных по ленте сделок.
4) Полное логирование ордеров и трейдов пользователя — подробный лог для отладки. Обычно оставляем выключенным.
5) Жмём «Подключить» и ждём, пока строка подключения не станет зелёной.
Вот так выглядит окно «Рынки и классы бумаг»:
Выбираем нужное и нажимаем «Принять».
ВАЖНО!!!
Огульно клацать по всем галочкам не нужно. Если это сделать, начнут скачиваться десятки тысяч инструментов и ваш ПК, скорее всего, начнёт подвисать. Выбирайте только то, что вам действительно нужно. После изменения данного окна, коннектор надо переподключить.
Часть 3. Добавляем бота и настраиваем поток данных
В главном окне жмём «Добавить бота».
Выбираем робота.
1) Выбираем робота.
2) Можно воспользоваться поиском.
3) Даем ему имя.
4) Если нажать на знак вопроса, то можно получить информацию о роботе.
5) Жмем «Принять».
Затем нужно настроить поток данных:
1) Жмем «Чарт».
2) Затем «Управление».
3) И «Настройка данных».
Откроется окно «Настройки данных»:
1) «Торговый сервер» — выбираем FinamGrpc.
2) «Портфель для операций» — выбираем нужный портфель.
3) Ставим галочку, если хотим, чтобы торги происходили в режиме эмуляции.
4) Выбираем класс инструмента.
5) Для выбора инструмента можно воспользоваться поиском.
6) Выбираем торговый инструмент и ставим галочку.
7) Выбираем таймфрейм.
8) Жмем «Принять».
Появляется график:
Важные замечания
1) Квоты. У Finam Trade API лимит — 200 запросов в минуту на каждый метод, и квота привязана к токену. Если на одном токене работает несколько копий OsEngine или другие программы, они делят эту квоту между собой. При ошибках 429 (слишком много запросов) используйте отдельные токены на каждый экземпляр.
2) Время. На компьютере рекомендуется московское время (МСК), чтобы не было расхождений в свечах и метках времени сделок.
Удачных алгоритмов!
Комментарии открыты для друзей!
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