name: “tqsdk_sim”
description: “TqSdk天勤量化交易框架配置账户、查询持仓、下单交易的操作指南。Invoke when user asks about tqsdk usage, account configuration, position query, or order placement.”

TqSdk 天勤量化交易框架使用指南

1. 安装与环境配置

1.1 安装tqsdk

pip install tqsdk

1.2 配置账户认证

需要设置环境变量或在代码中使用dotenv加载.env文件：

from dotenv import load_dotenv
import os

load_dotenv()  # 加载.env文件

2. 账户配置

2.1 模拟交易账户配置（推荐）

from tqsdk import TqApi, TqAuth, TqSim

# 创建模拟账户
sim_account = TqSim()

# 连接模拟账户
api = TqApi(account=sim_account, auth=TqAuth(os.getenv("TQ_USERNAME"), os.getenv("TQ_PASSWORD")))

2.2 快期账户配置（实盘）

from tqsdk import TqApi, TqAuth, TqKq, TqMultiAccount

# 创建快期账户，number为账户数量
tq_kq001 = TqKq(number=13)

# 连接实盘账户
api = TqApi(
    account=TqMultiAccount(([tq_kq001])),
    auth=TqAuth(os.getenv("TQ_USERNAME"), os.getenv("TQ_PASSWORD"))
)

3. 查询持仓

3.1 获取账户信息

account_info = api.get_account()
print(f"可用资金: {account_info['available']}")
print(f"浮动盈亏: {account_info['float_profit']}")
print(f"总资产: {account_info['balance']}")

3.2 查询所有持仓

positions = api.get_position()
for symbol, pos in positions.items():
    print(f"合约: {symbol}")
    print(f"多头持仓: {pos['volume_long']}")
    print(f"空头持仓: {pos['volume_short']}")

4. 下单交易

4.1 市价单

# 买入开仓
order = api.insert_order(
    symbol="CZCE.FG605",
    direction="BUY",
    offset="OPEN",
    volume=20,
    price=0
)

4.2 限价单

order = api.insert_order(
    symbol="CZCE.FG605",
    direction="BUY",
    offset="OPEN",
    volume=20,
    price=1500
)

5. 完整示例

import os
from dotenv import load_dotenv
from tqsdk import TqApi, TqAuth, TqSim

load_dotenv()
sim = TqSim()
api = TqApi(account=sim, auth=TqAuth(os.getenv("TQ_USERNAME"), os.getenv("TQ_PASSWORD")))

# 查询账户
account = api.get_account()
print(f"账户权益: {account['balance']}")

# 查询持仓
positions = api.get_position()
print(f"当前持仓: {positions}")

# 下单
order = api.insert_order(symbol="CZCE.FG605", direction="BUY", offset="OPEN", volume=20, price=0)

# 关闭
api.close()