快速开始

uv pip install tigeropen

pip install tigeropen

from tigeropen.tiger_open_config import TigerOpenClientConfig

client_config = TigerOpenClientConfig(props_path='/path/to/tiger_openapi_config.properties')

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']])

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)

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 = "/path/to/config_dir";
    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());
    }
  }
}

{
  "mcpServers": {
    "tiger-openapi": {
      "command": "uvx",
      "args": ["tigeropen-mcp"],
      "env": {
        "TIGER_CONFIG_PATH": "/path/to/tiger_openapi_config.properties"
      }
    }
  }
}

# 安装
pip install tigeropen-cli

# 查询 AAPL 实时报价
tiger quote AAPL

# 查询持仓
tiger positions

# 为 Claude Code / Cursor / Kiro 安装 Tiger OpenAPI 领域知识
npx skills add tigerfintech/tigeropen-skill