Частые вопросы о торговом терминале Финам

Finam Terminal — это торговый терминал для брокера Финам, который работает прямо в консоли: интерфейс рисуется текстом в окне терминала, без отдельного графического окна и без браузера. Программа подключается к Finam Trade API по gRPC и показывает список счетов, позиции, историю сделок за последние 30 дней, заявки и профиль инструмента со свечным графиком. Данные обновляются автоматически раз в 5 секунд. Исходный код открыт под лицензией Apache-2.0, платить за терминал не нужно. Как устроены экраны — в руководстве пользователя.

Готовые сборки есть для macOS (Intel и Apple Silicon), Linux x86-64 и Windows x86-64. Сборок под Linux ARM64 и Windows ARM64 в релизе нет: скрипт установки на такой машине останавливается с ошибкой, и терминал приходится собирать из исходников — проект написан на Go, файл go.mod требует версию 1.26.0. В WSL ставится сборка для Linux amd64. Полная таблица сборок и команды для каждой системы — в разделе «Установка».

Нужны три вещи: счёт в Финаме, API-ключ с правом «Торговля» и терминал с поддержкой Unicode. Рамки таблиц и свечи графика рисуются символами псевдографики, поэтому окно лучше развернуть на весь экран: минимальный размер программа не проверяет, и в узком окне колонки обрезаются. Ещё нужен сетевой доступ к api.finam.ru:443 — терминал работает по gRPC. Требования, переменные окружения и проверка PATH разобраны в разделе «Установка».

Установка идёт одной командой: скрипт определяет систему и архитектуру, скачивает последний релиз с GitHub и кладёт бинарник в каталог из PATH. Два других способа — Docker-образ ghcr.io/updevru/finam-terminal:latest и ручная загрузка файла со страницы релизов. Обновление — это повторный запуск той же команды установки: скрипт перезапишет бинарник последним релизом. Команды для macOS, Linux, WSL, PowerShell и CMD, а также разделы про проверку установки и удаление — в разделе «Установка».

Главное отличие — среда работы: Finam Terminal живёт в окне консоли и управляется с клавиатуры, а QUIK — отдельная десктопная программа с графическим интерфейсом, исторически ориентированная на Windows. Терминал написан на Go, занимает около 24 МБ оперативной памяти и ставится одной командой на macOS, Linux и Windows. Взамен он умеет меньше: в нём нет биржевого стакана, ленты сделок, технических индикаторов, скриптов и торговых роботов. Выбор простой: если нужен полный набор аналитики, Finam Terminal её не заменит; если рабочее место и так в консоли — заменит. Что именно есть в терминале, перечислено в руководстве пользователя.

Терминал бесплатный: это проект с открытым исходным кодом под лицензией Apache-2.0, код лежит на GitHub. Подписки, пробного периода и платных функций в нём нет, деньги за сделки программа не берёт — комиссии остаются на стороне брокера и от терминала не зависят.

Мобильной версии нет, сборок под мобильные платформы в релизах тоже нет. Finam Terminal — консольное приложение для настольных систем: macOS, Linux и Windows. Для телефона используйте приложения самого брокера. Список доступных сборок — в разделе «Установка».

Ключ хранится локально на вашем компьютере — в файле ~/.finam-cli/.env (на Windows это каталог %USERPROFILE%\.finam-cli). Туда его записывает экран настройки при первом запуске, поэтому повторно вводить ключ не нужно. Никуда, кроме API Финама, ключ не уходит: адрес подключения задаётся переменной FINAM_GRPC_ADDR и по умолчанию равен api.finam.ru:443 — промежуточного сервера у проекта нет. Передать ключ можно и переменной окружения FINAM_API_TOKEN — это описано в разделе «Установка».

Нет: разработчик не видит ни ваш ключ, ни ваш счёт — программа работает на вашей машине и обращается напрямую к Finam Trade API, без серверов проекта посередине. Проверить это можно самостоятельно: исходный код открыт под лицензией Apache-2.0 и лежит на GitHub, включая место, где задаётся адрес подключения. Отзыв доступа тоже целиком на стороне брокера: удалите ключ в личном кабинете на api.finam.ru/tokens/ — и терминал перестанет видеть счёт.

Нужен volume: без него ключ остаётся внутри контейнера и пропадает вместе с ним. Каталог с настройками монтируется с хоста командой docker run -it --rm -v ~/.finam-cli:/root/.finam-cli ghcr.io/updevru/finam-terminal:latest. Домашний каталог внутри контейнера — /root, поэтому терминал читает ключ из /root/.finam-cli/.env. С таким volume ключ вводится один раз и переживает пересоздание контейнера; разбор команды — в разделе «Установка».

