miniQMT(迅投极简量化交易终端)
miniQMT 是迅投科技开发的轻量级量化交易终端,专为外接Python设计。它作为本地Windows服务运行,通过 XtQuant Python SDK(xtdata + xttrade)提供行情数据和交易功能。
⚠️ 需要券商开通miniQMT权限。联系您的证券公司开通。多家国内券商支持(国金、华鑫、中泰、东方财富、国信、方正等)。
miniQMT 概述
- 轻量级QMT客户端,在Windows上作为后台服务运行
- 为外部Python程序提供行情数据服务 + 交易服务
- Python脚本通过
xtquant SDK经本地TCP连接(xtdata获取行情,xttrade执行交易)
- 支持品种:A股、ETF、可转债、期货、期权、融资融券
- 部分券商提供免费的 Level 2数据
架构
Python脚本(任意IDE: VS Code, PyCharm, Jupyter等)
↓ xtquant SDK(pip install xtquant)
├── xtdata ──TCP──→ miniQMT(行情数据服务)
└── xttrade ──TCP──→ miniQMT(交易服务)
↓
券商交易系统
如何获取 miniQMT
- 在支持QMT的券商开立证券账户
- 申请miniQMT权限(部分券商要求最低资产,如5万-10万元)
- 从券商处下载安装QMT客户端
- 以miniQMT模式(极简模式)启动并登录
使用流程
1. 启动 miniQMT
以极简模式启动QMT客户端并登录。miniQMT界面非常简洁——只有一个登录窗口。
2. 安装 xtquant
pip install xtquant
3. 使用Python连接行情数据
from xtquant import xtdata
# 连接本地miniQMT行情数据服务
xtdata.connect()
# 下载历史数据(首次访问前必须下载)
xtdata.download_history_data('000001.SZ', '1d', start_time='20240101', end_time='20240630')
# 获取K线数据(返回以股票代码为键的DataFrame字典)
data = xtdata.get_market_data_ex(
[], ['000001.SZ'], period='1d',
start_time='20240101', end_time='20240630',
dividend_type='front' # 前复权
)
print(data['000001.SZ'].tail())
4. 使用Python连接交易服务
from xtquant import xtconstant
from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback
from xtquant.xttype import StockAccount
# path必须指向QMT安装目录下的userdata_mini文件夹
path = r'D:\券商QMT\userdata_mini'
# session_id对每个策略/脚本必须唯一
session_id = 123456
xt_trader = XtQuantTrader(path, session_id)
# 注册回调接收实时推送通知
class MyCallback(XtQuantTraderCallback):
def on_disconnected(self):
print('已断开连接 — 需要重新连接')
def on_stock_order(self, order):
print(f'Order update: {order.stock_code} status={order.order_status} msg={order.status_msg}')
def on_stock_trade(self, trade):
print(f'Trade filled: {trade.stock_code} {trade.traded_volume}@{trade.traded_price}')
def on_order_error(self, order_error):
print(f'Order error: {order_error.error_msg}')
xt_trader.register_callback(MyCallback())
xt_trader.start()
connect_result = xt_trader.connect() # 收益率 0 on success, non-zero on failure
account = StockAccount('your_account')
xt_trader.subscribe(account) # 订阅账户推送通知
# 下买入单
order_id = xt_trader.order_stock(
account, '000001.SZ', xtconstant.STOCK_BUY, 100,
xtconstant.FIX_PRICE, 11.50, 'my_strategy', 'test_order'
)
# order_id > 0 表示成功,-1 表示失败
miniQMT 与完整版 QMT 对比
| 特性 |
miniQMT |
QMT(完整版) |
| Python |
外接Python(任意版本) |
内置Python(版本受限) |
| IDE |
任意(VS Code, PyCharm, Jupyter等) |
仅内置编辑器 |
| 第三方库 |
所有pip包(pandas, numpy等) |
仅内置库 |
| 界面 |
极简(仅登录窗口) |
完整交易UI + 图表 |
| 行情数据 |
通过xtdata API |
内置 + xtdata API |
| 交易 |
通过xttrade API |
内置 + xttrade API |
| 资源占用 |
轻量(~50 MB内存) |
较重(完整GUI,~500 MB+) |
| 调试 |
完整IDE调试支持 |
有限 |
| 使用场景 |
自动化策略、外部集成 |
可视化分析 + 手动交易 |
| 连接方式 |
一次性连接,无自动重连 |
持久连接 |
数据能力(通过xtdata)
| 类别 |
详情 |
| K-line |
tick, 1m, 5m, 15m, 30m, 1h, 1d, 1w, 1mon — supports adjustment (forward / backward / proportional) |
| Tick |
Real-time tick data with 5-level bid/ask, volume, turnover, trade count |
| Level 2 |
l2quote (real-time snapshot), l2order (order-by-order), l2transaction (trade-by-trade), l2quoteaux (aggregate buy/sell), l2orderqueue (order queue), l2thousand (1000-level order book), fullspeedorderbook (full-speed 20-level) |
| Financials |
Balance sheet, income statement, cash flow statement, per-share metrics, share structure, top 10 shareholders / free-float holders, shareholder count |
| Reference |
Trading calendar, holidays, sector lists, index constituents & weights, ex-dividend data, contract info |
| Real-time |
Single-stock subscription (subscribe_quote), market-wide push (subscribe_whole_quote) |
| Special |
Convertible bond info, IPO subscription data, ETF creation/redemption lists, announcements & news, consecutive limit-up tracking, snapshot indicators (volume ratio / price velocity), high-frequency IOPV |
数据访问模式
download_history_data() → get_market_data_ex() # Historical data: download to local cache first, then read from cache
subscribe_quote() → callback # Real-time data: subscribe and receive via callback
get_full_tick() # Snapshot data: get latest tick for the entire market
交易能力(通过xttrade)
| 类别 |
操作 |
| Stocks |
Buy/sell (sync and async), limit/market/best price orders |
| ETF |
Buy/sell, creation/redemption |
| Convertible bonds |
Buy/sell |
| Futures |
Open long/close long/open short/close short |
| Options |
Buy/sell open/close, covered open/close, exercise, lock/unlock |
| Margin trading |
Margin buy, short sell, buy to cover, direct return, sell to repay, direct repayment, special margin/short |
| IPO |
New share/bond subscription, query subscription quota |
| Cancel |
Cancel by order_id or broker contract number (sync and async) |
| Query |
Assets, orders, trades, positions, futures position summary |
| Credit query |
Credit assets, liability contracts, margin-eligible securities, available-to-short data, collateral |
| Bank-broker transfer |
Bank to securities, securities to bank (sync and async) |
| Smart algorithms |
VWAP and other algorithmic execution |
| Securities lending |
Query available securities, apply for lending, manage contracts |
账户类型
StockAccount('id') # 普通股票账户
StockAccount('id', 'CREDIT') # 信用账户(融资融券)
StockAccount('id', 'FUTURE') # 期货账户
关键交易回调
| 回调函数 |
触发时机 |
on_stock_order(order) |
Order status change (submitted, partially filled, fully filled, cancelled, rejected) |
on_stock_trade(trade) |
Trade execution report |
on_stock_position(position) |
Position change |
on_stock_asset(asset) |
Asset/fund change |
on_order_error(error) |
Order placement failure |
on_cancel_error(error) |
Order cancellation failure |
on_disconnected() |
Disconnected from miniQMT |
订单状态码
| 值 |
状态 |
| 48 |
未报 |
| 50 |
已报 |
| 54 |
已撤 |
| 55 |
部分成交 |
| 56 |
已成 |
| 57 |
废单 |
常见券商路径
# 国金证券
path = r'D:\国金证券QMT交易端\userdata_mini'
# 华鑫证券
path = r'D:\华鑫证券\userdata_mini'
# 中泰证券
path = r'D:\中泰证券\userdata_mini'
# 东方财富
path = r'D:\东方财富证券QMT交易端\userdata_mini'
股票代码格式
| 市场 |
示例 |
| 上海A股 |
600000.SH |
| 深圳A股 |
000001.SZ |
| 北交所 |
430047.BJ |
| 指数 |
000001.SH(上证综指), 399001.SZ(深证成指) |
| 中金所期货 |
IF2401.IF |
| 上期所期货 |
ag2407.SF |
| 期权 |
10004358.SHO |
| ETF |
510300.SH |
| 可转债 |
113050.SH |
完整示例:行情数据 + 交易策略
from xtquant import xtdata, xtconstant
from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback
from xtquant.xttype import StockAccount
# === 回调类定义 ===
class MyCallback(XtQuantTraderCallback):
def on_disconnected(self):
print('已断开连接')
def on_stock_trade(self, trade):
print(f'Trade filled: {trade.stock_code} {trade.traded_volume}@{trade.traded_price}')
def on_order_error(self, order_error):
print(f'Error: {order_error.error_msg}')
# === 1. 连接行情数据服务 ===
xtdata.connect()
# === 2. 下载并获取历史数据 ===
stock = '000001.SZ'
xtdata.download_history_data(stock, '1d', start_time='20240101', end_time='20240630')
data = xtdata.get_market_data_ex(
[], [stock], period='1d',
start_time='20240101', end_time='20240630',
dividend_type='front' # 前复权
)
df = data[stock]
# === 3. 计算简单均线交叉信号 ===
df['ma5'] = df['close'].rolling(5).mean() # 5日均线
df['ma20'] = df['close'].rolling(20).mean() # 20日均线
latest = df.iloc[-1] # 最新K线
prev = df.iloc[-2] # 前一根K线
# === 4. 连接交易服务 ===
path = r'D:\券商QMT\userdata_mini'
xt_trader = XtQuantTrader(path, 123456)
xt_trader.register_callback(MyCallback())
xt_trader.start()
if xt_trader.connect() != 0:
print('连接失败!')
exit()
account = StockAccount('your_account')
xt_trader.subscribe(account) # 订阅账户推送通知
# === 5. 执行交易信号 ===
if prev['ma5'] <= prev['ma20'] and latest['ma5'] > latest['ma20']:
# 金叉信号:5日均线上穿20日均线,买入
order_id = xt_trader.order_stock(
account, stock, xtconstant.STOCK_BUY, 100,
xtconstant.LATEST_PRICE, 0, 'ma_cross', 'golden_cross'
)
print(f'Golden cross buy — {stock}, order_id={order_id}')
elif prev['ma5'] >= prev['ma20'] and latest['ma5'] < latest['ma20']:
# 死叉信号:5日均线下穿20日均线,卖出
order_id = xt_trader.order_stock(
account, stock, xtconstant.STOCK_SELL, 100,
xtconstant.LATEST_PRICE, 0, 'ma_cross', 'death_cross'
)
print(f'Death cross sell — {stock}, order_id={order_id}')
# === 6. 查询结果 ===
asset = xt_trader.query_stock_asset(account)
print(f'Available cash: {asset.cash}, Total assets: {asset.total_asset}')
positions = xt_trader.query_stock_positions(account)
for pos in positions:
print(f'{pos.stock_code}: {pos.volume} shares, available={pos.can_use_volume}, cost={pos.open_price}')
完整示例:实时行情监控
from xtquant import xtdata
import threading
def on_tick(datas):
"""Tick数据回调函数"""
for code, tick in datas.items():
print(f'{code}: latest={tick["lastPrice"]}, volume={tick["volume"]}')
# 连接行情数据服务
xtdata.connect()
# 在单独线程中运行订阅(xtdata.run()会阻塞当前线程)
def run_data():
xtdata.subscribe_quote('000001.SZ', period='tick', callback=on_tick)
xtdata.subscribe_quote('600000.SH', period='tick', callback=on_tick)
xtdata.run() # 阻塞线程,持续接收数据
t = threading.Thread(target=run_data, daemon=True)
t.start()
# 主线程可以执行交易或其他操作
# ...
使用技巧
- miniQMT 仅支持Windows — 如果TCP可达,Python脚本可以在同一台或不同机器上运行。
- Python脚本运行期间,miniQMT必须保持登录状态。
connect() 是一次性连接 — 断开后不会自动重连,需要自行实现重连逻辑。
session_id 对每个策略必须唯一 — 不同Python脚本必须使用不同的session_id。
- 实时订阅时,
xtdata.run() 会阻塞线程 — 请在单独线程中运行,主线程用于交易。
- 下载的数据会本地缓存 — 后续读取速度极快。
- 在推送回调(
on_stock_order等)中,使用异步查询方法(如 query_stock_orders_async)避免死锁。或启用 set_relaxed_response_order_enabled(True)。
- 部分券商提供miniQMT免费Level 2数据 — 请咨询您的券商。
- 文档:http://dict.thinktrader.net/nativeApi/start_now.html
进阶示例
网格交易策略
from xtquant import xtdata, xtconstant
from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback
from xtquant.xttype import StockAccount
import threading
class GridCallback(XtQuantTraderCallback):
def on_stock_trade(self, trade):
print(f'Trade filled: {trade.stock_code} {trade.traded_volume}@{trade.traded_price}')
def on_order_error(self, error):
print(f'Error: {error.error_msg}')
# 初始化交易
path = r'D:\券商QMT\userdata_mini'
xt_trader = XtQuantTrader(path, 100001)
xt_trader.register_callback(GridCallback())
xt_trader.start()
xt_trader.connect()
account = StockAccount('your_account')
xt_trader.subscribe(account)
# 网格参数
stock = '000001.SZ'
grid_base = 11.0 # 基准价格
grid_step = 0.2 # 网格间距
grid_shares = 100 # 每格交易股数
grid_levels = 5 # 上下各5档
last_grid = 0 # 当前网格层级
xtdata.connect()
def on_tick(datas):
global last_grid
for code, tick in datas.items():
price = tick['lastPrice']
# 计算价格对应的当前网格层级
current_grid = int((price - grid_base) / grid_step)
if current_grid < last_grid:
# 价格下穿网格线,买入
for _ in range(last_grid - current_grid):
xt_trader.order_stock(
account, code, xtconstant.STOCK_BUY, grid_shares,
xtconstant.LATEST_PRICE, 0, 'grid', f'网格买入_level{current_grid}'
)
last_grid = current_grid
elif current_grid > last_grid:
# 价格上穿网格线,卖出
for _ in range(current_grid - last_grid):
xt_trader.order_stock(
account, code, xtconstant.STOCK_SELL, grid_shares,
xtconstant.LATEST_PRICE, 0, 'grid', f'网格卖出_level{current_grid}'
)
last_grid = current_grid
# 启动行情数据订阅
def run_data():
xtdata.subscribe_quote(stock, period='tick', callback=on_tick)
xtdata.run()
t = threading.Thread(target=run_data, daemon=True)
t.start()
xt_trader.run_forever()
可转债T+0日内交易
from xtquant import xtdata, xtconstant
from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback
from xtquant.xttype import StockAccount
import threading
class CBCallback(XtQuantTraderCallback):
def on_stock_trade(self, trade):
print(f'Trade filled: {trade.stock_code} {trade.traded_volume}@{trade.traded_price}')
path = r'D:\券商QMT\userdata_mini'
xt_trader = XtQuantTrader(path, 100002)
xt_trader.register_callback(CBCallback())
xt_trader.start()
xt_trader.connect()
account = StockAccount('your_account')
xt_trader.subscribe(account)
# 可转债代码(可转债支持T+0交易)
cb_code = '113050.SH'
buy_threshold = -0.5 # 跌幅超过0.5%买入
sell_threshold = 0.5 # 涨幅超过0.5%卖出
position = 0
xtdata.connect()
def on_tick(datas):
global position
for code, tick in datas.items():
price = tick['lastPrice']
pre_close = tick['lastClose']
if pre_close == 0:
continue
pct_change = (price - pre_close) / pre_close * 100
# 跌幅达到阈值,买入10手
if pct_change <= buy_threshold and position == 0:
xt_trader.order_stock(
account, code, xtconstant.STOCK_BUY, 10,
xtconstant.LATEST_PRICE, 0, 'cb_t0', '可转债T0买入'
)
position = 10
# 涨幅达到阈值,卖出
elif pct_change >= sell_threshold and position > 0:
xt_trader.order_stock(
account, code, xtconstant.STOCK_SELL, position,
xtconstant.LATEST_PRICE, 0, 'cb_t0', '可转债T0卖出'
)
position = 0
def run_data():
xtdata.subscribe_quote(cb_code, period='tick', callback=on_tick)
xtdata.run()
t = threading.Thread(target=run_data, daemon=True)
t.start()
xt_trader.run_forever()
定时打新申购
from xtquant import xtdata, xtconstant
from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback
from xtquant.xttype import StockAccount
import datetime
import time
class IPOCallback(XtQuantTraderCallback):
def on_stock_order(self, order):
print(f'IPO subscription: {order.stock_code} status={order.order_status} {order.status_msg}')
path = r'D:\券商QMT\userdata_mini'
xt_trader = XtQuantTrader(path, 100003)
xt_trader.register_callback(IPOCallback())
xt_trader.start()
xt_trader.connect()
account = StockAccount('your_account')
xt_trader.subscribe(account)
# 查询新股申购额度
limits = xt_trader.query_new_purchase_limit(account)
print(f"Subscription quota: {limits}")
# 查询今日新股数据
ipo_data = xt_trader.query_ipo_data()
if ipo_data:
for code, info in ipo_data.items():
print(f"New stock: {code} {info['name']} issue price={info['issuePrice']} max subscription={info['maxPurchaseNum']}")
# 以最大允许量申购
max_vol = info['maxPurchaseNum']
if max_vol > 0:
order_id = xt_trader.order_stock(
account, code, xtconstant.STOCK_BUY, max_vol,
xtconstant.FIX_PRICE, info['issuePrice'], 'ipo', '新股申购'
)
print(f" Subscription submitted: order_id={order_id}")
else:
print("今日无新股可申购")
🤖 AI Agent 高阶使用指南
对于 AI Agent,在使用该量化/数据工具时应遵循以下高阶策略和最佳实践,以确保任务的高效完成:
1. 数据校验与错误处理
在获取数据或执行操作后,AI 应当主动检查返回的结果格式是否符合预期,以及是否存在缺失值(NaN)或空数据。
- 示例策略:在通过 API 获取数据框(DataFrame)后,使用
if df.empty: 进行校验;捕获 Exception 以防网络或接口错误导致进程崩溃。
2. 多步组合分析
AI 经常需要进行宏观经济分析或跨市场对比。应善于将当前接口与其他数据源或工具组合使用。
- 示例策略:先获取板块或指数的宏观数据,再筛选成分股,最后对具体标的进行深入的财务或技术面分析,形成完整的决策链条。
3. 构建动态监控与日志
对于交易和策略类任务,AI 可以定期拉取数据并建立监控机制。
- 示例策略:使用循环或定时任务检查特定标的的异动(如涨跌停、放量),并在发现满足条件的信号时输出结构化日志或触发预警。
社区与支持
由 大佬量化 维护 — 量化交易教学与策略研发团队。
微信客服: bossquant1 · Bilibili · 搜索 大佬量化 — 微信公众号 / Bilibili / 抖音
1---2name: miniqmt3description: miniQMT 极简量化交易终端 - 支持外接Python获取行情数据和程序化交易,基于xtquant SDK。4version: 1.2.05homepage: http://dict.thinktrader.net/nativeApi/start_now.html6metadata:7 source: https://skillmd.com/skills/leoyeai-openclaw-master-skills/miniqmt8 clawdbot:9 emoji: 🚀10 requires:11 bins:12 - python313---1415# miniQMT(迅投极简量化交易终端)1617miniQMT 是迅投科技开发的轻量级量化交易终端,专为外接Python设计。它作为本地Windows服务运行,通过 [XtQuant](http://dict.thinktrader.net/nativeApi/start_now.html) Python SDK(`xtdata` + `xttrade`)提供行情数据和交易功能。1819> ⚠️ **需要券商开通miniQMT权限**。联系您的证券公司开通。多家国内券商支持(国金、华鑫、中泰、东方财富、国信、方正等)。2021## miniQMT 概述2223- **轻量级QMT客户端**,在Windows上作为后台服务运行24- 为外部Python程序提供**行情数据服务** + **交易服务**25- Python脚本通过 `xtquant` SDK经本地TCP连接(xtdata获取行情,xttrade执行交易)26- 支持品种:A股、ETF、可转债、期货、期权、融资融券27- 部分券商提供免费的 **Level 2数据**2829## 架构3031```32Python脚本(任意IDE: VS Code, PyCharm, Jupyter等)33 ↓ xtquant SDK(pip install xtquant)34 ├── xtdata ──TCP──→ miniQMT(行情数据服务)35 └── xttrade ──TCP──→ miniQMT(交易服务)36 ↓37 券商交易系统38```3940## 如何获取 miniQMT41421. 在支持QMT的券商开立证券账户432. 申请miniQMT权限(部分券商要求最低资产,如5万-10万元)443. 从券商处下载安装QMT客户端454. 以miniQMT模式(极简模式)启动并登录4647## 使用流程4849### 1. 启动 miniQMT5051以极简模式启动QMT客户端并登录。miniQMT界面非常简洁——只有一个登录窗口。5253### 2. 安装 xtquant5455```bash56pip install xtquant57```5859### 3. 使用Python连接行情数据6061```python62from xtquant import xtdata6364# 连接本地miniQMT行情数据服务65xtdata.connect()6667# 下载历史数据(首次访问前必须下载)68xtdata.download_history_data('000001.SZ', '1d', start_time='20240101', end_time='20240630')6970# 获取K线数据(返回以股票代码为键的DataFrame字典)71data = xtdata.get_market_data_ex(72 [], ['000001.SZ'], period='1d',73 start_time='20240101', end_time='20240630',74 dividend_type='front' # 前复权75)76print(data['000001.SZ'].tail())77```7879### 4. 使用Python连接交易服务8081```python82from xtquant import xtconstant83from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback84from xtquant.xttype import StockAccount8586# path必须指向QMT安装目录下的userdata_mini文件夹87path = r'D:\券商QMT\userdata_mini'88# session_id对每个策略/脚本必须唯一89session_id = 12345690xt_trader = XtQuantTrader(path, session_id)9192# 注册回调接收实时推送通知93class MyCallback(XtQuantTraderCallback):94 def on_disconnected(self):95 print('已断开连接 — 需要重新连接')96 def on_stock_order(self, order):97 print(f'Order update: {order.stock_code} status={order.order_status} msg={order.status_msg}')98 def on_stock_trade(self, trade):99 print(f'Trade filled: {trade.stock_code} {trade.traded_volume}@{trade.traded_price}')100 def on_order_error(self, order_error):101 print(f'Order error: {order_error.error_msg}')102103xt_trader.register_callback(MyCallback())104xt_trader.start()105connect_result = xt_trader.connect() # 收益率 0 on success, non-zero on failure106107account = StockAccount('your_account')108xt_trader.subscribe(account) # 订阅账户推送通知109110# 下买入单111order_id = xt_trader.order_stock(112 account, '000001.SZ', xtconstant.STOCK_BUY, 100,113 xtconstant.FIX_PRICE, 11.50, 'my_strategy', 'test_order'114)115# order_id > 0 表示成功,-1 表示失败116```117118---119120## miniQMT 与完整版 QMT 对比121122| 特性 | miniQMT | QMT(完整版) |123|---|---|---|124| **Python** | 外接Python(任意版本) | 内置Python(版本受限) |125| **IDE** | 任意(VS Code, PyCharm, Jupyter等) | 仅内置编辑器 |126| **第三方库** | 所有pip包(pandas, numpy等) | 仅内置库 |127| **界面** | 极简(仅登录窗口) | 完整交易UI + 图表 |128| **行情数据** | 通过xtdata API | 内置 + xtdata API |129| **交易** | 通过xttrade API | 内置 + xttrade API |130| **资源占用** | 轻量(~50 MB内存) | 较重(完整GUI,~500 MB+) |131| **调试** | 完整IDE调试支持 | 有限 |132| **使用场景** | 自动化策略、外部集成 | 可视化分析 + 手动交易 |133| **连接方式** | 一次性连接,无自动重连 | 持久连接 |134135---136137## 数据能力(通过xtdata)138139| 类别 | 详情 |140|---|---|141| **K-line** | tick, 1m, 5m, 15m, 30m, 1h, 1d, 1w, 1mon — supports adjustment (forward / backward / proportional) |142| **Tick** | Real-time tick data with 5-level bid/ask, volume, turnover, trade count |143| **Level 2** | l2quote (real-time snapshot), l2order (order-by-order), l2transaction (trade-by-trade), l2quoteaux (aggregate buy/sell), l2orderqueue (order queue), l2thousand (1000-level order book), fullspeedorderbook (full-speed 20-level) |144| **Financials** | Balance sheet, income statement, cash flow statement, per-share metrics, share structure, top 10 shareholders / free-float holders, shareholder count |145| **Reference** | Trading calendar, holidays, sector lists, index constituents & weights, ex-dividend data, contract info |146| **Real-time** | Single-stock subscription (`subscribe_quote`), market-wide push (`subscribe_whole_quote`) |147| **Special** | Convertible bond info, IPO subscription data, ETF creation/redemption lists, announcements & news, consecutive limit-up tracking, snapshot indicators (volume ratio / price velocity), high-frequency IOPV |148149### 数据访问模式150151```152download_history_data() → get_market_data_ex() # Historical data: download to local cache first, then read from cache153subscribe_quote() → callback # Real-time data: subscribe and receive via callback154get_full_tick() # Snapshot data: get latest tick for the entire market155```156157## 交易能力(通过xttrade)158159| 类别 | 操作 |160|---|---|161| **Stocks** | Buy/sell (sync and async), limit/market/best price orders |162| **ETF** | Buy/sell, creation/redemption |163| **Convertible bonds** | Buy/sell |164| **Futures** | Open long/close long/open short/close short |165| **Options** | Buy/sell open/close, covered open/close, exercise, lock/unlock |166| **Margin trading** | Margin buy, short sell, buy to cover, direct return, sell to repay, direct repayment, special margin/short |167| **IPO** | New share/bond subscription, query subscription quota |168| **Cancel** | Cancel by order_id or broker contract number (sync and async) |169| **Query** | Assets, orders, trades, positions, futures position summary |170| **Credit query** | Credit assets, liability contracts, margin-eligible securities, available-to-short data, collateral |171| **Bank-broker transfer** | Bank to securities, securities to bank (sync and async) |172| **Smart algorithms** | VWAP and other algorithmic execution |173| **Securities lending** | Query available securities, apply for lending, manage contracts |174175### 账户类型176177```python178StockAccount('id') # 普通股票账户179StockAccount('id', 'CREDIT') # 信用账户(融资融券)180StockAccount('id', 'FUTURE') # 期货账户181```182183### 关键交易回调184185| 回调函数 | 触发时机 |186|---|---|187| `on_stock_order(order)` | Order status change (submitted, partially filled, fully filled, cancelled, rejected) |188| `on_stock_trade(trade)` | Trade execution report |189| `on_stock_position(position)` | Position change |190| `on_stock_asset(asset)` | Asset/fund change |191| `on_order_error(error)` | Order placement failure |192| `on_cancel_error(error)` | Order cancellation failure |193| `on_disconnected()` | Disconnected from miniQMT |194195### 订单状态码196197| 值 | 状态 |198|---|---|199| 48 | 未报 |200| 50 | 已报 |201| 54 | 已撤 |202| 55 | 部分成交 |203| 56 | 已成 |204| 57 | 废单 |205206---207208## 常见券商路径209210```python211# 国金证券212path = r'D:\国金证券QMT交易端\userdata_mini'213# 华鑫证券214path = r'D:\华鑫证券\userdata_mini'215# 中泰证券216path = r'D:\中泰证券\userdata_mini'217# 东方财富218path = r'D:\东方财富证券QMT交易端\userdata_mini'219```220221## 股票代码格式222223| 市场 | 示例 |224|---|---|225| 上海A股 | `600000.SH` |226| 深圳A股 | `000001.SZ` |227| 北交所 | `430047.BJ` |228| 指数 | `000001.SH`(上证综指), `399001.SZ`(深证成指) |229| 中金所期货 | `IF2401.IF` |230| 上期所期货 | `ag2407.SF` |231| 期权 | `10004358.SHO` |232| ETF | `510300.SH` |233| 可转债 | `113050.SH` |234235---236237## 完整示例:行情数据 + 交易策略238239```python240from xtquant import xtdata, xtconstant241from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback242from xtquant.xttype import StockAccount243244# === 回调类定义 ===245class MyCallback(XtQuantTraderCallback):246 def on_disconnected(self):247 print('已断开连接')248 def on_stock_trade(self, trade):249 print(f'Trade filled: {trade.stock_code} {trade.traded_volume}@{trade.traded_price}')250 def on_order_error(self, order_error):251 print(f'Error: {order_error.error_msg}')252253# === 1. 连接行情数据服务 ===254xtdata.connect()255256# === 2. 下载并获取历史数据 ===257stock = '000001.SZ'258xtdata.download_history_data(stock, '1d', start_time='20240101', end_time='20240630')259data = xtdata.get_market_data_ex(260 [], [stock], period='1d',261 start_time='20240101', end_time='20240630',262 dividend_type='front' # 前复权263)264df = data[stock]265266# === 3. 计算简单均线交叉信号 ===267df['ma5'] = df['close'].rolling(5).mean() # 5日均线268df['ma20'] = df['close'].rolling(20).mean() # 20日均线269latest = df.iloc[-1] # 最新K线270prev = df.iloc[-2] # 前一根K线271272# === 4. 连接交易服务 ===273path = r'D:\券商QMT\userdata_mini'274xt_trader = XtQuantTrader(path, 123456)275xt_trader.register_callback(MyCallback())276xt_trader.start()277if xt_trader.connect() != 0:278 print('连接失败!')279 exit()280281account = StockAccount('your_account')282xt_trader.subscribe(account) # 订阅账户推送通知283284# === 5. 执行交易信号 ===285if prev['ma5'] <= prev['ma20'] and latest['ma5'] > latest['ma20']:286 # 金叉信号:5日均线上穿20日均线,买入287 order_id = xt_trader.order_stock(288 account, stock, xtconstant.STOCK_BUY, 100,289 xtconstant.LATEST_PRICE, 0, 'ma_cross', 'golden_cross'290 )291 print(f'Golden cross buy — {stock}, order_id={order_id}')292elif prev['ma5'] >= prev['ma20'] and latest['ma5'] < latest['ma20']:293 # 死叉信号:5日均线下穿20日均线,卖出294 order_id = xt_trader.order_stock(295 account, stock, xtconstant.STOCK_SELL, 100,296 xtconstant.LATEST_PRICE, 0, 'ma_cross', 'death_cross'297 )298 print(f'Death cross sell — {stock}, order_id={order_id}')299300# === 6. 查询结果 ===301asset = xt_trader.query_stock_asset(account)302print(f'Available cash: {asset.cash}, Total assets: {asset.total_asset}')303304positions = xt_trader.query_stock_positions(account)305for pos in positions:306 print(f'{pos.stock_code}: {pos.volume} shares, available={pos.can_use_volume}, cost={pos.open_price}')307```308309## 完整示例:实时行情监控310311```python312from xtquant import xtdata313import threading314315def on_tick(datas):316 """Tick数据回调函数"""317 for code, tick in datas.items():318 print(f'{code}: latest={tick["lastPrice"]}, volume={tick["volume"]}')319320# 连接行情数据服务321xtdata.connect()322323# 在单独线程中运行订阅(xtdata.run()会阻塞当前线程)324def run_data():325 xtdata.subscribe_quote('000001.SZ', period='tick', callback=on_tick)326 xtdata.subscribe_quote('600000.SH', period='tick', callback=on_tick)327 xtdata.run() # 阻塞线程,持续接收数据328329t = threading.Thread(target=run_data, daemon=True)330t.start()331332# 主线程可以执行交易或其他操作333# ...334```335336## 使用技巧337338- miniQMT **仅支持Windows** — 如果TCP可达,Python脚本可以在同一台或不同机器上运行。339- Python脚本运行期间,miniQMT必须保持**登录状态**。340- `connect()` 是**一次性连接** — 断开后不会自动重连,需要自行实现重连逻辑。341- `session_id` 对**每个策略必须唯一** — 不同Python脚本必须使用不同的session_id。342- 实时订阅时,`xtdata.run()` 会阻塞线程 — 请在**单独线程**中运行,主线程用于交易。343- 下载的数据会**本地缓存** — 后续读取速度极快。344- 在推送回调(`on_stock_order`等)中,使用**异步查询方法**(如 `query_stock_orders_async`)避免死锁。或启用 `set_relaxed_response_order_enabled(True)`。345- 部分券商提供miniQMT免费**Level 2数据** — 请咨询您的券商。346- 文档:http://dict.thinktrader.net/nativeApi/start_now.html347348---349350## 进阶示例351352### 网格交易策略353354```python355from xtquant import xtdata, xtconstant356from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback357from xtquant.xttype import StockAccount358import threading359360class GridCallback(XtQuantTraderCallback):361 def on_stock_trade(self, trade):362 print(f'Trade filled: {trade.stock_code} {trade.traded_volume}@{trade.traded_price}')363 def on_order_error(self, error):364 print(f'Error: {error.error_msg}')365366# 初始化交易367path = r'D:\券商QMT\userdata_mini'368xt_trader = XtQuantTrader(path, 100001)369xt_trader.register_callback(GridCallback())370xt_trader.start()371xt_trader.connect()372account = StockAccount('your_account')373xt_trader.subscribe(account)374375# 网格参数376stock = '000001.SZ'377grid_base = 11.0 # 基准价格378grid_step = 0.2 # 网格间距379grid_shares = 100 # 每格交易股数380grid_levels = 5 # 上下各5档381last_grid = 0 # 当前网格层级382383xtdata.connect()384385def on_tick(datas):386 global last_grid387 for code, tick in datas.items():388 price = tick['lastPrice']389 # 计算价格对应的当前网格层级390 current_grid = int((price - grid_base) / grid_step)391392 if current_grid < last_grid:393 # 价格下穿网格线,买入394 for _ in range(last_grid - current_grid):395 xt_trader.order_stock(396 account, code, xtconstant.STOCK_BUY, grid_shares,397 xtconstant.LATEST_PRICE, 0, 'grid', f'网格买入_level{current_grid}'398 )399 last_grid = current_grid400401 elif current_grid > last_grid:402 # 价格上穿网格线,卖出403 for _ in range(current_grid - last_grid):404 xt_trader.order_stock(405 account, code, xtconstant.STOCK_SELL, grid_shares,406 xtconstant.LATEST_PRICE, 0, 'grid', f'网格卖出_level{current_grid}'407 )408 last_grid = current_grid409410# 启动行情数据订阅411def run_data():412 xtdata.subscribe_quote(stock, period='tick', callback=on_tick)413 xtdata.run()414415t = threading.Thread(target=run_data, daemon=True)416t.start()417xt_trader.run_forever()418```419420### 可转债T+0日内交易421422```python423from xtquant import xtdata, xtconstant424from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback425from xtquant.xttype import StockAccount426import threading427428class CBCallback(XtQuantTraderCallback):429 def on_stock_trade(self, trade):430 print(f'Trade filled: {trade.stock_code} {trade.traded_volume}@{trade.traded_price}')431432path = r'D:\券商QMT\userdata_mini'433xt_trader = XtQuantTrader(path, 100002)434xt_trader.register_callback(CBCallback())435xt_trader.start()436xt_trader.connect()437account = StockAccount('your_account')438xt_trader.subscribe(account)439440# 可转债代码(可转债支持T+0交易)441cb_code = '113050.SH'442buy_threshold = -0.5 # 跌幅超过0.5%买入443sell_threshold = 0.5 # 涨幅超过0.5%卖出444position = 0445446xtdata.connect()447448def on_tick(datas):449 global position450 for code, tick in datas.items():451 price = tick['lastPrice']452 pre_close = tick['lastClose']453 if pre_close == 0:454 continue455 pct_change = (price - pre_close) / pre_close * 100456457 # 跌幅达到阈值,买入10手458 if pct_change <= buy_threshold and position == 0:459 xt_trader.order_stock(460 account, code, xtconstant.STOCK_BUY, 10,461 xtconstant.LATEST_PRICE, 0, 'cb_t0', '可转债T0买入'462 )463 position = 10464465 # 涨幅达到阈值,卖出466 elif pct_change >= sell_threshold and position > 0:467 xt_trader.order_stock(468 account, code, xtconstant.STOCK_SELL, position,469 xtconstant.LATEST_PRICE, 0, 'cb_t0', '可转债T0卖出'470 )471 position = 0472473def run_data():474 xtdata.subscribe_quote(cb_code, period='tick', callback=on_tick)475 xtdata.run()476477t = threading.Thread(target=run_data, daemon=True)478t.start()479xt_trader.run_forever()480```481482### 定时打新申购483484```python485from xtquant import xtdata, xtconstant486from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback487from xtquant.xttype import StockAccount488import datetime489import time490491class IPOCallback(XtQuantTraderCallback):492 def on_stock_order(self, order):493 print(f'IPO subscription: {order.stock_code} status={order.order_status} {order.status_msg}')494495path = r'D:\券商QMT\userdata_mini'496xt_trader = XtQuantTrader(path, 100003)497xt_trader.register_callback(IPOCallback())498xt_trader.start()499xt_trader.connect()500account = StockAccount('your_account')501xt_trader.subscribe(account)502503# 查询新股申购额度504limits = xt_trader.query_new_purchase_limit(account)505print(f"Subscription quota: {limits}")506507# 查询今日新股数据508ipo_data = xt_trader.query_ipo_data()509if ipo_data:510 for code, info in ipo_data.items():511 print(f"New stock: {code} {info['name']} issue price={info['issuePrice']} max subscription={info['maxPurchaseNum']}")512 # 以最大允许量申购513 max_vol = info['maxPurchaseNum']514 if max_vol > 0:515 order_id = xt_trader.order_stock(516 account, code, xtconstant.STOCK_BUY, max_vol,517 xtconstant.FIX_PRICE, info['issuePrice'], 'ipo', '新股申购'518 )519 print(f" Subscription submitted: order_id={order_id}")520else:521 print("今日无新股可申购")522```523524---525526---527528## 🤖 AI Agent 高阶使用指南529530对于 AI Agent,在使用该量化/数据工具时应遵循以下高阶策略和最佳实践,以确保任务的高效完成:531532### 1. 数据校验与错误处理533在获取数据或执行操作后,AI 应当主动检查返回的结果格式是否符合预期,以及是否存在缺失值(NaN)或空数据。534* **示例策略**:在通过 API 获取数据框(DataFrame)后,使用 `if df.empty:` 进行校验;捕获 `Exception` 以防网络或接口错误导致进程崩溃。535536### 2. 多步组合分析537AI 经常需要进行宏观经济分析或跨市场对比。应善于将当前接口与其他数据源或工具组合使用。538* **示例策略**:先获取板块或指数的宏观数据,再筛选成分股,最后对具体标的进行深入的财务或技术面分析,形成完整的决策链条。539540### 3. 构建动态监控与日志541对于交易和策略类任务,AI 可以定期拉取数据并建立监控机制。542* **示例策略**:使用循环或定时任务检查特定标的的异动(如涨跌停、放量),并在发现满足条件的信号时输出结构化日志或触发预警。543544---545546## 社区与支持547548由 **大佬量化** 维护 — 量化交易教学与策略研发团队。549550微信客服: **bossquant1** · [Bilibili](https://space.bilibili.com/48693330) · 搜索 **大佬量化** — 微信公众号 / Bilibili / 抖音