## 3.8.0 (2026-09-17) ### New * Added OAuth2 authentication as an alternative to tigerId + private key signing: `OAuth2SessionManager` handles authorization and token management, and `config.authentication = OAuth2Authentication(sessions)` integrates it into the client. Tokens are stored in `~/.tiger/openapi/`, automatically refreshed upon expiration, and no private key is required in code or configuration * Added OAuth2 support for streaming; tokens are refreshed directly on the existing connection when they are about to expire, without disconnecting and reconnecting * Added the `tigeropen auth` command group (`login` / `logout` / `status` / `token`) to the CLI; `config init` now supports OAuth2 configuration; added the global `--account` option ### Compatibility * The existing tigerId + private key signing method remains unaffected; if `authentication` is not configured, the signing method continues to be used
## 3.7.2 (2026-08-27) ### New * Added the `amount` field to real-time quote results from `QuoteBrief` / `get_stock_briefs`, supporting trading amount for stocks and cryptocurrencies.
## 3.7.1 (2026-08-19) ### New * Added `mark_price`, `pre_mark_price`, `mark_timestamp`, `mid_price`, `pre_mid_price`, and `mid_timestamp` fields to the data returned by `get_option_chain`
## 3.7.0 (2026-07-23) ### New * `get_corporate_symbol_change` — Query stock symbol changes * `get_corporate_delisting` — Query delisting events * `get_corporate_ipo` — Query IPO listings * Added `SYMBOL_CHANGE`, `DELISTING`, and `IPO` to `CorporateActionType`
## 3.6.0 (2026-06-24) ### New * Added the `iceberg_order` helper function for constructing iceberg orders * Added `PriceType` enum constants (`LIMIT_PRICE`, `ASK_PRICE`, `BID_PRICE`, `LATEST_PRICE`)
## 3.5.9 (2026-06-08) ### New * `TradeClient.submit_option_exercise` — Submit an application for early exercise or abandonment of an option * `TradeClient.cancel_option_exercise` — Cancel an option exercise application * `TradeClient.check_option_exercise` — Check option exercise eligibility and estimate post-exercise position changes * `TradeClient.get_option_exercise_records` — Paginated query of option exercise application records, with filtering by status, exercise type, and underlying symbol * `TradeClient.get_option_exercise_positions` — Query positions eligible for option exercise * Added order information update time and status update time to order push messages
## 3.5.8 (2026-04-24) ### New * Added the `tigeropen quote scanner` stock screening command to the CLI, supporting `--filter` (numeric/cumulative/financial/tag filters, with `gainers`/`losers` presets), `--sort`, `--sort-dir`, and `--limit` parameters * Added a one-click Windows PowerShell installation script `install.ps1` (`irm .../install.ps1 | iex`); `install.sh` now provides PowerShell installation guidance in MINGW/MSYS/Cygwin environments ### Fix * Fixed an issue where `_get_props_path()` replaced the filename with `tiger_openapi_config.properties` when a full file path was provided; arbitrary filenames are now supported * Fixed an issue where the `account assets` command failed when rendering a `PortfolioAccount` object ## 3.5.7 (2026-03-25) ### Fix * Fixed the issue where using `setuptools.backends._legacy:_Backend` as the build-backend in pyproject.toml caused installation failures with older versions of pip/setuptools. Changed it to the standard `setuptools.build_meta`. Fixed the problem where unconditionally importing the push module during CLI startup led to all commands being unavailable when there was a protobuf version incompatibility. Changed to lazy loading of the push command and added a prompt to upgrade when the protobuf version is too low.
## 3.5.6 (2026-03-24) ### New Added the CLI command-line tool `tigeropen`, supporting functions such as market data query, transaction management, account viewing, and real-time push. Output formats include table/json/csv. One-click installation is supported. CLI subcommands: config (init/show/set/path), quote (briefs/bars/timeline/ticks/depth/market-status/symbols + option/future/capital/fundamental subgroups), trade (order list/get/place/preview/modify/cancel + position/transaction), account (info/assets/analytics), push (quote/order/position/asset) The CLI supports automatic uninstallation via `tigeropen uninstall`. Added AI Skills set, supporting AI coding tools such as Claude Code and Cursor. Added pyproject.toml, adopting modern Python packaging standards. ### Modify Migrated document links to the new domain docs.itigerup.com. The README has been restructured into Chinese and English bilingual versions, with added instructions for using CLI / MCP / Skills.
## 3.5.5 (2026-03-23) ### New The option analysis interface returns historical volatility curve data
## 3.5.4 (2026-03-02) ### New * Support notional orders * Support cryptocurrency basic market data and trading
## 3.5.3 (2026-02-06) ### New * `QuoteClient.get_option_analysis` Retrieve options analysis indicators (implied volatility, historical volatility, IV/HV ratio, put-call ratio, IV percentile, IV ranking)
## 3.5.2 (2026-01-21) ### New Features * Added new fields to **real-time stock quotes**: Price change (`change`) / Price change rate (`changeRate`) / Amplitude (`amplitude`) * Added new fields to **real-time option quotes**: Mark price (`markPrice`) / Mid price (`midPrice`) / Previous mark price (`preMarkPrice`) / Annualized selling return (`sellingReturn`) ## 3.4.9 (2025-10-28) ### New * The StockFundamental data interface now returns newly added basic data. * The K-line interface now returns newly added price-earnings ratio and turnover rate. ## 3.4.5 (2025-08-22) ### New * `QuoteClient.get_future_depth` * QuoteClient `get_depth_quote`, `get_trade_ticks`, `get_timeline`, `get_timeline_history`, `get_bars` support `trade_session` to query OverNight trading data * MCP Server beta version pre-release ## 3.4.4 (2025-07-31) ### New * Stock scanner added cursor_id parameter ## 3.4.3 (2025-07-22) ### New * Order utility functions support `time_in_force` parameter * QuoteClient futures contract interface adds fields: contract size `product_worth`, delivery method `delivery_mode`, contract type `product_type` * QuoteClient futures real-time quote interface adds field `open_interest_change` ### Breaking * Orders/transactions support page token ## 3.4.1 (2025-06-26) ### New * Supports pulling options timeline data. * Enhanced quota returns: Added last pull time for each symbol * Contract add attribute `support_fractional_share` ## 3.4.0 (2025-06-16) ### New * Supports minute-level K-line data with a larger time range. ## 3.3.9 (2025-06-12) ### New * Add attribute `timeInForce` to order callback\` ## 3.3.8 (2025-05-29) ### New * Support TBUS license * Support order preview ## 3.3.7 (2025-05-12) ### New * Add attribute `attrList` to order callback\` * `QuoteClient` Each subscription method returns the subscription id ## 3.3.6 (2025-04-28) ### New * `TradeClient.get_fund_details` Fund details * `QuoteClient` Option-related interfaces support timezone parameters ## 3.3.5 (2025-04-11) ### New * `QuoteClient.get_broker_hold` Market value of HK broker holdings ## 3.3.4 (2025-04-09) ### New * `TradeClient.get_aggregate_assets` ### Mod * Updated stock picker fields ## 3.3.3 (2025-03-05) ### Mod * Contract add `support_overnight_trading` attribute ## 3.3.2 (2025-02-25) ### New * `QuoteClient.get_trade_rank` Hot trading rankings ### Mod * Contract add `lot_size` attribute ## 3.3.1 (2024-12-31) ### New * `TradeClient.get_funding_history` funding history query ### Mod * `QuoteClient.get_bars` add `trade_session` parameter ## 3.3.0 (2024-12-17) ### New * `QuoteClient.get_stock_fundamental` get stock fundamental data, like ROE, PB ### Fix * long connection `error_callback` not called ## 3.2.9 (2024-11-25) ### Fix * fix `TradeClient.get_contracts` parameter error ## 3.2.8 (2024-11-11) ### Modify * `TradeClient.get_order` add `show_charges` parameter, order object add `charges` field * consolidated account asset add `uncollected`, `locked_funds` fields * push position object `PositionData` add `positionQty`, `salableQty` fields ## 3.2.7 (2024-07-12) ### Modify * `QuoteClient.get_option_depth` fix return data handling ## 3.2.5 (2024-06-19) ## Fix `QuoteClient.get_option_depth`. ### New * Add `QuoteClient.get_option_depth`, `QuoteClient.get_option_symbols`. ### Modify * `QuoteClient.get_option_chain` Add parameter `market` * `QuoteClient.get_option_briefs` ### Add parameter `market` ### Modify `QuoteClient.get_option_chain` ### Modify * `QuoteClient.get_option_expirations` Increase parameter `market` ## 3.2.4 (2024-06-05) ### Modify * Support nightly trading parameters, can be set by modifying `order.trading_session_type` of order object. * Position add fields `mm_value`, `mm_percent`. ## 3.2.3 (2024-04-11) ### Fix * `QuoteClient.get_option_expirations` fixes pandas handling of column names in multi-subject cases. ## 3.2.2 (2024-04-09) ### New * full tick push * `TradeClient.get_open_orders` `get_filled_orders` add `limit` param ## 3.2.1 (2024-04-09) ### Fix * `QuoteClient.get_option_briefs` add field `change` ## 3.2.0 (2024-04-02) ### Modify * `QuoteClient.get_option_chain` add `return_greek_value` param ### Breaking * `TradeClieng.get_managed_accounts` used to set the default account when the `account` parameter was not passed, but now it does not set the default account. ## 3.1.9 (2024-03-18) ### New * minute Kline push ### Modify * `QuoteClient.get_option_chain` `option_filter` param optimization * `QuoteClient.get_option_expirations` add field `period_tag` ## 3.1.8 (2024-03-12) ### Modify * `Order` add field `quantity_scale` for fractional quantities for fractional stock orders. ### Fix * PriceUtil, which handles contract ticks, adds an enumeration type CLOSED_OPEN. ## 3.1.7 (2024-02-28) ### Fix * Order push commissionAndFee type rolled back from double to float ## 3.1.6 (2024-02-26) ### Modify * Add field `gst` to `Order` and order push data; order push commissionAndFee type changed from float to double ## 3.1.5 (2024-01-19) ### Fix * Fix long-link protobuf message frame generation issue. ## 3.1.4 (2024-01-19) ### Modify * Optimize http requests to reuse connections * Optimize rsa signatures ## 3.1.3 (2024-01-04) ### Modify * `QuoteClient.get_symbol_names` support OTC * `TradeClient.get_prime_assets` support `consolidated` agrument ### Fix * `QuoteClient.get_market_scanner_tags` multi_tags_fields not working bug ## 3.1.2 (2023-11-17) ### New * support us option depth quote subscribe ## 3.1.1 (2023-10-18) ### New * support OCA order，with `tigeropen.common.util.order_utils.oca_order` function ### Modify * `QuoteClient.get_timeline` call 3.0 version api by default ## 3.1.0 (2023-10-11) ### Fix * fix `subscribe_option_top` argument ## 3.0.9 (2023-08-29) ### Modify * Order add field `latest_price` ## 3.0.8 (2023-08-16) ### New * add examples ## 3.0.6 (2023-07-31) ### Modify * push connection add exception handling ## 3.0.5 (2023-07-24) ### Fix * fix push order status enum ## 3.0.4 (2023-07-19) ### New * `QuoteClient.get_symbols` add param `include_otc` ### Breaking * In push data `tigeropen.push.pb.OrderStatusData_pb2.OrderStatusData` field `status` change to `tigeropen.common.consts.OrderStatus` enum name string，which can converted by `OrderStatus[frame.status]` or `get_order_status(frame.status)` as `OrderStatus` enum ## 3.0.3 (2023-07-10) ### New * `QuoteClient.get_stock_briefs` add `include_hour_trading` ## 3.0.2 (2023-07-07) ### New * option kline api add param `sort_dir` ### Fix * fix push connection reconnect ## 3.0.1 (2023-06-21) ### New * Historical K-line quota api * New profit/loss field for position objects by average cost * PushClient add stock/option top data ## 3.0.0 (2023-06-08) ### Breaking * PushClient changed default from stomp to protobuf ## 2.4.0 (2023-06-07) ### New * Support for option combination orders ### Fix * Fix indexing error in pandas field when paged k-line data is empty ## 2.3.9 (2023-06-01) ### Fix * Fix the problem that protobuf push tick data is not decompressed ### Modify * Modify order status push proto definition, add userMark ## 2.3.8 (2023-05-09) ### New * Contract interface added field margin offer information * QuoteClient New interface to get stock market scanner tags ### Modify * Modify some fields of the stock scanner ## 2.3.7 (2023-04-18) ### New * TradeClient adds an interface for estimating sellable quantity `TradeClient.get_estimate_tradable_quantity` * `Order` New field for order object `external_id` * `Position` new field `saleable` added to position object, only A shares have value; `saleable` field added to position push object ## 2.3.6 (2023-04-11) ### New * QuoteClient added `QuoteClient.get_warrant_filter`, `QuoteClient.get_warrant_briefs`, `QuoteClient.get_warrant_briefs` * `QuoteClient.get_option_bars` new parameter `limit` for option k-line interface ## 2.3.5 (2023-03-28) ### New * TradeClient segment fund api: `TradeClient.get_segment_fund_available` `TradeClient.transfer_segment_fund` `TradeClient.cancel_segment_fund` `TradeClient.get_segment_fund_history` * `TradeClient.place_forex_order` * `QuoteClient.get_option_bars` support `period` ## 2.3.4 (2023-03-20) ### New * support AM/AL order ## 2.3.3 (2023-03-10) ### Modify * token refresh. pip install watchdog enable token file monitor ### Fix * fix calendar api ## 2.3.2 (2023-03-03) ### New * PushClient support Protobuf ## 2.3.1 (2023-02-23) ### New * support 2FA token refresh duration, set client_config.token_refresh_duration = 0 to disable auto refresh. ### Fix * fix tick push ## 2.3.0 (2023-02-16) ### New * support config file; 2FA token ## 2.2.9 (2023-02-09) ### Fix * Fix tick push issue ### Modify * retry mechanism. client_config.retry_max_tries, when set to 0, means no retry ## 2.2.8 (2023-02-03) ### Fix * fix Option util ## 2.2.7 (2023-01-11) ### New * support log path ## 2.2.6 (2022-12-14) ### Fix * fix Windows gbk encode error when install ## 2.2.5 (2022-12-12) ### New * `tigeropen.trade.domain.contract.Contract` add new attributes: `is_etf`, `etf_leverage` ## 2.2.4 (2022-12-09) ### new * `QuoteClient.get_capital_flow` * `QuoteClient.get_capital_distribution` * `QuoteClient.get_stock_broker` ## 2.2.3 (2022-12-07) ### new * Market scanner `QuoteClient.market_scanner` ## 2.2.2 (2022-11-22) ### New * Order support GTD(good til date), can set by `time_in_force = "GTD"` * PushClient support order transaction detail subscription ## 2.2.1 (2022-11-07) ### Fixed * Fix `TradeClient.get_trade_ticks` begin_index argument 0 value ## 2.2.0 (2022-11-01) ### New * `PushClient` support futures ticks. Subscribe via `PushClient.subscribe_tick` and receive callbacks using `PushClient.tick_changed` ## 2.1.9 (2022-10-12) ### New * Support multi-license configuration, request different domain name by license. You can specify the license via client_config.license ### Modify * `Contract` new properties `short_initial_margin`, `short_maintenance_margin`, new method `to_str()` to print all properties * `QuoteClient.get_financial_report` add parameters `begin_date`, `end_date` * `QuoteClient.get_trade_ticks` compatible with version 1.0 interface ## 2.1.8 (2022-08-26) ### Modify * `TradeClient.get_orders` New parameter `seg_type`, can specify the type of trade (SEC/FUT/ALL) * `PushClient` Modify the number of auto-reconnect retries * `TradeClient.get_contract` interface version upgraded to V3 ### Fixed * Fix the problem that `TradeClient.get_contract` returns null when getting HK stock options contracts ## 2.1.7 (2022-08-19) ### New * new api `QuoteClient.get_all_future_contracts` * The attach order supports trail type ### Breaking * `QuoteClient.get_future_trade_ticks`, argument 'identifier' now only supports one. ## 2.1.6 (2022-08-11) ### Modify * Support global time zone configuration, you can set the time zone through ClientConfig.timezone ## 2.1.5 (2022-08-01) ### Modify * The trade-related api supports global language configuration, and the default language can be changed via ClientConfig.language ## 2.1.4 (2022-07-18) ### New * Added historical asset analysis interface `TradeClient.get_analytics_asset` * Added new contract price correction tool function `tigeropen.common.util.price_util.PriceUtil`, which corrects the input order price based on the requested contract tick size * Order object new property: update time: `update_time` * `TradeClient.get_orders` (get_open_orders/get_filled_orders)\` Support specified sorting rules, sort by order creation time or order status update time * Query position api `TradeClient.get_positions` supports option element (expiry, strike, put_call) parameter filtering ## 2.1.3 (2022-07-01) ### New * New method for long connections tick data:subscribe `PushClient.subscribe_tick`, unsubscribe `PushClient.unsubscribe_tick` * New subscribed query callback method `PushClient.query_subscribed_callback` replaces the old `Pushclient.subscribed_symbols` * `QuoteClient.get_trade_ticks` adds a new `trade_session` parameter, which can be specified to query pre and post market data ### Modify * `Pushclient.subscribed_symbols` marked as deprecated ## 2.1.2 (2022-06-14) ### Modify * upgrade stomp.py, from 4.1.24 to 8.0.1 ### Breaking * PushClient remove `auto_reconnect` parameter * handle connection kicked out error ## 2.1.1 (2022-05-25) ### New * add apis of query bars by page Stock：`QuoteClient.get_bars_by_page` Future：`QuoteClient.get_future_bars_by_page` * `QuoteClient.get_future_bars`, `QuoteClient.get_bars` add `page_token` parameter，which used to locate next page * `tigeropen.trade.domain.order.Order` add `user_mark` attribute，when place order, can pass a custom remark (need to apply) ## 2.1.0 (2022-05-07) ### New * dynamic configure server domain * add Option helper(examples.option_helpers.helpers) * add api `QuoteClient.get_future_contract` * add api `TradeClient.get_derivative_contracts` ## 2.0.9 (2022-04-18) ### New * add api `QuoteClient.get_timeline_history` * Order add new fields sub_ids: sub order id list adjust_limit: limit order price adjust percent ### Breaking * `TradeClient.place_order`, `TradeClient.modify_order`, `TradeClient.cancel_order` return value, `True` or `False` change to order's id * Auth grab quote permission. Grab permission when `QuoteClient` initialization，provide param `is_grab_permission` , if `False`, do not grab permission. ## 2.0.7 (2022-01-31) ### Modify * change domain ## 2.0.6 (2022-01-24) ### New * Contract add new fields marginable： close_only： shortable_count： * Order add new fields attr_desc： source： ### Breaking * `tigeropen.quote.request.OpenApiRequest` move to `tigeropen.common.request.OpenApiRequest` ## 2.0.5 (2022-01-10) ### New * Add api QuoteClient.get_quote_permission * Add api TradeClient.get_transactions * Add a full demo ### Changed * Enum value optimization * TradeClient.place_order remove Order.order_id checking * Remove pandas fixed version number ### Breaking * QuoteClient.grab_quote_permission return data，'expireAt' convert to 'expire_at' ## 2.0.4 (2021-12-08) ### New * Add api TradeClient.get_prime_assets ## 2.0.3 ### New * Add api QuoteClient.get_option_chain * Add api QuoteClient.get_stock_delay_briefs ## 2.0.2 (2021-11-01) ### Changed * Remove client_config some attributes * PushClient optimization ## 2.0.1 (2021-09-18) ### Breaking * Remove Python2 compatible ## 1.4.0 (2021-06-28) ### New * Add depth quote * Add quote permission grab api ## 1.2.0 (2020-04-02) ### New * Add industry api ## 1.1.10 (2020-01-19) ### New * Add company action api * Add attach order api ## 1.1.9 (2019-10-28) ### Fixed * Fix 1.1.8 setup problem

Changelog

Rust SDK Version Update

Java SDK Version Update

Python SDK Version Update