快速开始
5 分钟内完成接入，查询第一条行情数据。支持 Python SDK、Java SDK 以及 AI/MCP 无代码方式。
前置条件
- 完成老虎账户开户并入金
- 在开发者中心开通 OpenAPI 权限，获取 Tiger ID 和私钥
详细步骤见准备工作。
选择接入方式
第一步：安装 SDK
推荐使用 uv（更快的 Python 包管理器）：
mkdir my-tiger-project && cd my-tiger-project
uv init
uv add tigeropen也可以在虚拟环境中使用 pip：
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install tigeropen第二步：配置凭证
将开发者中心下载的配置文件路径传入：
from tigeropen.tiger_open_config import TigerOpenClientConfig
client_config = TigerOpenClientConfig(props_path='your_config_directory_path')第三步：查询 K 线
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.common.consts import BarPeriod
quote_client = QuoteClient(client_config)
# 查询苹果日 K 线（最近 5 根）
bars = quote_client.get_bars(['AAPL'], period=BarPeriod.DAY, limit=5)
print(bars[['symbol', 'time', 'open', 'high', 'low', 'close', 'volume']])示例输出：
symbol time open high low close volume
0 AAPL 1715731200000 189.50 191.20 188.80 190.10 52341000
1 AAPL 1715644800000 188.10 190.50 187.60 189.30 48120000第四步：查询持仓
from tigeropen.trade.trade_client import TradeClient
from tigeropen.common.consts import SecurityType
trade_client = TradeClient(client_config)
positions = trade_client.get_positions(sec_type=SecurityType.STK)
for p in positions:
print(p.contract.symbol, p.quantity, p.average_cost, p.market_value)第一步：添加依赖
<dependency>
<groupId>io.github.tigerbrokers</groupId>
<artifactId>openapi-java-sdk</artifactId>
<version>2.4.1</version>
</dependency>implementation 'io.github.tigerbrokers:openapi-java-sdk:2.4.1'第二步：完整示例（可直接运行）
以下代码包含初始化客户端、查询 K 线、查询持仓三个步骤，可复制后直接运行：
import com.tigerbrokers.stock.openapi.client.config.ClientConfig;
import com.tigerbrokers.stock.openapi.client.https.client.TigerHttpClient;
import com.tigerbrokers.stock.openapi.client.https.request.quote.QuoteKlineRequest;
import com.tigerbrokers.stock.openapi.client.https.request.trade.PositionsRequest;
import com.tigerbrokers.stock.openapi.client.https.response.quote.QuoteKlineResponse;
import com.tigerbrokers.stock.openapi.client.https.response.trade.PositionsResponse;
import com.tigerbrokers.stock.openapi.client.struct.enums.KType;
import com.tigerbrokers.stock.openapi.client.struct.enums.RightOption;
import com.tigerbrokers.stock.openapi.client.util.builder.AccountParamBuilder;
import java.util.Arrays;
public class QuickStart {
public static void main(String[] args) {
// 第一步：初始化客户端
// configFilePath 为开发者中心下载的配置文件 tiger_openapi_config.properties 所在目录
ClientConfig clientConfig = ClientConfig.DEFAULT_CONFIG;
clientConfig.configFilePath = "your_config_directory_path";
TigerHttpClient client = TigerHttpClient.getInstance().clientConfig(clientConfig);
// 第二步：查询苹果日 K 线
QuoteKlineResponse klineResponse = client.execute(
QuoteKlineRequest.newRequest(Arrays.asList("AAPL"), KType.day, "2024-01-01", "2024-01-10")
.withLimit(5)
.withRight(RightOption.br)
);
if (klineResponse.isSuccess()) {
klineResponse.getKlineItems().forEach(item ->
item.getItems().forEach(point ->
System.out.println(item.getSymbol() + " " + point.getTime() + " close=" + point.getClose())
)
);
} else {
System.out.println("K 线查询失败: " + klineResponse.getMessage());
}
// 第三步：查询持仓
PositionsRequest posRequest = new PositionsRequest();
posRequest.setBizContent(AccountParamBuilder.instance()
.account(clientConfig.defaultAccount)
.secType("STK")
.buildJson());
PositionsResponse posResponse = client.execute(posRequest);
if (posResponse.isSuccess()) {
posResponse.getItem().getPositions().forEach(p ->
System.out.println(p.getSymbol() + " qty=" + p.getPositionQty() + " cost=" + p.getAverageCost())
);
} else {
System.out.println("持仓查询失败: " + posResponse.getMessage());
}
}
}无需写 SDK 代码，即可通过 AI 工具调用老虎 OpenAPI。三种方式可同时使用，互不冲突：
不知道选哪个？ 想在对话里直接问 → MCP；想写脚本/定时任务 → CLI；用 AI 写代码、希望生成更准 → Skill
MCP Server — 在 AI 对话中直接调用行情与交易
把以下配置粘贴进 Claude Desktop / Cursor 的 mcp.json，重启后即可用自然语言操作：
{
"mcpServers": {
"tiger-openapi": {
"command": "uvx",
"args": ["--python", "3.13", "tigermcp"],
"env": {
"TIGEROPEN_PROPS_PATH": "your_config_directory_path",
"TIGERMCP_READONLY": "true"
}
}
}
}然后在 AI 对话中直接说：查询 AAPL 最新价格。以上配置启用了只读模式，不允许下单；需要交易能力时，请先阅读完整配置指南并明确关闭只读模式。
命令行工具 CLI — 一行命令查行情、管订单
# 安装
pip install tigeropen
# 查询 AAPL 实时报价
tigeropen quote briefs AAPL
# 查询持仓
tigeropen trade position listAI Skill — 让 AI 写出更准确的 OpenAPI 代码
# 为 Claude Code / Cursor / Kiro 安装 Tiger OpenAPI 领域知识
npx skills add tigerfintech/tigeropen-skill安装后，在 AI 编程工具中描述需求（如"帮我用 Python SDK 查 AAPL K 线"），生成的代码会自动匹配正确的 API 和参数。
其他语言 SDK
除 Python 和 Java 外，老虎 OpenAPI 还提供以下语言的 SDK：
| 语言 | 文档 |
|---|---|
| C++ | Cpp SDK |
| C# | C# SDK |
| Go | Go SDK |
| TypeScript | TypeScript SDK |
| Rust | Rust SDK |
遇到问题？
遇到问题时，优先使用页面右上角的 Ask AI 功能直接提问，通常能快速得到解答。
如需查阅文档：
Updated 7 days ago
Did this page help you?