Терминал показывает все торговые счета, которые доступны по вашему API-ключу. Отдельной настройки под тип счёта в программе нет: она берёт список счетов из API и выводит его в левой панели — что доступно ключу, то и видно. Переключение между счетами — стрелками ↑ и ↓, при переключении данные перезагружаются. Если счёта ещё нет, он открывается на стороне брокера — см. страницу «Открыть счёт».

Да, несколько счетов работают одновременно: все они появляются в левой панели, между ними переключаются стрелками ↑ и ↓. Приоритет обновления у активного счёта — его данные загружаются первыми, остальные следом. Отдельный ключ на каждый счёт не нужен, если счета доступны одному ключу. Как устроен список счетов — в разделе «Обзор интерфейса».

Нет, терминал работает только с Финамом: он построен на Finam Trade API, и адрес подключения по умолчанию — api.finam.ru:443. Переменная FINAM_GRPC_ADDR меняет только адрес эндпоинта, но не протокол: другого API терминал не понимает, поэтому подключить через неё другого брокера не получится.

Через терминал доступно то, что отдаёт Finam Trade API: акции, облигации, фьючерсы и опционы. Инструмент ищется по тикеру или части названия — клавиша S из любого экрана, дальше Enter или A для заявки и P для профиля. В профиле показываются специальные поля по типу бумаги: размер контракта и дата экспирации у фьючерса, дополнительно страйк у опциона, номинал Face Value у облигации. Подробности — в разделе «Профиль инструмента».

Шесть типов: Market (рыночная), Limit (лимитная), Stop, Stop-Limit, Take-Profit и связанная пара SL/TP. Заявка создаётся клавишей A — из вкладки «Позиции», профиля инструмента или окна поиска; активную заявку можно отредактировать или отменить, а позицию закрыть прямо из терминала. Статусы в списке — Active, Partial, Filled, Cancelled, Rejected, Expired, Suspended. Разбор каждого типа — в разделе «Заявки».

Рыночная заявка исполняется сразу по текущей цене, лимитная — только по указанной цене или лучше. Разница в том, чем приходится жертвовать: рыночная даёт скорость, но не контролирует цену, лимитная контролирует цену, но может не исполниться вовсе. На спокойном рынке разница почти незаметна, на резком движении — существенная. Сравнительная таблица по скорости, контролю цены и риску проскальзывания — в разделе «Заявки».

Да, оба типа есть, и их можно выставить парой — тип SL/TP. Стоп-лосс закрывает позицию, когда цена уходит против вас, и ограничивает убыток; тейк-профит закрывает её при достижении целевой цены и фиксирует прибыль. Когда стоп-заявка срабатывает, она порождает биржевую заявку — в списке заявок та показывается под родительской с отступом и маркером ↳. Как заполнять поля формы и какие ошибки встречаются чаще всего — в разделе «Торговля».

Нет, ни биржевого стакана (Level 2), ни ленты сделок в терминале нет. Показываются котировки уровня 1 — лучший bid и лучший ask с их объёмами, а для фьючерсов и опционов ещё открытый интерес Open Int., когда значение ненулевое. Если вам нужна глубина рынка, терминал её не заменит. Что именно есть в профиле инструмента — в разделе «Профиль инструмента».

Раз в 5 секунд. Потока котировок в реальном времени в терминале нет: он опрашивает API обычным запросом по таймеру, а интервал меняется переменной окружения REFRESH_INTERVAL. Приоритет у активного счёта — его данные обновляются первыми. Обновить всё вручную можно клавишей R или F2.

Нет: торговых роботов, скриптов и бэктестинга в терминале нет — это ручной инструмент для торговли с клавиатуры. Технических индикаторов и рисования на графике тоже нет: график показывает японские свечи на четырёх таймфреймах — M5, H1, D и W. Если нужен алготрейдинг, работать придётся напрямую с Finam Trade API, на котором построен и сам терминал. Как читать свечной график и переключать таймфреймы — в разделе «Профиль инструмента».

По облигациям терминал показывает НКД — накопленный купонный доход — отдельной колонкой в истории сделок, номинал Face Value в профиле выпуска и три календаря корпоративных действий: купоны, амортизацию и оферты. В каждой секции — до трёх прошлых и трёх будущих событий по дате. По акциям вместо них показываются дивиденды и сплиты. Что такое НКД, оферта и амортизация простыми словами — в разделе «Облигации в терминале».