Tiger Open API Python SDK

老虎量化开放平台 Python SDK 完整技能集 / Complete AI skill set for Tiger Brokers OpenAPI

安全警告 / Safety Warning: 交易涉及真实资金。生成交易代码时默认使用模拟账户（Paper Trading），除非用户明确要求实盘。实盘下单前必须：1) 调用 preview_order() 展示预估佣金；2) 以表格展示订单详情；3) 停止并等待用户明确确认后才能调用 place_order()。 Trading involves real money. Default to Paper Trading unless the user explicitly requests live trading. Before any live place_order() call: 1) call preview_order() and show estimated fees, 2) display order details in a table, 3) stop and wait for explicit user confirmation — never auto-submit.

• Docs: https://docs.itigerup.com/docs/prepare
• GitHub: https://github.com/tigerfintech/openapi-python-sdk
• SDK: pip install tigeropen | Python 3.8 - 3.14

Language Rules / 语言规则

根据用户输入语言自动回复。用户使用英文提问则用英文回复，使用中文提问则用中文回复。技术术语（代码、API 名称、参数名）保持原文不翻译。 Reply in the user's language. Keep technical terms (code, API names, parameters) as-is.

Reference Guides

This skill is organized into focused reference files. Load the relevant guide based on your task:

• Quickstart — SDK install, authentication, client setup, enums/objects, error codes, FAQ
• Market Data — Real-time quotes, K-lines, depth, ticks, capital flow, fundamentals, scanner
• Trading — Place orders (market/limit/stop/algo), order management, assets, positions, fund transfers
• Options — Option chains, Greeks, single-leg/multi-leg combos, option calculator
• Real-time Push — Subscribe to quote/depth/tick/K-line/order/position/asset changes via PushClient
• CLI Tool — Command-line interface: config, quote, trade, account, push commands with table/json/csv output
• MCP Server — Expose Tiger API as MCP tools for Cursor, Claude Code, Kiro, Trae

Quick Start

from tigeropen.common.consts import Language, Market
from tigeropen.tiger_open_config import TigerOpenClientConfig
from tigeropen.common.util.signature_utils import read_private_key
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.trade.trade_client import TradeClient

# 1. Configure / 配置
# 方式一：配置文件(推荐) / Method 1: Config file (recommended)
config = TigerOpenClientConfig(props_path='/path/to/your/config/')

# 方式二：代码赋值 / Method 2: Code assignment
# config = TigerOpenClientConfig()
# config.tiger_id = 'your_tiger_id'
# config.private_key = read_private_key('/path/to/your_private_key.pem')
# config.account = 'your_account'
# config.language = Language.en_US

# 2. Query quotes / 查询行情
quote_client = QuoteClient(config)
quote = quote_client.get_market_status(Market.US)

# 3. Place order / 下单
trade_client = TradeClient(config)
# See references/trade.md for order examples

When to Use Each Reference

Common Symbols / 常见标的速查

当用户使用中文名称或英文简称时，按下表映射。不在表中的标的根据上下文判断。 Map user's natural language to symbols. For unlisted symbols, infer from context.

港股 HK

美股 US