Releases: FinamWeb/finam-trade-api
Releases · FinamWeb/finam-trade-api
Release 2.11.0
Исправления
- Обработка
Bearerпрефикса в токенах: Сервис аутентификации теперь корректно обрабатывает токены, переданные с префиксомBearer, что решает проблемы совместимости со стандартными HTTP-клиентами (Swagger UI, Postman). Также улучшена обработка токенов с лишними пробелами. - Корректное заполнение дат первой сделки: Исправлена логика заполнения полей
first_trade_dateиfirst_non_trade_dateдля обеспечения точности данных даже на счетах с большим объемом транзакций. - Отображение тикера в отчете "Доход по паям": Устранена ошибка, из-за которой в транзакциях категории "Доход по паям" отсутствовал
symbolинструмента.
Доработки API
- Аутентификация для WebSocket-соединений: Добавлена возможность аутентификации WebSocket-соединений напрямую из браузера. Теперь токен можно передавать в теле каждого запроса, что упрощает интеграцию для веб-приложений. Соединение разрывается, если аутентификация не пройдена в течение 5 секунд.
- Подписка на обновления портфеля : Реализована новая подписка
SubscribeAccount, позволяющая клиентам получать изменения по портфелю в реальном времени, в том числе и через WebSocket. Это устраняет необходимость постоянно опрашивать сервер для получения актуальных данных.
Release 2.10.0
Исправления
- Оптимизировали работу метода
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
Исправления
- Метод
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разделён на два отдельных: SubscribeOrdersSubscribeTrades
Старый метод остаётся активным, но в будущем будет deprecated.
- В методы
PlaceOrderиTradesдобавлено полеcomment— для кастомных меток при выставлении заявок и анализа сделок.
Release 2.8.0
Обновления:
- Стабильность стрима 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
Обновления:
- Разблокировка МОНО и СММА счетов. Теперь они доступны в 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
Introduce Finam Trade API Kotlin SDK