Skip to content

Releases: FinamWeb/finam-trade-api

Release 2.11.0

23 Jan 07:10

Choose a tag to compare

Исправления

  • Обработка Bearer префикса в токенах: Сервис аутентификации теперь корректно обрабатывает токены, переданные с префиксом Bearer, что решает проблемы совместимости со стандартными HTTP-клиентами (Swagger UI, Postman). Также улучшена обработка токенов с лишними пробелами.
  • Корректное заполнение дат первой сделки: Исправлена логика заполнения полей first_trade_date и first_non_trade_date для обеспечения точности данных даже на счетах с большим объемом транзакций.
  • Отображение тикера в отчете "Доход по паям": Устранена ошибка, из-за которой в транзакциях категории "Доход по паям" отсутствовал symbol инструмента.

Доработки API

  • Аутентификация для WebSocket-соединений: Добавлена возможность аутентификации WebSocket-соединений напрямую из браузера. Теперь токен можно передавать в теле каждого запроса, что упрощает интеграцию для веб-приложений. Соединение разрывается, если аутентификация не пройдена в течение 5 секунд.
  • Подписка на обновления портфеля : Реализована новая подписка SubscribeAccount, позволяющая клиентам получать изменения по портфелю в реальном времени, в том числе и через WebSocket. Это устраняет необходимость постоянно опрашивать сервер для получения актуальных данных.

Release 2.10.0

22 Jan 15:09

Choose a tag to compare

Исправления

  • Оптимизировали работу метода GetOrders, LatestTrades и SubscribeLatestTrades
  • Теперь если при выставлении ордера была ошибка , то при повторном запросе можно не изменять значение client_order_id

Доработки API

  • Добавили возможность вводить отрицательные цены при размещении ордера
  • GetAssetParams - должен возвращать новое поле price_type.
  • PlaceOrder - tradeapi сервис позволяет вводить отрицательный limit_price для лимитной или стоп лимитной заявки, если price_type = ANY или неотрицательный limit_price, если price_type = NON_NEGATIVE.
  • Добавили параметр оставшегося объема и текущего объема исполнения ордера
  • В ордере появились новые параметры initial_quantity (начальный объем), executed_quantity (исполненный объем), remaining_quantity (оставшийся объем)

Release 2.9.0

03 Dec 11:42
fc872a5

Choose a tag to compare

Исправления

  • Метод Trades: Ранее возникала ошибка “Security ids doesn't exist…” из-за истёкших опционов в сделках. Теперь сделки возвращаются корректно, ошибки нет. Для истёкших опционов символ временно отсутствует — работа по его добавлению продолжается.
  • Метод GetOptionsChain: Не возвращалась цепочка опционов по фьючерсам из-за неконсистентности данных. Добавлены поля expiration_date и root. Теперь данные согласованы, цепочки по фьючерсам также формируются корректно.
  • Метод GetAssetParams: Поле tradable возвращало неверные значения (false). Добавлено корректное поле is_tradable. Поле tradable переведено в статус deprecated.

Доработки API

  • В метод Transactions добавлено поле change_qty — количество бумаг при трансферах.
  • В метод GetAccount добавлены даты:
  • open_account_date — дата открытия счёта,
  • first_trade_date — дата первой торговой сделки,
  • first_non_trade_date — дата первой неторговой операции.

Также в методах Trades и Transactions: если start_time пустой или меньше даты первой сделки, данные возвращаются начиная с даты первой сделки.

  • В метод GetAsset добавлено поле quote_currency — код валюты.
  • Метод SubscribeOrderTrade разделён на два отдельных:
  • SubscribeOrders
  • SubscribeTrades

Старый метод остаётся активным, но в будущем будет deprecated.

  • В методы PlaceOrder и Trades добавлено поле comment — для кастомных меток при выставлении заявок и анализа сделок.

Release 2.8.0

01 Oct 13:11
02fec04

Choose a tag to compare

Обновления:

  • Стабильность стрима SubscribeOrderTrade: проведены работы по устранению преждевременного обрыва стрима. Теперь ожидается разрыв соединения один раз в 24 часа с момента открытия стрима.

Исправления:

  • Исправлена ошибка преобразования TimeInForce в методе PlaceOrder для ордеров типа ORDER_TYPE_STOP и ORDER_TYPE_STOP_LIMIT.
  • В методе PlaceOrder в тело запроса добавлен параметр ValidBefore. Он заполняется при создании заявок с типами ORDER_TYPE_STOP и ORDER_TYPE_STOP_LIMIT.
  • Также поле ValidBefore добавлено в ответы методов PlaceOrder, CancelOrder, GetOrder, GetOrders, SubscribeOrderTrade.
  • Параметр TimeInForce теперь не заполняется при выставлении заявок типов ORDER_TYPE_STOP и ORDER_TYPE_STOP_LIMIT.
  • Исправлено отображение поля symbol для купона в методе Transactions — теперь поле не пустое.

Доработки методов API:

  • Новый метод SubscribeJwtRenewal: позволяет автоматически получать обновленные JWT-токены в стриме, решая задачу “ручной” генерации токена.
  • В методе GetAssetParams добавлены поля long_initial_margin и short_initial_margin для лучшего понимания. Они полностью соответствуют значениям полей long_collateral и short_collateral, которые в будущем будут устаревшими (deprecate).
  • В ответ метода TokenDetailsResponse добавлено поле readonly, позволяющее увидеть права токена: запись/чтение.

Release 2.7.0

28 Aug 07:29
ceac19d

Choose a tag to compare

Обновления:

  • Разблокировка МОНО и СММА счетов. Теперь они доступны в Trade API. Эти счета включают торговлю опционами на фьючерсы на российском рынке (МОНО). На международном рынке (через сегрегированный глобал счет СММА): US options on stocks&ETFs, US futures, US stocks&ETFs.
  • Стабильность стримов: проведены работы по устранению нестабильности при получении рыночных данных.
  • Исправления:
  • устранена ошибка, при которой просмотровый токен работал как боевой;
  • исправлено отображение 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: скомпилированные библиотеки для Python и Kotlin.

Release 2.7.0 - SDK

27 Aug 09:33
3b34c36

Choose a tag to compare

Introduce Finam Trade API Kotlin SDK