/miniqmt

name: miniqmt
description: MiniQMT 迅投量化交易接口，基于 XtQuant Python 库（xtdata 行情 / xttrader 交易），供外部 Python 程序连接 MiniQMT 客户端，支持 A 股/期货/期权的行情获取（K线、分笔、财务数据等）和交易下单（报单、撤单、查询资产/委托/持仓）。当用户提及 miniqmt、xtquant、获取实时行情、量化交易下单、回测数据获取，或需要用外部 Python 程序连接 MiniQMT 客户端进行程序化交易时使用。若需在 QMT 客户端内编写/回测内置策略（ContextInfo/passorder），请用 qmt-strategy 技能。
metadata: {"openclaw":{"emoji":"📈","requires":{"bins":["python3"]}}}

MiniQMT 量化交易技能

任务目标

• 本 Skill 用于：通过 XtQuant 库连接 MiniQMT 客户端，获取 A 股/期货/期权行情数据，执行量化交易操作
• 能力包含：
• **行情模块 (xtdata)**：K线数据、分笔数据、实时行情订阅、财务数据、板块分类、ETF信息、新股申购、交易日历
• **交易模块 (xttrader)**：股票/期货/期权下单、撤单、查询资产/委托/持仓、资金划拨、信用交易、约券
• 触发条件：用户提及 miniqmt、xtquant、获取行情、量化交易、下单交易时使用

> **与 qmt-strategy 的区别**：本技能通过 **xtquant 库**在**外部 Python 程序**中连接 MiniQMT 客户端（`xtdata` 行情 / `xttrader` 交易）；若需在 QMT 客户端内编写**内置策略**（`ContextInfo`/`passorder`、`#coding:gbk`），请使用 `qmt-strategy` 技能。

前置准备

MiniQMT 环境要求

• **客户端安装**：需安装迅投极速交易终端，并启动 MiniQMT（支持模拟/实盘）
• **Python 库**：`pip install xtquant`
• **路径配置**：MiniQMT 安装目录下的 `userdata_mini` 路径用于 xttrader 连接

目录结构

QMT安装目录\
├── bin.x64\XtMiniQmt.exe # MiniQMT 主程序
├── userdata_mini\        # 用户数据目录（xttrader 连接路径）
│   ├── xqtrader.ini      # 交易配置
│   └── xtdatacenter.ini  # 行情配置

核心概念

证券代码格式

• **股票**：6位数字 + 市场后缀，如 `600000.SH`（上海）、`000001.SZ`（深圳）
• **期货**：品种代码 + 合约月份，如 `rb2405.SF`（螺纹钢）
• **期权**：标的代码 + 行权月份，如 `510050.SH`（上证50ETF期权）

周期类型 (period)

| 周期 | 说明 | 周期 | 说明 | |------|------|------|------| | `tick` | 分笔数据 | `1q` | 季度线 | | `1m` | 1分钟线 | `1hy` | 半年线 | | `5m` | 5分钟线 | `1y` | 年线 | | `15m` | 15分钟线 | `1w` | 周线 | | `30m` | 30分钟线 | `1d` | 日线 | | `1h` | 1小时线 | `1mon` | 月线 |

复权类型 (dividend_type)

• `none` - 不复权
• `front` - 前复权
• `back` - 后复权
• `front_ratio` - 等比前复权
• `back_ratio` - 等比后复权

交易市场 (market)

| 市场 | 常量 | 市场 | 常量 | |------|------|------|------| | 上海 | `xtconstant.SH_MARKET` | 中金所 | `xtconstant.MARKET_ENUM_INDEX_FUTURE` | | 深圳 | `xtconstant.SZ_MARKET` | 上期所 | `xtconstant.MARKET_ENUM_SHANGHAI_FUTURE` | | 北交所 | `xtconstant.MARKET_ENUM_BEIJING` | 郑商所 | `xtconstant.MARKET_ENUM_ZHENGZHOU_FUTURE` | | 大商所 | `xtconstant.MARKET_ENUM_DALIANG_FUTURE` | 广期所 | `xtconstant.MARKET_ENUM_GUANGZHOU_FUTURE` |

账号类型 (account_type)

| 类型 | 常量 | 类型 | 常量 | |------|------|------|------| | 股票 | `xtconstant.SECURITY_ACCOUNT` | 沪港通 | `xtconstant.HUGANGTONG_ACCOUNT` | | 期货 | `xtconstant.FUTURE_ACCOUNT` | 深港通 | `xtconstant.SHENGANGTONG_ACCOUNT` | | 信用 | `xtconstant.CREDIT_ACCOUNT` | 期货期权 | `xtconstant.FUTURE_OPTION_ACCOUNT` | | 股票期权 | `xtconstant.STOCK_OPTION_ACCOUNT` | - | - |

