Финам API: ИИ-агент для торговых интеграций

Финам API — интерфейс брокера для роботов, приложений и внешних сервисов. Материал для разработчика и финансиста, которым нужен обмен данными без ручных выгрузок.

Агент — программа, которая делает дело целиком, а не отвечает на вопрос. Вы ставите задачу словами, а возвращается результат: сверка, пакет документов, список расхождений.

Три признака. Он работает в ваших сервисах, а не в отдельном окне чата. Доводит дело до конца: сам заходит в систему и сам кладёт итог туда, где вы его ждёте. И работает без вас — по расписанию или по событию.

Отличие от чат-бота: бот вернёт текст, который вы переносите в работу руками, а агент вернётся с результатом.

Коннектор — описанное подключение агента к сервису по выданному доступу, а не плагин в торговый терминал.

Ключ выпускается в кабинете: запрос идёт с заголовком Authorization и значением access key. Связь проверяется историей по одному инструменту — набор свечей в ответе подтверждает, что доступ работает. Пароль кабинета агенту не нужен.

Портал Finam Trade API держит документацию по версиям, раздел токенов, блог и «Арену» для проверки стратегий. Методы описаны адресами вида api.finam.ru/v1 с версией в пути, ответы приходят в JSON, есть готовые библиотеки и онлайн-тестирование методов. Заявлены метрики доступности сервиса и обработки ордера, а также набор рынков и типов инструментов.

### Остатки на счетах: сводка на утро

Через интерфейс агент забирает позиции и свободные средства по каждому счёту и складывает в один отчёт к началу дня. Сверяет количество бумаг с тем, что зафиксировано во внутренней базе, и помечает расхождение отдельной строкой. Отчёт приходит таблицей: его можно отдать в бухгалтерию без перепечатки и без ручной сверки двух источников. Каждая строка со ссылкой на операцию.

### Справки и сверка с бухгалтерией

Агент выгружает сделки за период по коду инструмента и сводит с проводками бухгалтерии: дата, сумма, количество бумаг. Ищет операции, которые есть в одном источнике и нет в другом, и показывает обе стороны рядом. Итог — список расхождений и готовая справка, где цифры взяты из интерфейса, а не набраны руками. Справку можно приложить к отчёту в бухгалтерию.

### Проверка платёжного календаря: где не сходится

Агент сопоставляет даты расчётов по сделкам с платёжным календарём и находит дни, где поступления ждут, а расчёт стоит в другой день. Показывает пустые и перегруженные дни недели, а рядом — операции, из которых они сложились. Календарь возвращается с пометками, правку вносит финансист: агент только показывает, где не сходится. Пометки снимаются после правки финансистом в календаре.

Решение. Агент показывает разрыв, но не решает, чей расчёт верный. Переводы, заявки и правки в календаре остаются за человеком: он же отвечает за то, что цифра ушла в отчётность.

Доступ берётся в кабинете Финам: подключается Trade API и выпускается ключ. Нужен счёт и оформленный доступ к интерфейсу. Версия, набор методов и лимиты уточняются при подключении.

Агент не торгует по своей инициативе и не выставляет заявки без команды. Инвестиционных рекомендаций он не даёт и доходность не обещает.

Что такое агент, если коротко? Программа, которая получает задачу словами и возвращает готовое дело: сама ходит в интерфейс, собирает данные, складывает отчёт. Чат-бот отвечает текстом, агент приносит результат.

Что такое коннектор? Описанное подключение по выданному доступу. Здесь это ключ Trade API: агент читает инструменты и сделки, пароль кабинета не хранит и за права ключа не выходит.