Trade API

Перейти к основному содержимому

История изменений

Версия 2.7.0 (27.08.2025)​

Обновления:

  • разблокировка МОНО и СММА счетов. Теперь они доступны в Trade API. Эти счета включают торговлю опционами на фьючерсы на российском рынке (МОНО). На международном рынке (через сегрегированный глобал счет СММА): US options on stocks&ETFs, US futures, US stocks&ETFs.
  • демо-счета: добавили возможность создания демо-счетов через Trade API.
  • стабильность стримов: проведены работы по устранению нестабильности при получении рыночных данных.
  • исправления:
    • устранена ошибка, при которой просмотровый токен работал как боевой;
    • исправлено отображение symbol в подписке SubscribeOrderTrade — теперь формат консистентный: SRU5@RTSX.
  • доработки методов API:
    • Transactions: добавлены все неторговые транзакции с корректным атрибутированием;
    • GetAccount:
      • в ответ добавлены поля: excess_liq (свободные средства), initial_margin (начальная маржа), maintenance_margin (единая минимальная маржа);
      • в массив positions добавлены поля: daily_pnl, unrealized_pnl;
    • OptionsChain: добавлены поля expiration_first_day (первый день экспирации) и expiration_last_day (последний день экспирации).
  • изменения в структурах данных:
    • в структуру Trade добавлено поле account_id.
  • публикация SDK: скомпилированные библиотеки для Kotlin.

Ближайшие планы:

  • WebSocket: реализовать поддержку подключения по WebSocket.
  • PlaceOrder:
    • проверка корректности статусов ордеров;
    • проработать соответствие поведения ордеров функционалу Finam Trade.
  • токены: укоротить значения secret и jwt.
  • тokenDetailsResponse: в ответ метода добавить поле scope (write/read — торговый/просмотровый).
  • oрдера и заявки: добавить поле comment для возможности проставлять кастомные метки и отслеживать их в заявках.
  • GetAssetParams: исправить корректность отображения данных в полях ответа.

Версия 2.6.0 (21.07.2025)​

Обновления:

  • введён единый лимит — 200 запросов в минуту для всех методов
  • исправлена ошибка с некорректным заполнением полей в методе OptionsChain. Теперь поле symbol отображает корректный символ базового актива опциона, а поле symbol внутри структуры options — торговый символ самого опциона
  • устранена проблема в работе OrdersService.SubscribeOrderTrade
  • проведены внутренние оптимизации и технические улучшения сервиса
  • названия полей в ответах приведены к единому стилю: теперь в REST используются такие же, как в gRPC

Важно: Обратной совместимости по именам полей не будет. Пользователям REST API потребуется скорректировать свой код для обработки новых имен полей.

Ближайшие планы:

  • реализовать отображение данных для моно- и сегрегированных счетов в методе GetAccount. Даст возможность использовать эти счета через Trade API
  • в структуру Positions метода GetAccount добавить новые поля: unrealized_pnl_daily, unrealized_pnl_total, maintenance_margin
  • добавить возможность открытия демо-счетов через Trade API

Версия 2.5.0 (18.06.2025)​

Обновления:

Версия 2.4.0 (05.06.2025)​

Обновления:

  • обновлена точка доступа. gRPC: api.finam.ru:443. REST API: api.finam.ru.
  • добавили в AccountsService.Trade поле ответа orded_id. Для маппинга сделок и заявок.
  • добавили метод получения времени на сервере AssetsService.Clock. Для синхронизации локальных часов с нашим сервером.
  • добавили стримминг метод gRPC. Подписка на собственные заявки и сделки.
  • добавили стримминг метод gRPC. Подписка на свечи.
  • добавили сторону сделки (side) для структуры Trade. Используется в методах MarketDataService.LatestTrades, SubscribeLatestTrades.
  • добавили метод AssetsService.GetAsset, отдающий информацию по конкретному инструменту. Поля ответа: код режима торгов, id, тикер, mic-код, isin, тип инструмента, название, кол-во десятичных знаков в цене, минимальный шаг цены, кол-во штук в лоте, дата экспирации фьючерса (если есть).
  • добавление статусов "отмененные", "отклоненные" в OrderState.OrderStatus. Для методов OrdersService.GetOrders(GetOrder).

Ближайшие планы:

  • добавление полей ответа в метод GetAccount: position_market_value, buying_power, non_margin_buying_power, insettled_cash.
  • администрирование токена (secret key): выбрать доступ к счетам (группе счетов), какой тип доступа (просмотровый или торговый), возможность давать токену пользовательское имя (видно только на портале), возможность выбрать срок действия (дефолтный срок действия 1 год).
  • укорочение токенов: secret, jwt.

Версия 2.3.0 (29.04.2025)​

Обновления:

  • убрали дубли в ответе метода Exchanges
  • SubscribeQuote, SubscribeOrderBook теперь в ответе возвращают symbol в формате ticker@mic
  • теперь работают тикеры с @ на конце. Пример symbol: TMON@@RUSX (ticker: TMON@)
  • добавлен новый метод GetAssetParams, возвращает торговые ГО параметры инструмента, внутри конкретного счета.

Ближайшие планы:

  • пофиксить: MarketDataService.LatestTrades не возвращает в ответе сторону сделки (buy/sell).
  • добавить стримминг методы gRPC свечи
  • добавить стримминг методы gRPC собственные заявки и сделки
  • добавить gRPC, REST: метод отдающий информацию по конкретному инструменту. Ожидаемые параметры: код режима торгов, id, тикер, mic-код, isin, тип инструмента, название, кол-во десятичных знаков в цене, минимальный шаг цены, кол-во штук в лоте, дата экспирации фьючерса (если есть)