操作步骤

1. **确定需求** — 识别是行情数据获取还是交易操作 2. **选择模块** — xtdata 用于行情，xttrader 用于交易 3. **调用脚本** — 根据数据类型选择对应脚本 4. **解析结果** — 智能体分析返回的 JSON 格式数据

意图识别映射示例

| 用户提问 | 对应功能 | 调用方式 | |---------|---------|---------| | "贵州茅台实时股价" | 实时行情快照 | xtdata.get_full_tick | | "平安银行K线数据" | K线数据 | xtdata.get_market_data | | "招商银行财务指标" | 财务报表 | xtdata.get_financial_data | | "半导体板块成分股" | 板块成分股 | xtdata.get_stock_list_in_sector | | "今日可转债信息" | ETF/可转债数据 | xtdata.get_cb_info | | "新股申购" | 新股信息 | xtdata.get_ipo_info | | "下单买入平安银行" | 交易下单 | xttrader.order_stock | | "查询持仓" | 持仓查询 | xttrader.query_stock_positions | | "撤单" | 撤单操作 | xttrader.cancel_order_stock |

使用示例

示例1：获取股票实时行情

import xtdata

# 获取全推行情快照
ticks = xtdata.get_full_tick(['600519.SH', '000001.SZ'])

# 订阅单股实时行情
def on_data(datas):
    for code in datas:
        print(code, datas[code])

xtdata.subscribe_quote('600519.SH', period='tick', callback=on_data)
xtdata.run()

示例2：获取K线历史数据

import xtdata

# 下载历史K线数据
xtdata.download_history_data2(['600519.SH'], period='1d', start_time='')

# 获取K线数据
data = xtdata.get_market_data(
    field_list=['open', 'high', 'low', 'close', 'volume'],
    stock_list=['600519.SH'],
    period='1d',
    start_time='20240101',
    end_time='',
    count=100,
    dividend_type='front'
)

示例3：交易下单

from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback
from xtquant.xttype import StockAccount
from xtquant import xtconstant

# 配置路径和会话
path = 'D:\\迅投极速交易终端\\userdata_mini'
session_id = 123456
xt_trader = XtQuantTrader(path, session_id)

# 创建账号对象
acc = StockAccount('1000000365')  # 替换为实际账号

# 连接交易
xt_trader.start()
connect_result = xt_trader.connect()
subscribe_result = xt_trader.subscribe(acc)

# 下单买入
order_id = xt_trader.order_stock(
    acc,
    '600519.SH',
    xtconstant.STOCK_BUY,
    100,  # 100股
    xtconstant.FIX_PRICE,
    1800.0,  # 价格
    'strategy1',
    'remark'
)

# 查询资产
asset = xt_trader.query_stock_asset(acc)
print(f"可用资金: {asset.cash}")

示例4：订阅行情并实时处理

import xtdata

def on_tick_data(datas):
    for code in datas:
        tick = datas[code]
        print(f"{code}: 现价={tick['lastPrice']}, 成交量={tick['volume']}")

# 订阅多只股票
xtdata.subscribe_whole_quote(['SH', 'SZ'], callback=on_tick_data)
xtdata.run()

资源索引

行情数据脚本

• **行情快照**：`python scripts/market_data.py snapshot --code 600519.SH`
• **K线数据**：`python scripts/market_data.py kline --code 600519.SH --period 1d --count 100`
• **分笔数据**：`python scripts/market_data.py tick --code 600519.SH --count 100`
• **实时行情**：`python scripts/market_data.py full_tick --codes 600519.SH,000001.SZ`

板块与财务脚本

• **板块列表**：`python scripts/sector_data.py sector_list`
• **板块成分股**：`python scripts/sector_data.py sector_stocks --sector 半导体`
• **财务数据**：`python scripts/financial_data.py financial --code 600519.SH --tables Balance,Income`

交易脚本

• **下单**：`python scripts/trade.py order --code 600519.SH --type buy --volume 100 --price 1800.0`
• **撤单**：`python scripts/trade.py cancel --order_id 12345`
• **查询持仓**：`python scripts/trade.py positions`
• **查询委托**：`python scripts/trade.py orders`
• **查询资产**：`python scripts/trade.py asset`
• **查询成交**：`python scripts/trade.py trades`

参考文档

• [xtdata 行情模块 API](references/xtdata.md)（何时读取：需要查看行情数据接口时）
• [xtdata行情数据字段与数据字典](references/xtdata_dict.md) （何时读取：需要查看行情数据字段、数据字典时）
• [xttrader 交易模块 API](references/xttrader.md)（何时读取：需要查看交易接口、数据结构说明时）
• [安装与下载指南](references/download_xt