QMT Python API
枚举常量
操作类型 - opType
操作类型,用于下单函数 passorder 的第一个参数,指定买卖方向与开平仓动作。
股票/ETF/可转债买卖
| 数值 | 描述 |
|---|---|
| 23 | 股票/ETF/可转债买入,或沪港通、深港通股票买入 |
| 24 | 股票/ETF/可转债卖出,或沪港通、深港通股票卖出 |
融资融券
| 数值 | 描述 |
|---|---|
| 27 | 融资买入 |
| 28 | 融券卖出 |
| 29 | 买券还券 |
| 30 | 直接还券 |
| 31 | 卖券还款 |
| 32 | 直接还款 |
| 33 | 担保品买入 |
| 34 | 担保品卖出 |
期货/股指期权/商品期权 - 六键
| 数值 | 描述 |
|---|---|
| 0 | 开多 |
| 1 | 平昨多 |
| 2 | 平今多 |
| 3 | 开空 |
| 4 | 平昨空 |
| 5 | 平今空 |
期货/股指期权/商品期权 - 四键
| 数值 | 描述 |
|---|---|
| 6 | 平多,优先平今 |
| 7 | 平多,优先平昨 |
| 8 | 平空,优先平今 |
| 9 | 平空,优先平昨 |
期货/股指期权/商品期权 - 两键
| 数值 | 描述 |
|---|---|
| 10 | 卖出,如有多仓,优先平仓,优先平今,如有余量,再开空 |
| 11 | 卖出,如有多仓,优先平仓,优先平昨,如有余量,再开空 |
| 12 | 买入,如有空仓,优先平仓,优先平今,如有余量,再开多 |
| 13 | 买入,如有空仓,优先平仓,优先平昨,如有余量,再开多 |
| 14 | 买入,不优先平仓 |
| 15 | 卖出,不优先平仓 |
组合交易
| 数值 | 描述 |
|---|---|
| 25 | 组合买入,或沪港通、深港通的组合买入 |
| 26 | 组合卖出,或沪港通、深港通的组合卖出 |
| 35 | 普通账号一键买卖 |
| 36 | 信用账号一键买卖 |
| 40 | 期货组合开多 |
| 43 | 期货组合开空 |
| 46 | 期货组合平多,优先平今 |
| 47 | 期货组合平多,优先平昨 |
| 48 | 期货组合平空,优先平今 |
| 49 | 期货组合平空,优先平昨 |
ETF期权交易
| 数值 | 描述 |
|---|---|
| 50 | 买入开仓 |
| 51 | 卖出平仓 |
| 52 | 卖出开仓 |
| 53 | 买入平仓 |
| 54 | 备兑开仓 |
| 55 | 备兑平仓 |
| 56 | 认购行权 |
| 57 | 认沽行权 |
| 58 | 证券锁定 |
| 59 | 证券解锁 |
ETF申赎交易
| 数值 | 描述 |
|---|---|
| 60 | 申购 |
| 61 | 赎回 |
专项两融
| 数值 | 描述 |
|---|---|
| 70 | 专项融资买入 |
| 71 | 专项融券卖出 |
| 72 | 专项买券还券 |
| 73 | 专项直接还券 |
| 74 | 专项卖券还款 |
| 75 | 专项直接还款 |
可转债转股/回售
| 数值 | 描述 |
|---|---|
| 80 | 普通账户转股 |
| 81 | 普通账户回售 |
| 82 | 信用账户转股 |
| 83 | 信用账户回售 |
提示
以上为常用 opType 值。完整操作类型枚举(含全国股转、固收业务、场外基金等)参见 innerApi 的 enum_EOperationType 章节。
下单方式 - orderType
下单方式,用于 passorder 的第二个参数,决定按数量、金额还是比例下单。
提示
一、期货不支持 1102 和 1202。
二、对所有账号组的操作相当于对账号组里的每个账号做一样的操作,如:
passorder(23, 1202, 'testS', '000001.SZ', 5, -1, 50000, ContextInfo),意思就是对账号组testS里的所有账号都以最新价开仓买入 50000 元市值的000001.SZ平安银行;passorder(60, 1101, "test", '510050.SH', 5, -1, 1, ContextInfo)意思就是账号test申购 1 个单位(900000 股)的华夏上证50ETF(只申购不买入成分股)。
单股交易(单账号)
| 数值 | 描述 |
|---|---|
| 1101 | 单股、单账号、普通、股/手方式下单 |
| 1102 | 单股、单账号、普通、金额(元)方式下单(只支持股票) |
| 1113 | 单股、单账号、总资产、比例 [0~1] 方式下单 |
| 1123 | 单股、单账号、可用、比例 [0~1] 方式下单 |
单股交易(账号组)
| 数值 | 描述 |
|---|---|
| 1201 | 单股、账号组(无权重)、普通、股/手方式下单 |
| 1202 | 单股、账号组(无权重)、普通、金额(元)方式下单(只支持股票) |
| 1213 | 单股、账号组(无权重)、总资产、比例 [0~1] 方式下单 |
| 1223 | 单股、账号组(无权重)、可用、比例 [0~1] 方式下单 |
组合交易(单账号)
| 数值 | 描述 |
|---|---|
| 2101 | 组合、单账号、普通、按组合股票数量(篮子中股票设定的数量)方式下单,对应 volume 的单位为篮子的份 |
| 2102 | 组合、单账号、普通、按组合股票权重(篮子中股票设定的权重)方式下单,对应 volume 的单位为元 |
| 2103 | 组合、单账号、普通、按账号可用方式下单(按可用资金比例后按篮子中股票权重分配,如用户没填权重则按相等权重分配),只对股票篮子支持 |
组合交易(账号组)
| 数值 | 描述 |
|---|---|
| 2201 | 组合、账号组(无权重)、普通、按组合股票数量方式下单 |
| 2202 | 组合、账号组(无权重)、普通、按组合股票权重方式下单 |
| 2203 | 组合、账号组(无权重)、普通、按账号可用方式下单,只对股票篮子支持 |
框架简化版
xtquant.cloud 框架将 QMT 原生 orderType 简化为以下取值:
| 数值 | 描述 |
|---|---|
| 0 | 按数量(股/手) |
| 1 | 按金额(元) |
| 2 | 按可用资金比例 [0~1] |
| 3 | 按总资产比例 [0~1] |
提示
QMT 原生 orderType 使用 1101/1102/1113/1123 等编码,xtquant.cloud 框架已简化为 0/1/2/3。
下单选价类型 - prType
下单选价类型,用于 passorder 的第五个参数,决定委托的报价方式。
关于使用市价指令的说明
对于上交所(42, 43, 44, 45)
- 当
prType选择市价类型时,price为保护限价,范围为(0-9999)表示投资者能够接受的最高买入价或最低卖出价,即买入申报的成交价格和转限价的价格不高于保护限价,卖出申报的成交价格和转限价的价格不低于保护限价,当price指定为 0 时,保护限价为对应的涨跌停价 - 融券卖出不允许使用市价指令
- 集合竞价阶段不允许使用市价指令
- 当
对于深交所(44, 45, 46, 47, 48)
- 市价申报只适用于有价格涨跌幅限制证券
- 集合竞价阶段不允许使用市价指令
对于北交所(42, 43, 44, 45)
- 当
prType选择市价类型时,price为保护限价,范围为(0-9999)表示投资者能够接受的最高买入价或最低卖出价,即买入申报的成交价格和转限价的价格不高于保护限价,卖出申报的成交价格和转限价的价格不低于保护限价,当price指定为 0 时,保护限价为对应的涨跌停价 - 融券卖出不允许使用市价指令
- 集合竞价阶段不允许使用市价指令
- 当
| 数值 | 描述 |
|---|---|
| -1 | 无效(只对于 algo_passorder 起作用) |
| 0 | 卖5价 |
| 1 | 卖4价 |
| 2 | 卖3价 |
| 3 | 卖2价 |
| 4 | 卖1价 |
| 5 | 最新价 |
| 6 | 买1价 |
| 7 | 买2价(组合不支持) |
| 8 | 买3价(组合不支持) |
| 9 | 买4价(组合不支持) |
| 10 | 买5价(组合不支持) |
| 11 | 指定价(只对单股情况支持,对组合交易不支持) |
| 12 | 涨跌停价(对手方最远端价格) |
| 13 | 挂单价(本方一档价格) |
| 14 | 对手价(对方一档价格) |
| 18 | 市价最优价 [郑商所][期货](不支持模拟交易中使用) |
| 19 | 市价即成剩撤 [大商所][期货](不支持模拟交易中使用) |
| 20 | 市价全额成交或撤 [大商所][期货](不支持模拟交易中使用) |
| 21 | 市价最优一档即成剩撤 [中金所][期货](不支持模拟交易中使用) |
| 22 | 市价最优五档即成剩撤 [中金所][期货](不支持模拟交易中使用) |
| 23 | 市价最优一档即成剩转 [中金所][期货](不支持模拟交易中使用) |
| 24 | 市价最优五档即成剩转 [中金所][期货](不支持模拟交易中使用) |
| 26 | 限价即时全部成交否则撤单 [上交所][期权] [深交所][期权](不支持模拟交易中使用) |
| 27 | 市价即成剩撤 [上交所][期权](不支持模拟交易中使用) |
| 28 | 市价即全成否则撤 [上交所][期权](不支持模拟交易中使用) |
| 29 | 市价剩转限价 [上交所][期权](不支持模拟交易中使用) |
| 42 | 最优五档即时成交剩余撤销申报 [上交所][股票] [北交所][股票](不支持模拟交易中使用) |
| 43 | 最优五档即时成交剩转限价申报 [上交所][股票] [北交所][股票](不支持模拟交易中使用) |
| 44 | 对手方最优价格委托 [上交所][股票] [深交所][股票] [北交所][股票] [期权](不支持模拟交易中使用) |
| 45 | 本方最优价格委托 [上交所][股票] [深交所][股票] [北交所][股票] [期权](不支持模拟交易中使用) |
| 46 | 即时成交剩余撤销委托 [深交所][股票] [期权](不支持模拟交易中使用) |
| 47 | 最优五档即时成交剩余撤销委托 [深交所][股票] [期权](不支持模拟交易中使用) |
| 48 | 全额成交或撤销委托 [深交所][股票] [期权](不支持模拟交易中使用) |
| 49 | 盘后定价 |
prType 快速参考
- 0~4:卖5价到卖1价(通用)
- 5:最新价(通用)
- 6~10:买1价到买5价(通用)
- 11:指定价(仅单股)
- 12:涨跌停价(通用)
- 13:挂单价(通用)
- 14:对手价(通用)
- 18~24:期货市价类型(郑商所/大商所/中金所)
- 26~29:期权市价类型(上交所/深交所)
- 42~49:股票/期权市价类型(上交所/深交所/北交所)
快速交易 - quickTrade
快速交易参数,用于 passorder,控制下单的触发时机。
| 数值 | 描述 |
|---|---|
| 0 | 逐 bar 模式,bar 结束时发出信号 |
| 1 | 立即执行(仅实时数据驱动生效) |
| 2 | 立即执行(实时和历史都生效) |
提示
passorder 是对最后一根 K 线完全走完后生成的模型信号在下一根 K 线的第一个 tick 数据来时触发下单交易。
采用 quickTrade 参数设置为 1 时,非历史 bar 上执行时(ContextInfo.is_last_bar() 为 True),只要策略模型中调用到就触发下单交易。
quickTrade 参数设置为 2 时,不判断 bar 状态,只要策略模型中调用到就触发下单交易,历史 bar 上也能触发下单,请谨慎使用。
选价类型 - style
便捷下单函数(如 order_shares、order_lots、order_value 等)的 style 参数,用于指定报价方式,与 prType 一一对应。
| style | prType | 描述 |
|---|---|---|
LATEST | 5 | 最新价(默认) |
FIX | 11 | 指定价 |
MARKET | 12 | 涨跌停价 |
HANG | 13 | 挂单价 |
COMPETE | 14 | 对手价 |
SALE1 | 4 | 卖1价 |
SALE2 | 3 | 卖2价 |
SALE3 | 2 | 卖3价 |
SALE4 | 1 | 卖4价 |
SALE5 | 0 | 卖5价 |
BUY1 | 6 | 买1价 |
BUY2 | 7 | 买2价 |
BUY3 | 8 | 买3价 |
BUY4 | 9 | 买4价 |
BUY5 | 10 | 买5价 |
# 最新价买 100 股order_shares('000002.SZ', 100, C=C) # 对手价卖 100 股order_shares('000002.SZ', -100, 'COMPETE', C=C) # 指定价 37.5 买 200 股order_shares('000002.SZ', 200, 'fix', 37.5, C=C)周期对照表 - period
K 线周期参数,用于行情数据获取、订阅等函数的 period 参数。
| 参数值 | 说明 |
|---|---|
tick | 分笔 |
1m | 1 分钟线 |
5m | 5 分钟线 |
15m | 15 分钟线 |
30m | 30 分钟线 |
1h | 1 小时线 |
2h | 2 小时线 |
4h | 4 小时线 |
1d | 日线 |
1w | 周线 |
1mon | 月线 |
1q | 季线 |
1hy | 半年线 |
1y | 年线 |
复权方式 - dividend_type
复权方式参数,用于行情数据获取函数的 dividend_type 参数。
| 参数值 | 说明 |
|---|---|
none | 不复权 |
front | 前复权 |
back | 后复权 |
front_ratio | 等比前复权 |
back_ratio | 等比后复权 |
follow | 跟随主图 |
提示
dividend_type 设置为 follow 时表示跟随主图(即 ContextInfo 中设定的复权方式),在 get_market_data_ex 等函数中为默认值。