Python SDK Version Update

3.5.7 (2026-03-25)

Fix

• Fixed the issue where using <b0>setuptools.backends._legacy:_Backend</b0> as the build-backend in pyproject.toml caused installation failures with older versions of pip/setuptools. Changed it to the standard <b1>setuptools.build_meta</b1>.

  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 <b4>tigeropen</b4>, 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 <b5>tigeropen uninstall</b5>.

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