xttrader - SKILL.md Agent Skill

name: xttrader description: xqshare 交易命令行工具，查询持仓、资产、下单、撤单等

xttrader - 交易工具

⚠️ 重要约束

必须使用 xttrader 命令行工具，禁止直接调用 Python xtquant 库

✅ 正确做法	❌ 错误做法
`xttrader query_stock_positions`	`from xtquant import xttrader`
`xttrader order_stock --stock-code "..."`	`trader.order_stock(...)`

原因：

xtquant 只能在 Windows 上运行
本地环境（macOS/Linux）无法直接调用 xtquant
必须通过 xqshare 的命令行工具远程调用

使用场景

当用户需要：

查询账户持仓
查询账户资产
股票下单/撤单
查询订单状态

前置条件（用户自行配置）

⚠️ 以下环境需用户自行配置，本 skill 不提供配置指导

组件	要求	说明
Windows 服务器	必需	xtquant 只能运行在 Windows
xqshare 服务端	必需运行	在 Windows 上启动远程服务

本 skill 假设：

Windows 上已配置好 xtquant 环境（含 miniQMT）
xqshare 服务端已启动并可访问
客户端环境变量已正确配置

客户端配置

已安装 xqshare：pip install xqshare

已配置环境变量（推荐）：

export XQSHARE_REMOTE_HOST="192.168.1.100"
export XQSHARE_CLIENT_SECRET="your-secret"
export QMT_ACCOUNT_ID="你的资金账号"
export QMT_USERDATA_PATH="C:\\QMT\\userdata_mini"

命令格式

xttrader [全局参数] <command> [API参数]

参数规则：全局参数在 command 之前，API 参数在 command 之后

全局参数

参数	环境变量	说明
`--host`	XQSHARE_REMOTE_HOST	服务端地址
`--port`	XQSHARE_REMOTE_PORT	服务端端口
`--secret`	XQSHARE_CLIENT_SECRET	认证密钥
`--account-id`	QMT_ACCOUNT_ID	资金账号
`--account-type`	-	账户类型（默认 STOCK）
`--userdata-path`	QMT_USERDATA_PATH	QMT userdata_mini 路径

账户类型

类型	说明
STOCK	普通股票账户
CREDIT	信用账户（两融）
FUTURE	期货账户
HUGANGTONG	沪港通
SHENGANGTONG	深港通

常用命令

查询持仓

xttrader query_stock_positions
xttrader --account-id "12345678" query_stock_positions

查询资产

xttrader query_stock_asset

查询订单

# 查询所有订单
xttrader query_stock_orders

# 仅查询可撤订单
xttrader query_stock_orders --cancelable-only true

查询成交

xttrader query_stock_trades

下单

# order_type: 23=买入, 24=卖出
# price_type: 11=限价, 12=市价
xttrader order_stock --stock-code "000001.SZ" --order-type 23 --order-volume 100 --price-type 11 --price 10.0

撤单

# 按订单ID撤单
xttrader cancel_order_stock --order-id "订单ID"

# 按柜台编号撤单
xttrader cancel_order_stock_sysid --market "SH" --sysid "柜台合同编号"

⚠️ 安全提示

高风险命令需要用户二次确认后才能执行：

命令	风险等级	说明
`order_stock`	🔴 高	下单（买入/卖出）
`cancel_order_stock`	🔴 高	撤单
`cancel_order_stock_sysid`	🔴 高	撤单（按柜台编号）

执行流程：

先向用户展示将要执行的完整命令
明确说明操作内容和风险
等待用户明确确认（如 "确认"、"执行"、"yes"）
用户确认后再执行命令

示例：

AI: 即将执行下单操作：
    命令: xttrader order_stock --stock-code "000001.SZ" --order-type 23 --order-volume 100 --price-type 11 --price 10.0
    操作: 买入 平安银行(000001.SZ) 100股，限价 10.0 元
    预估金额: 1000 元

    请确认是否执行？(确认/取消)

用户: 确认

AI: [执行命令]

限制

不支持 subscribe/register 开头的命令（需要回调）
不支持 callback 参数（需要 Python API）

⚠️ 数值处理注意事项

科学计数法计算要特别仔细：

科学计数法	实际值	常见错误
`1.23e8`	123,000,000 (1.23亿)	❌ 误认为 1230 万
`1.23e9`	1,230,000,000 (12.3亿)	❌ 误认为 1.23 亿
`5.67e6`	5,670,000 (567万)	❌ 误认为 56.7 万
`3.14e10`	31,400,000,000 (314亿)	❌ 位数算错

计算规则：

e6 = 百万 (万 × 100)
e7 = 千万 (万 × 1000)
e8 = 亿
e9 = 十亿
e10 = 百亿

处理建议：

遇到科学计数法时，先转换为完整数字再解读
复述数值时，明确写出完整数字或使用"亿/万"单位
金额相关计算务必二次核对

参数格式

股票代码：带交易所后缀，如 "000001.SZ", "600000.SH"
订单类型：23=买入, 24=卖出
报价类型：11=限价, 12=市价