﻿XtQuant.Xttrade 交易模块 | 迅投知识库 
 迅投知识库 
 首页 
 API API 
 投研新手教程 
 QMT新手教程 
 内置Python 
 XtQuant文档 
 VBA 
 数据字典 数据字典 
 快速开始 
 股票数据 
 行业概念数据 
 指数数据 
 期货数据 
 期权数据 
 场内基金数据 
 债券数据 
 常见问题 
 场景化示例 
 迅投因子 
 数据浏览器 
 策略迁移 策略迁移 
 聚宽策略 
 客服QQ: 810315303 
 联系方式: 18309226715 
 视频教程 视频教程 
 投研端教程 
 迅投学堂 
 在新窗口打开 
 投研平台 
 在新窗口打开 
 迅投社区 
 在新窗口打开 
 迅投官网 
 在新窗口打开 
 注册 
 登录 
 智能助手加载中... 
 首页 
 API API 
 投研新手教程 
 QMT新手教程 
 内置Python 
 XtQuant文档 
 VBA 
 数据字典 数据字典 
 快速开始 
 股票数据 
 行业概念数据 
 指数数据 
 期货数据 
 期权数据 
 场内基金数据 
 债券数据 
 常见问题 
 场景化示例 
 迅投因子 
 数据浏览器 
 策略迁移 策略迁移 
 聚宽策略 
 客服QQ: 810315303 
 联系方式: 18309226715 
 视频教程 视频教程 
 投研端教程 
 迅投学堂 
 在新窗口打开 
 投研平台 
 在新窗口打开 
 迅投社区 
 在新窗口打开 
 迅投官网 
 在新窗口打开 
xtquant文档 
 快速开始 
 XtQuant.XtData 行情模块 
 XtQuant.Xttrade 交易模块 
 版本信息 
 快速入门 
 创建策略 
 XtQuant运行逻辑 
 XtQuant数据字典 
 交易市场(market) 
 账号类型(account_type) 
 委托类型(order_type) 
 报价类型(price_type) 
 委托状态(order_status) 
 账号状态(account_status) 
 划拨方向(transfer_direction) 
 多空方向(direction) 
 交易操作(offset_flag) 
 XtQuant数据结构说明 
 资产XtAsset 
 委托XtOrder 
 成交XtTrade 
 持仓XtPosition 
 期货持仓统计XtPositionStatistics 
 异步下单委托反馈XtOrderResponse 
 异步撤单委托反馈XtCancelOrderResponse 
 下单失败错误XtOrderError 
 撤单失败错误XtCancelError 
 信用账号资产XtCreditDetail 
 负债合约StkCompacts 
 融资融券标的CreditSubjects 
 融券状态说明 
 可融券数据CreditSloCode 
 标的担保品CreditAssure 
 账号状态XtAccountStatus 
 账号信息XtAccountInfo 
 约券相关异步接口的反馈XtSmtAppointmentResponse 
 XtQuant API说明 
 系统设置接口 
 创建API实例 
 注册回调类 
 准备API环境 
 创建连接 
 停止运行 
 阻塞当前线程进入等待状态 
 开启主动请求接口的专用线程 
 操作接口 
 订阅账号信息 
 反订阅账号信息 
 股票同步报单 
 股票异步报单 
 股票同步撤单 
 股票同步撤单 
 股票异步撤单 
 股票异步撤单 
 资金划拨 
 外部交易数据录入 
 股票查询接口 
 资产查询 
 委托查询 
 成交查询 
 持仓查询 
 期货持仓统计查询 
 信用查询接口 
 信用资产查询 
 负债合约查询 
 融资融券标的查询 
 可融券数据查询 
 标的担保品查询 
 其他查询接口 
 新股申购额度查询 
 当日新股信息查询 
 账号信息查询 
 账号状态查询 
 普通柜台资金查询 
 普通柜台持仓查询 
 通用数据导出 
 通用数据查询 
 约券相关接口 
 券源行情查询 
 库存券约券申请 
 约券合约查询 
 回调类 
 连接状态回调 
 账号状态信息推送 
 委托信息推送 
 成交信息推送 
 下单失败信息推送 
 撤单失败信息推送 
 异步下单回报推送 
 约券相关异步接口的回报推送 
 完整实例 
 常见问题 
 xtquant版本下载 
 # XtQuant.Xttrade 交易模块
 # 版本信息
2020-09-01
初稿
2020-10-14
持仓结构添加字段
投资备注相关修正
2020-10-21
添加信用交易相关委托类型（order_type）枚举
调整XtQuant运行依赖环境说明，更新多版本支持相关说明
2020-11-13
添加信用交易相关类型定义说明
添加信用交易相关接口说明
添加异步撤单委托反馈结构说明
添加下单失败和撤单失败主推结构说明
添加订阅和反订阅接口
添加创建API实例，注册回调类，准备API环境，创建连接，停止运行，阻塞进程接口说明
调整API接口说明 
将接口细分为"系统设置接口"，“操作接口”，“查询接口”，"信用相关查询接口"，“回调类”等五类
接口返回“None”修改为“无”
去掉回调类接口中的示例
添加“备注”项
所有“证券账号”改为“资金账号”
英文“,”调整为中文“，”
示例代码中增加XtQuant API实例对象，修正没有实例，直接调用的错误
添加股票异步撤单接口说明，将原股票撤单修改为股票同步撤单
2020-11-19
添加账号状态主推接口
添加账号状态数据结构说明
添加账号状态枚举值
回调类接口说明调整 
将回调函数定义及函数说明标题调整一致
补充异步下单回报推送、异步撤单回报推送接口说明
2021-07-20
修改回调/主推函数实现机制，提升报撤单回报的速度，降低穿透延时波动
 XtQuantTrader.run_forever() 修改实现，支持 Ctrl+C 跳出
2022-06-27
委托查询支持仅查询可撤委托
添加新股申购相关接口 
 query_new_purchase_limit 查询新股申购额度
 query_ipo_data 查询新股信息
添加账号信息查询接口 
 query_account_infos 
2022-11-15
修复 XtQuantTrader.unsubscribe 的实现
2022-11-17
交易数据字典格式调整
2022-11-28
为主动请求接口的返回增加专用线程以及相关控制，以支持在on_stock_order等推送接口中调用同步请求 
 XtQuantTrader.set_relaxed_response_order_enabled 
2023-07-17
持仓结构 XtPosition 成本价字段调整 
 open_price - 开仓价
 avg_price - 成本价
2023-07-26
添加资金划拨接口 fund_transfer 
2023-08-11
添加划拨业务查询普通柜台资金接口 query_com_fund 
添加划拨业务查询普通柜台持仓接口 query_com_position 
2023-10-16
添加期货市价的报价类型 
 xtconstant.MARKET_BEST - 市价最优价[郑商所]
 xtconstant.MARKET_CANCEL - 市价即成剩撤[大商所]
 xtconstant.MARKET_CANCEL_ALL - 市价全额成交或撤[大商所]
 xtconstant.MARKET_CANCEL_1 - 市价最优一档即成剩撤[中金所]
 xtconstant.MARKET_CANCEL_5 - 市价最优五档即成剩撤[中金所]
 xtconstant.MARKET_CONVERT_1 - 市价最优一档即成剩转[中金所]
 xtconstant.MARKET_CONVERT_5 - 市价最优五档即成剩转[中金所]
2023-10-20
委托结构 XtOrder ，成交结构 XtTrade ，持仓结构 XtPosition 新增多空字段
 direction - 多空，股票不需要
委托结构 XtOrder ，成交结构 XtTrade 新增交易操作字段
 offset_flag - 交易操作，用此字段区分股票买卖，期货开、平仓，期权买卖等
2023-11-03
添加券源行情查询接口 smt_query_quoter 
添加库存券约券申请接口 smt_negotiate_order 
添加约券合约查询接口 smt_query_compact 
2024-01-02
委托类型增加ETF申赎
2024-02-29
添加期货持仓统计查询接口 query_position_statistics 
2024-04-25
数据结构添加 stock_code1 字段以适配长代码
2024-05-24
添加通用数据导出接口export_data
添加通用数据查询接口query_data
2024-06-27
添加外部成交导入接口sync_transaction_from_external
 # 快速入门
 # 创建策略
 #coding=utf-8 
 from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback 
 from xtquant.xttype import StockAccount 
 from xtquant import xtconstant 
 class MyXtQuantTraderCallback ( XtQuantTraderCallback ): 
 def on_disconnected ( self ): 
 """ 
 连接断开 
 :return: 
 """ 
 print ( " connection lost " ) 
 def on_stock_order ( self , order ): 
 """ 
 委托回报推送 
 :param order: XtOrder对象 
 :return: 
 """ 
 print ( " on order callback: " ) 
 print (order.stock_code, order.order_status, order.order_sysid) 
 def on_stock_trade ( self , trade ): 
 """ 
 成交变动推送 
 :param trade: XtTrade对象 
 :return: 
 """ 
 print ( " on trade callback " ) 
 print (trade.account_id, trade.stock_code, trade.order_id) 
 def on_order_error ( self , order_error ): 
 """ 
 委托失败推送 
 :param order_error:XtOrderError 对象 
 :return: 
 """ 
 print ( " on order_error callback " ) 
 print (order_error.order_id, order_error.error_id, order_error.error_msg) 
 def on_cancel_error ( self , cancel_error ): 
 """ 
 撤单失败推送 
 :param cancel_error: XtCancelError 对象 
 :return: 
 """ 
 print ( " on cancel_error callback " ) 
 print (cancel_error.order_id, cancel_error.error_id, cancel_error.error_msg) 
 def on_order_stock_async_response ( self , response ): 
 """ 
 异步下单回报推送 
 :param response: XtOrderResponse 对象 
 :return: 
 """ 
 print ( " on_order_stock_async_response " ) 
 print (response.account_id, response.order_id, response.seq) 
 def on_account_status ( self , status ): 
 """ 
 :param response: XtAccountStatus 对象 
 :return: 
 """ 
 print ( " on_account_status " ) 
 print (status.account_id, status.account_type, status.status) 
 if __name__ == " __main__ " : 
 print ( " demo test " ) 
 # path为mini qmt客户端安装目录下userdata_mini路径 
 path = ' D: \\ 迅投极速交易终端 睿智融科版 \\ userdata_mini ' 
 # session_id为会话编号，策略使用方对于不同的Python策略需要使用不同的会话编号 
 session_id = 123456 
 xt_trader = XtQuantTrader(path, session_id) 
 # 创建资金账号为1000000365的证券账号对象 
 acc = StockAccount( ' 1000000365 ' ) 
 # StockAccount可以用第二个参数指定账号类型，如沪港通传'HUGANGTONG'，深港通传'SHENGANGTONG' 
 # acc = StockAccount('1000000365','STOCK') 
 # 创建交易回调类对象，并声明接收回调 
 callback = MyXtQuantTraderCallback() 
 xt_trader.register_callback(callback) 
 # 启动交易线程 
 xt_trader.start() 
 # 建立交易连接，返回0表示连接成功 
 connect_result = xt_trader.connect() 
 print (connect_result) 
 # 对交易回调进行订阅，订阅后可以收到交易主推，返回0表示订阅成功 
 subscribe_result = xt_trader.subscribe(acc) 
 print (subscribe_result) 
 stock_code = ' 600000.SH ' 
 # 使用指定价下单，接口返回订单编号，后续可以用于撤单操作以及查询委托状态 
 print ( " order using the fix price: " ) 
 fix_result_order_id = xt_trader.order_stock(acc, stock_code, xtconstant. STOCK_BUY , 200 , xtconstant. FIX_PRICE , 10.5 , ' strategy_name ' , ' remark ' ) 
 print (fix_result_order_id) 
 # 使用订单编号撤单 
 print ( " cancel order: " ) 
 cancel_order_result = xt_trader.cancel_order_stock(acc, fix_result_order_id) 
 print (cancel_order_result) 
 # 使用异步下单接口，接口返回下单请求序号seq，seq可以和on_order_stock_async_response的委托反馈response对应起来 
 print ( " order using async api: " ) 
 async_seq = xt_trader.order_stock_async(acc, stock_code, xtconstant. STOCK_BUY , 200 , xtconstant. FIX_PRICE , 10.5 , ' strategy_name ' , ' remark ' ) 
 print (async_seq) 
 # 查询证券资产 
 print ( " query asset: " ) 
 asset = xt_trader.query_stock_asset(acc) 
 if asset: 
 print ( " asset: " ) 
 print ( " cash {0} " .format(asset.cash)) 
 # 根据订单编号查询委托 
 print ( " query order: " ) 
 order = xt_trader.query_stock_order(acc, fix_result_order_id) 
 if order: 
 print ( " order: " ) 
 print ( " order {0} " .format(order.order_id)) 
 # 查询当日所有的委托 
 print ( " query orders: " ) 
 orders = xt_trader.query_stock_orders(acc) 
 print ( " orders: " , len (orders)) 
 if len (orders) != 0 : 
 print ( " last order: " ) 
 print ( " {0} {1} {2} " .format(orders[ - 1 ].stock_code, orders[ - 1 ].order_volume, orders[ - 1 ].price)) 
 # 查询当日所有的成交 
 print ( " query trade: " ) 
 trades = xt_trader.query_stock_trades(acc) 
 print ( " trades: " , len (trades)) 
 if len (trades) != 0 : 
 print ( " last trade: " ) 
 print ( " {0} {1} {2} " .format(trades[ - 1 ].stock_code, trades[ - 1 ].traded_volume, trades[ - 1 ].traded_price)) 
 # 查询当日所有的持仓 
 print ( " query positions: " ) 
 positions = xt_trader.query_stock_positions(acc) 
 print ( " positions: " , len (positions)) 
 if len (positions) != 0 : 
 print ( " last position: " ) 
 print ( " {0} {1} {2} " .format(positions[ - 1 ].account_id, positions[ - 1 ].stock_code, positions[ - 1 ].volume)) 
 # 根据股票代码查询对应持仓 
 print ( " query position: " ) 
 position = xt_trader.query_stock_position(acc, stock_code) 
 if position: 
 print ( " position: " ) 
 print ( " {0} {1} {2} " .format(position.account_id, position.stock_code, position.volume)) 
 # 阻塞线程，接收交易推送 
 xt_trader.run_forever() 
 # 进阶篇
 # XtQuant运行逻辑
XtQuant封装了策略交易所需要的Python API接口，可以和MiniQMT客户端交互进行报单、撤单、查询资产、查询委托、查询成交、查询持仓以及收到资金、委托、成交和持仓等变动的主推消息。
 # XtQuant数据字典
 # 交易市场(market)
上交所 - xtconstant.SH_MARKET 
深交所 - xtconstant.SZ_MARKET 
北交所 - xtconstant.MARKET_ENUM_BEIJING 
沪港通 - xtconstant.MARKET_ENUM_SHANGHAI_HONGKONG_STOCK 
深港通 - xtconstant.MARKET_ENUM_SHENZHEN_HONGKONG_STOCK 
上期所 - xtconstant.MARKET_ENUM_SHANGHAI_FUTURE 
大商所 - xtconstant.MARKET_ENUM_DALIANG_FUTURE 
郑商所 - xtconstant.MARKET_ENUM_ZHENGZHOU_FUTURE 
中金所 - xtconstant.MARKET_ENUM_INDEX_FUTURE 
能源中心 - xtconstant.MARKET_ENUM_INTL_ENERGY_FUTURE 
广期所 - xtconstant.MARKET_ENUM_GUANGZHOU_FUTURE 
上海期权 - xtconstant.MARKET_ENUM_SHANGHAI_STOCK_OPTION 
深证期权 - xtconstant.MARKET_ENUM_SHENZHEN_STOCK_OPTION 
 # 账号类型(account_type)
期货 - xtconstant.FUTURE_ACCOUNT 
股票 - xtconstant.SECURITY_ACCOUNT 
信用 - xtconstant.CREDIT_ACCOUNT 
期货期权 - xtconstant.FUTURE_OPTION_ACCOUNT 
股票期权 - xtconstant.STOCK_OPTION_ACCOUNT 
沪港通 - xtconstant.HUGANGTONG_ACCOUNT 
深港通 - xtconstant.SHENGANGTONG_ACCOUNT 
 # 委托类型(order_type)
股票
买入 - xtconstant.STOCK_BUY 
卖出 - xtconstant.STOCK_SELL 
信用
担保品买入 - xtconstant.CREDIT_BUY 
担保品卖出 - xtconstant.CREDIT_SELL 
融资买入 - xtconstant.CREDIT_FIN_BUY 
融券卖出 - xtconstant.CREDIT_SLO_SELL 
买券还券 - xtconstant.CREDIT_BUY_SECU_REPAY 
直接还券 - xtconstant.CREDIT_DIRECT_SECU_REPAY 
卖券还款 - xtconstant.CREDIT_SELL_SECU_REPAY 
直接还款 - xtconstant.CREDIT_DIRECT_CASH_REPAY 
专项融资买入 - xtconstant.CREDIT_FIN_BUY_SPECIAL 
专项融券卖出 - xtconstant.CREDIT_SLO_SELL_SPECIAL 
专项买券还券 - xtconstant.CREDIT_BUY_SECU_REPAY_SPECIAL 
专项直接还券 - xtconstant.CREDIT_DIRECT_SECU_REPAY_SPECIAL 
专项卖券还款 - xtconstant.CREDIT_SELL_SECU_REPAY_SPECIAL 
专项直接还款 - xtconstant.CREDIT_DIRECT_CASH_REPAY_SPECIAL 
期货六键风格
开多 - xtconstant.FUTURE_OPEN_LONG 
平昨多 - xtconstant.FUTURE_CLOSE_LONG_HISTORY 
平今多 - xtconstant.FUTURE_CLOSE_LONG_TODAY 
开空 - xtconstant.FUTURE_OPEN_SHORT 
平昨空 - xtconstant.FUTURE_CLOSE_SHORT_HISTORY 
平今空 - xtconstant.FUTURE_CLOSE_SHORT_TODAY 
期货四键风格
平多，优先平今 - xtconstant.FUTURE_CLOSE_LONG_TODAY_FIRST 
平多，优先平昨 - xtconstant.FUTURE_CLOSE_LONG_HISTORY_FIRST 
平空，优先平今 - xtconstant.FUTURE_CLOSE_SHORT_TODAY_FIRST 
平空，优先平昨 - xtconstant.FUTURE_CLOSE_SHORT_HISTORY_FIRST 
期货两键风格
卖出，如有多仓，优先平仓，优先平今，如有余量，再开空 - xtconstant.FUTURE_CLOSE_LONG_TODAY_HISTORY_THEN_OPEN_SHORT 
卖出，如有多仓，优先平仓，优先平昨，如有余量，再开空 - xtconstant.FUTURE_CLOSE_LONG_HISTORY_TODAY_THEN_OPEN_SHORT 
买入，如有空仓，优先平仓，优先平今，如有余量，再开多 - xtconstant.FUTURE_CLOSE_SHORT_TODAY_HISTORY_THEN_OPEN_LONG 
买入，如有空仓，优先平仓，优先平昨，如有余量，再开多 - xtconstant.FUTURE_CLOSE_SHORT_HISTORY_TODAY_THEN_OPEN_LONG 
买入，不优先平仓 - xtconstant.FUTURE_OPEN 
卖出，不优先平仓 - xtconstant.FUTURE_CLOSE 
期货 - 跨商品套利
开仓 - xtconstant.FUTURE_ARBITRAGE_OPEN 
平, 优先平昨 - xtconstant.FUTURE_ARBITRAGE_CLOSE_HISTORY_FIRST 
平, 优先平今 - xtconstant.FUTURE_ARBITRAGE_CLOSE_TODAY_FIRST 
期货展期
看多, 优先平昨 - xtconstant.FUTURE_RENEW_LONG_CLOSE_HISTORY_FIRST 
看多，优先平今 - xtconstant.FUTURE_RENEW_LONG_CLOSE_TODAY_FIRST 
看空，优先平昨 - xtconstant.FUTURE_RENEW_SHORT_CLOSE_HISTORY_FIRST 
看空，优先平今 - xtconstant.FUTURE_RENEW_SHORT_CLOSE_TODAY_FIRST 
股票期权
买入开仓，以下用于个股期权交易业务 - xtconstant.STOCK_OPTION_BUY_OPEN 
卖出平仓 - xtconstant.STOCK_OPTION_SELL_CLOSE 
卖出开仓 - xtconstant.STOCK_OPTION_SELL_OPEN 
买入平仓 - xtconstant.STOCK_OPTION_BUY_CLOSE 
备兑开仓 - xtconstant.STOCK_OPTION_COVERED_OPEN 
备兑平仓 - xtconstant.STOCK_OPTION_COVERED_CLOSE 
认购行权 - xtconstant.STOCK_OPTION_CALL_EXERCISE 
认沽行权 - xtconstant.STOCK_OPTION_PUT_EXERCISE 
证券锁定 - xtconstant.STOCK_OPTION_SECU_LOCK 
证券解锁 - xtconstant.STOCK_OPTION_SECU_UNLOCK 
期货期权
期货期权行权 - xtconstant.OPTION_FUTURE_OPTION_EXERCISE 
ETF申赎
申购 - xtconstant.ETF_PURCHASE 
赎回 - xtconstant.ETF_REDEMPTION 
 # 报价类型(price_type)
提示
市价类型只在实盘环境中生效，模拟环境不支持市价方式报单
最新价 - xtconstant.LATEST_PRICE 
指定价 - xtconstant.FIX_PRICE 
郑商所 期货 
市价最优价 - xtconstant.MARKET_BEST 
大商所 期货 
市价即成剩撤 - xtconstant.MARKET_CANCEL 
市价全额成交或撤 - xtconstant.MARKET_CANCEL_ALL 
中金所 期货 
市价最优一档即成剩撤 - xtconstant.MARKET_CANCEL_1 
市价最优五档即成剩撤 - xtconstant.MARKET_CANCEL_5 
市价最优一档即成剩转 - xtconstant.MARKET_CONVERT_1 
市价最优五档即成剩转 - xtconstant.MARKET_CONVERT_5 
上交所/北交所 股票 
最优五档即时成交剩余撤销 - xtconstant.MARKET_SH_CONVERT_5_CANCEL 
最优五档即时成交剩转限价 - xtconstant.MARKET_SH_CONVERT_5_LIMIT 
对手方最优价格委托 - xtconstant.MARKET_PEER_PRICE_FIRST 
本方最优价格委托 - xtconstant.MARKET_MINE_PRICE_FIRST 
深交所 股票 期权 
对手方最优价格委托 - xtconstant.MARKET_PEER_PRICE_FIRST 
本方最优价格委托 - xtconstant.MARKET_MINE_PRICE_FIRST 
即时成交剩余撤销委托 - xtconstant.MARKET_SZ_INSTBUSI_RESTCANCEL 
最优五档即时成交剩余撤销 - xtconstant.MARKET_SZ_CONVERT_5_CANCEL 
全额成交或撤销委托 - xtconstant.MARKET_SZ_FULL_OR_CANCEL 
 # 委托状态(order_status)
 枚举变量名 值 含义 
 xtconstant.ORDER_UNREPORTED 48 未报 
 xtconstant.ORDER_WAIT_REPORTING 49 待报 
 xtconstant.ORDER_REPORTED 50 已报 
 xtconstant.ORDER_REPORTED_CANCEL 51 已报待撤 
 xtconstant.ORDER_PARTSUCC_CANCEL 52 部成待撤 
 xtconstant.ORDER_PART_CANCEL 53 部撤（已经有一部分成交，剩下的已经撤单） 
 xtconstant.ORDER_CANCELED 54 已撤 
 xtconstant.ORDER_PART_SUCC 55 部成（已经有一部分成交，剩下的待成交） 
 xtconstant.ORDER_SUCCEEDED 56 已成 
 xtconstant.ORDER_JUNK 57 废单 
 xtconstant.ORDER_UNKNOWN 255 未知 
 # 账号状态(account_status)
 枚举变量名 值 含义 
 xtconstant.ACCOUNT_STATUS_INVALID -1 无效 
 xtconstant.ACCOUNT_STATUS_OK 0 正常 
 xtconstant.ACCOUNT_STATUS_WAITING_LOGIN 1 连接中 
 xtconstant.ACCOUNT_STATUSING 2 登陆中 
 xtconstant.ACCOUNT_STATUS_FAIL 3 失败 
 xtconstant.ACCOUNT_STATUS_INITING 4 初始化中 
 xtconstant.ACCOUNT_STATUS_CORRECTING 5 数据刷新校正中 
 xtconstant.ACCOUNT_STATUS_CLOSED 6 收盘后 
 xtconstant.ACCOUNT_STATUS_ASSIS_FAIL 7 穿透副链接断开 
 xtconstant.ACCOUNT_STATUS_DISABLEBYSYS 8 系统停用（总线使用-密码错误超限） 
 xtconstant.ACCOUNT_STATUS_DISABLEBYUSER 9 用户停用（总线使用） 
 # 划拨方向(transfer_direction)
 枚举变量名 值 含义 
 xtconstant.FUNDS_TRANSFER_NORMAL_TO_SPEED 510 资金划拨-普通柜台到极速柜台 
 xtconstant.FUNDS_TRANSFER_SPEED_TO_NORMAL 511 资金划拨-极速柜台到普通柜台 
 xtconstant.NODE_FUNDS_TRANSFER_SH_TO_SZ 512 节点资金划拨-上海节点到深圳节点 
 xtconstant.NODE_FUNDS_TRANSFER_SZ_TO_SH 513 节点资金划拨-深圳节点到上海节点 
 # 多空方向(direction)
 枚举变量名 值 含义 
 xtconstant.DIRECTION_FLAG_LONG 48 多 
 xtconstant.DIRECTION_FLAG_SHORT 49 空 
 # 交易操作(offset_flag)
 枚举变量名 值 含义 
 xtconstant.OFFSET_FLAG_OPEN 48 买入，开仓 
 xtconstant.OFFSET_FLAG_CLOSE 49 卖出，平仓 
 xtconstant.OFFSET_FLAG_FORCECLOSE 50 强平 
 xtconstant.OFFSET_FLAG_CLOSETODAY 51 平今 
 xtconstant.OFFSET_FLAG_ClOSEYESTERDAY 52 平昨 
 xtconstant.OFFSET_FLAG_FORCEOFF 53 强减 
 xtconstant.OFFSET_FLAG_LOCALFORCECLOSE 54 本地强平 
 # XtQuant数据结构说明
 # 资产XtAsset
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 cash float 可用金额 
 frozen_cash float 冻结金额 
 market_value float 持仓市值 
 total_asset float 总资产 
 # 委托XtOrder
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 stock_code str 证券代码，例如"600000.SH" 
 order_id int 订单编号 
 order_sysid str 柜台合同编号 
 order_time int 报单时间 
 order_type int 委托类型，参见 数据字典 
 在新窗口打开 
 order_volume int 委托数量 
 price_type int 报价类型，该字段在返回时为柜台返回类型，不等价于下单传入的price_type，枚举值不一样功能一样，参见 数据字典 
 在新窗口打开 
 price float 委托价格 
 traded_volume int 成交数量 
 traded_price float 成交均价 
 order_status int 委托状态，参见 数据字典 
 在新窗口打开 
 status_msg str 委托状态描述，如废单原因 
 strategy_name str 策略名称 
 order_remark str 委托备注，最大 24 个英文字符 
 direction int 多空方向，股票不适用；参见 数据字典 
 在新窗口打开 
 offset_flag int 交易操作，用此字段区分股票买卖，期货开、平仓，期权买卖等；参见 数据字典 
 在新窗口打开 
 # 成交XtTrade
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 stock_code str 证券代码 
 order_type int 委托类型，参见 数据字典 
 在新窗口打开 
 traded_id str 成交编号 
 traded_time int 成交时间 
 traded_price float 成交均价 
 traded_volume int 成交数量 
 traded_amount float 成交金额 
 order_id int 订单编号 
 order_sysid str 柜台合同编号 
 strategy_name str 策略名称 
 order_remark str 委托备注，最大 24 个英文字符( 
 direction int 多空方向，股票不适用；参见 数据字典 
 在新窗口打开 
 offset_flag int 交易操作，用此字段区分股票买卖，期货开、平仓，期权买卖等；参见 数据字典 
 在新窗口打开 
 # 持仓XtPosition
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 stock_code str 证券代码 
 volume int 持仓数量 
 can_use_volume int 可用数量 
 open_price float 开仓价（返回与成本价一致） 
 market_value float 市值 
 frozen_volume int 冻结数量 
 on_road_volume int 在途股份 
 yesterday_volume int 昨夜拥股 
 avg_price float 成本价 
 direction int 多空方向，股票不适用；参见 数据字典 
 在新窗口打开 
 # 期货持仓统计XtPositionStatistics
 属性 类型 注释 
 account_id string 账户 
 exchange_id string 市场代码 
 exchange_name string 市场名称 
 product_id string 品种代码 
 instrument_id string 合约代码 
 instrument_name string 合约名称 
 direction int 多空方向，股票不适用；参见 数据字典 
 在新窗口打开 
 hedge_flag int 投保类型；参见 投保类型 
 在新窗口打开 
 position int 持仓数量 
 yesterday_position int 昨仓数量 
 today_position int 今仓数量 
 can_close_vol int 可平数量 
 position_cost float 持仓成本 
 avg_price float 持仓均价 
 position_profit float 持仓盈亏 
 float_profit float 浮动盈亏 
 open_price float 开仓均价 
 open_cost float 开仓成本 
 used_margin float 已使用保证金 
 used_commission float 已使用的手续费 
 frozen_margin float 冻结保证金 
 frozen_commission float 冻结手续费 
 instrument_value float 市值，合约价值 
 open_times int 开仓次数 
 open_volume int 总开仓量 中间平仓不减 
 cancel_times int 撤单次数 
 last_price float 最新价 
 rise_ratio float 当日涨幅 
 product_name string 产品名称 
 royalty float 权利金市值 
 expire_date string 到期日 
 assest_weight float 资产占比 
 increase_by_settlement float 当日涨幅（结） 
 margin_ratio float 保证金占比 
 float_profit_divide_by_used_margin float 浮盈比例（保证金） 
 float_profit_divide_by_balance float 浮盈比例（动态权益） 
 today_profit_loss float 当日盈亏（结） 
 yesterday_init_position int 昨日持仓 
 frozen_royalty float 冻结权利金 
 today_close_profit_loss float 当日盈亏（收） 
 close_profit float 平仓盈亏 
 ft_product_name string 品种名称 
 # 异步下单委托反馈XtOrderResponse
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 order_id int 订单编号 
 strategy_name str 策略名称 
 order_remark str 委托备注 
 seq int 异步下单的请求序号 
 # 异步撤单委托反馈XtCancelOrderResponse
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 order_id int 订单编号 
 order_sysid str 柜台委托编号 
 cancel_result int 撤单结果（0 成功，-1 失败） 
 seq int 异步撤单的请求序号 
 # 下单失败错误XtOrderError
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 order_id int 订单编号 
 error_id int 下单失败错误码 
 error_msg str 下单失败具体信息 
 strategy_name str 策略名称 
 order_remark str 委托备注 
 # 撤单失败错误XtCancelError
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 order_id int 订单编号 
 market int 交易市场 0:上海 1:深圳 
 order_sysid str 柜台委托编号 
 error_id int 下单失败错误码 
 error_msg str 下单失败具体信息 
 # 信用账号资产XtCreditDetail
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 m_nStatus int 账号状态 
 m_nUpdateTime int 更新时间 
 m_nCalcConfig int 计算参数 
 m_dFrozenCash float 冻结金额 
 m_dBalance float 总资产 
 m_dAvailable float 可用金额 
 m_dPositionProfit float 持仓盈亏 
 m_dMarketValue float 总市值 
 m_dFetchBalance float 可取金额 
 m_dStockValue float 股票市值 
 m_dFundValue float 基金市值 
 m_dTotalDebt float 总负债 
 m_dEnableBailBalance float 可用保证金 
 m_dPerAssurescaleValue float 维持担保比例 
 m_dAssureAsset float 净资产 
 m_dFinDebt float 融资负债 
 m_dFinDealAvl float 融资本金 
 m_dFinFee float 融资息费 
 m_dSloDebt float 融券负债 
 m_dSloMarketValue float 融券市值 
 m_dSloFee float 融券息费 
 m_dOtherFare float 其它费用 
 m_dFinMaxQuota float 融资授信额度 
 m_dFinEnableQuota float 融资可用额度 
 m_dFinUsedQuota float 融资冻结额度 
 m_dSloMaxQuota float 融券授信额度 
 m_dSloEnableQuota float 融券可用额度 
 m_dSloUsedQuota float 融券冻结额度 
 m_dSloSellBalance float 融券卖出资金 
 m_dUsedSloSellBalance float 已用融券卖出资金 
 m_dSurplusSloSellBalance float 剩余融券卖出资金 
 # 负债合约StkCompacts
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 compact_type int 合约类型 
 cashgroup_prop int 头寸来源 
 exchange_id int 证券市场 
 open_date int 开仓日期 
 business_vol int 合约证券数量 
 real_compact_vol int 未还合约数量 
 ret_end_date int 到期日 
 business_balance float 合约金额 
 businessFare float 合约息费 
 real_compact_balance float 未还合约金额 
 real_compact_fare float 未还合约息费 
 repaid_fare float 已还息费 
 repaid_balance float 已还金额 
 instrument_id str 证券代码 
 compact_id str 合约编号 
 position_str str 定位串 
 # 融资融券标的CreditSubjects
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 slo_status int 融券状态（参见下一条融券状态说明） 
 fin_status int 融资状态 
 exchange_id int 证券市场 
 slo_ratio float 融券保证金比例 
 fin_ratio float 融资保证金比例 
 instrument_id str 证券代码 
 # 融券状态说明
 返回值 状态 
 48 正常 
 49 暂停 
 50 作废 
 # 可融券数据CreditSloCode
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 cashgroup_prop int 头寸来源 
 exchange_id int 证券市场 
 enable_amount int 融券可融数量 
 instrument_id str 证券代码 
 # 标的担保品CreditAssure
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 assure_status int 是否可做担保 
 exchange_id int 证券市场 
 assure_ratio float 担保品折算比例 
 instrument_id str 证券代码 
 # 账号状态XtAccountStatus
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 status int 账号状态，参见 数据字典 
 在新窗口打开 
 # 账号信息XtAccountInfo
 属性 类型 注释 
 account_type int 账号类型，参见 数据字典 
 在新窗口打开 
 account_id str 资金账号 
 broker_type int 同 account_type 
 platform_id int 平台号 
 account_classification int 账号分类 
 login_status int 账号状态，参见 数据字典 
 在新窗口打开 
 # 约券相关异步接口的反馈XtSmtAppointmentResponse
 属性 类型 注释 
 seq int 异步请求序号 
 success bool 申请是否成功 
 msg str 反馈信息 
 apply_id str 若申请成功返回资券申请编号，否则返回-1 
 # XtQuant API说明
 # 系统设置接口
 # 创建API实例
 XtQuantTrader(path, session_id) 
释义 
创建XtQuant API的实例
参数 
path - str MiniQMT客户端userdata_mini的完整路径
session_id - int 与MiniQMT通信的会话ID，不同的会话要保证不重
返回 
XtQuant API实例对象
备注 
后续对XtQuant API的操作都需要该实例对象
通常情况下只需要创建一个XtQuant API实例
示例
 path = ' D: \\ 迅投极速交易终端 睿智融科版 \\ userdata_mini ' 
 # session_id为会话编号，策略使用方对于不同的Python策略需要使用不同的会话编号 
 session_id = 123456 
 #后续的所有示例将使用该实例对象 
 xt_trader = XtQuantTrader(path, session_id) 
 # 注册回调类
 register_callback(callback) 
释义 
将回调类实例对象注册到API实例中，用以消息回调和主推
参数 
callback - XtQuantTraderCallback 回调类实例对象
返回 
无
备注 
无
示例
 # 创建交易回调类对象，并声明接收回调 
 class MyXtQuantTraderCallback ( XtQuantTraderCallback )： 
 ... 
 pass 
 callback = MyXtQuantTraderCallback () 
 # xt_trader为XtQuant API实例对象 
 xt_trader . register_callback ( callback ) 
 # 准备API环境
 start() 
释义 
启动交易线程，准备交易所需的环境
参数 
无
返回 
无
备注 
无
示例
 # 启动交易线程 
 #xt_trader为XtQuant API实例对象 
 xt_trader.start() 
 # 创建连接
 connect() 
释义 
连接MiniQMT
参数 
无
返回 
连接结果信息，连接成功返回0，失败返回非0
备注 
该连接为一次性连接，断开连接后不会重连，需要再次主动调用
示例
 # 建立交易连接，返回0表示连接成功 
 #xt_trader为XtQuant API实例对象 
 connect_result = xt_trader.connect() 
 print (connect_result) 
 # 停止运行
 stop() 
释义 
停止API接口
参数 
无
返回 
无
备注 
无
示例
 #xt_trader为XtQuant API实例对象 
 xt_trader.stop() 
 # 阻塞当前线程进入等待状态
 run_forever() 
释义 
阻塞当前线程，进入等待状态，直到stop函数被调用结束阻塞
参数 
无
返回 
无
备注 
无
示例
 #xt_trader为XtQuant API实例对象 
 xt_trader.run_forever() 
 # 开启主动请求接口的专用线程
 set_relaxed_response_order_enabled(enabled) 
释义
控制主动请求接口的返回是否从额外的专用线程返回，以获得宽松的数据时序
参数
enabled - bool 是否开启，默认为False关闭
返回
无
备注
如果开启，在on_stock_order等推送回调中调用同步请求不会卡住，但查询和推送的数据在时序上会变得不确定
 timeline t1 t2 t3 t4 
 callback push1 push2 push3 resp4 
 do query4 ------------------^ 
例如：分别在t1 t2 t3时刻到达三条委托数据，在on_push1中调用同步委托查询接口query_orders()
未开启宽松时序时，查询返回resp4会在t4时刻排队到push3完成之后处理，这使得同步等待结果的查询不能返回而卡住执行
开启宽松时序时，查询返回的resp4由专用线程返回，程序正常执行，但此时查到的resp4是push3之后的状态，也就是说resp4中的委托要比push2 push3这两个前一时刻推送的数据新，但在更早的t1时刻就进入了处理
使用中请根据策略实际情况来开启，通常情况下，推荐在on_stock_order等推送回调中使用查询接口的异步版本，如 query_stock_orders_async 
 # 操作接口
 # 订阅账号信息
 subscribe(account) 
释义 
订阅账号信息，包括资金账号、委托信息、成交信息、持仓信息
参数 
account - StockAccount 资金账号
返回 
订阅结果信息，订阅成功返回0，订阅失败返回-1
备注 
无
示例 
订阅资金账号1000000365
 account = StockAccount( ' 1000000365 ' ) 
 #xt_trader为XtQuant API实例对象 
 subscribe_result = xt_trader.subscribe(account) 
 # 反订阅账号信息
 unsubscribe(account) 
释义 
反订阅账号信息
参数 
account - StockAccount 资金账号
返回 
反订阅结果信息，订阅成功返回0，订阅失败返回-1
备注 
无
示例 
订阅资金账号1000000365
 account = StockAccount( ' 1000000365 ' ) 
 #xt_trader为XtQuant API实例对象 
 unsubscribe_result = xt_trader.unsubscribe(account) 
 # 股票同步报单
 order_stock(account, stock_code, order_type, order_volume, price_type, price, strategy_name, order_remark) 
释义 
对股票进行下单操作
参数 
account - StockAccount 资金账号
stock_code - str 证券代码，如'600000.SH'
order_type - int 委托类型
order_volume - int 委托数量，股票以'股'为单位，债券以'张'为单位
price_type - int 报价类型
price - float 委托价格
strategy_name - str 策略名称
order_remark - str 委托备注
返回 
系统生成的订单编号，成功委托后的订单编号为大于0的正整数，如果为-1表示委托失败
备注 
无
示例 
股票资金账号1000000365对浦发银行买入1000股，使用限价价格10.5元, 委托备注为'order_test'
 account = StockAccount( ' 1000000365 ' ) 
 #xt_trader为XtQuant API实例对象 
 order_id = xt_trader.order_stock(account, ' 600000.SH ' , xtconstant. STOCK_BUY , 1000 , xtconstant. FIX_PRICE , 10.5 , ' strategy1 ' , ' order_test ' ) 
 # 股票异步报单
 order_stock_async(account, stock_code, order_type, order_volume, price_type, price, strategy_name, order_remark) 
释义 
对股票进行异步下单操作，异步下单接口如果正常返回了下单请求序号seq，会收到on_order_stock_async_response的委托反馈
参数 
account - StockAccount 资金账号
stock_code - str 证券代码， 如'600000.SH'
order_type - int 委托类型
order_volume - int 委托数量，股票以'股'为单位，债券以'张'为单位
price_type - int 报价类型
price - float 委托价格
strategy_name - str 策略名称
order_remark - str 委托备注
返回 
返回下单请求序号seq，成功委托后的下单请求序号为大于0的正整数，如果为-1表示委托失败
备注 
如果失败，则通过下单失败主推接口返回下单失败信息
示例 
股票资金账号1000000365对浦发银行买入1000股，使用限价价格10.5元，委托备注为'order_test'
 account = StockAccount( ' 1000000365 ' ) 
 #xt_trader为XtQuant API实例对象 
 seq = xt_trader.order_stock_async(account, ' 600000.SH ' , xtconstant. STOCK_BUY , 1000 , xtconstant. FIX_PRICE , 10.5 , ' strategy1 ' , ' order_test ' ) 
 # 股票同步撤单
 cancel_order_stock(account, order_id) 
释义 
根据订单编号对委托进行撤单操作
参数 
account - StockAccount 资金账号
order_id - int 同步下单接口返回的订单编号,对于期货来说，是order结构中的order_sysid字段
返回 
返回是否成功发出撤单指令，0: 成功, -1: 表示撤单失败
备注 
无
示例 
股票资金账号1000000365对订单编号为order_id的委托进行撤单
 account = StockAccount( ' 1000000365 ' ) 
 order_id = 100 
 #xt_trader为XtQuant API实例对象 
 cancel_result = xt_trader.cancel_order_stock(account, order_id) 
 # 股票同步撤单
 cancel_order_stock_sysid(account, market, order_sysid) 
释义 
根据券商柜台返回的合同编号对委托进行撤单操作
参数 
account - StockAccount 资金账号
market - int 交易市场
order_sysid - str 券商柜台的合同编号
返回 
返回是否成功发出撤单指令，0: 成功， -1: 表示撤单失败
备注 
无
示例 
股票资金账号1000000365对柜台合同编号为order_sysid的上交所委托进行撤单
 account = StockAccount( ' 1000000365 ' ) 
 market = xtconstant. SH_MARKET 
 order_sysid = " 100 " 
 #xt_trader为XtQuant API实例对象 
 cancel_result = xt_trader.cancel_order_stock_sysid(account, market, order_sysid) 
 # 股票异步撤单
 cancel_order_stock_async(account, order_id) 
释义 
根据订单编号对委托进行异步撤单操作
参数 
account - StockAccount 资金账号
order_id - int 下单接口返回的订单编号，对于期货来说，是order结构中的order_sysid
返回 
返回撤单请求序号, 成功委托后的撤单请求序号为大于0的正整数, 如果为-1表示委托失败
备注 
如果失败，则通过撤单失败主推接口返回撤单失败信息
示例 
股票资金账号1000000365对订单编号为order_id的委托进行异步撤单
 account = StockAccount( ' 1000000365 ' ) 
 order_id = 100 
 #xt_trader为XtQuant API实例对象 
 cancel_result = xt_trader.cancel_order_stock_async(account, order_id) 
 # 股票异步撤单
 cancel_order_stock_sysid_async(account, market, order_sysid) 
释义 
根据券商柜台返回的合同编号对委托进行异步撤单操作
参数 
account - StockAccount 资金账号
market - int 交易市场
order_sysid - str 券商柜台的合同编号
返回 
返回撤单请求序号, 成功委托后的撤单请求序号为大于0的正整数, 如果为-1表示委托失败
备注 
如果失败，则通过撤单失败主推接口返回撤单失败信息
示例 
股票资金账号1000000365对柜台合同编号为order_sysid的上交所委托进行异步撤单
 account = StockAccount( ' 1000000365 ' ) 
 market = xtconstant. SH_MARKET 
 order_sysid = " 100 " 
 #xt_trader为XtQuant API实例对象 
 cancel_result = xt_trader.cancel_order_stock_sysid_async(account, market, order_sysid) 
 # 资金划拨
 fund_transfer(account, transfer_direction, price) 
释义 
资金划拨
参数 
account - StockAccount 资金账号
transfer_direction - int 划拨方向，见数据字典划拨方向(transfer_direction)字段说明
price - float 划拨金额
返回 
(success, msg) 
success - bool 划拨操作是否成功
msg - str 反馈信息
 # 外部交易数据录入
 sync_transaction_from_external(operation, data_type, account, deal_list) 
释义
通用数据导出
参数
operation - str 操作类型，有"UPDATE","REPLACE","ADD","DELETE"
data_type - str 数据类型，有"DEAL"
account - StockAccount 资金账号
deal_list - list 成交列表,每一项是Deal成交对象的参数字典,键名参考官网数据字典,大小写保持一致
返回
result - dict 结果反馈信息
示例
 deal_list = [ 
 { ' m_strExchangeID ' : ' SF ' , ' m_strInstrumentID ' : ' ag2407 ' 
 , ' m_strTradeID ' : ' 123456 ' , ' m_strOrderSysID ' : ' 1234566 ' 
 , ' m_dPrice ' : 7600 , ' m_nVolume ' : 1 
 , ' m_strTradeDate ' : ' 20240627 ' 
 } 
 ] 
 resp = xt_trader.sync_transaction_from_external( ' ADD ' , ' DEAL ' , acc, deal_list) 
 print (resp) 
 #成功输出示例：{'msg': 'sync transaction from external success'} 
 #失败输出示例：{'error': {'msg': '[0-0: invalid operation type: ADDD], '}} 
 # 股票查询接口
 # 资产查询
 query_stock_asset(account) 
释义 
查询资金账号对应的资产
参数 
account - StockAccount 资金账号
返回 
该账号对应的资产对象 XtAsset 
 在新窗口打开 或者None
备注 
返回None表示查询失败
示例 
查询股票资金账号1000000365对应的资产数据
 account = StockAccount( ' 1000000365 ' ) 
 #xt_trader为XtQuant API实例对象 
 asset = xt_trader.query_stock_asset(account) 
 # 委托查询
 query_stock_orders(account, cancelable_only = False ) 
释义 
查询资金账号对应的当日所有委托
参数 
account - StockAccount 资金账号
cancelable_only - bool 仅查询可撤委托
返回 
该账号对应的当日所有委托对象 XtOrder 
 在新窗口打开 组成的list或者None
备注 
None表示查询失败或者当日委托列表为空
示例 
查询股票资金账号1000000365对应的当日所有委托
 account = StockAccount( ' 1000000365 ' ) 
 #xt_trader为XtQuant API实例对象 
 orders = xt_trader.query_stock_orders(account, False ) 
 # 成交查询
 query_stock_trades(account) 
释义 
查询资金账号对应的当日所有成交
参数 
account - StockAccount 资金账号
返回 
该账号对应的当日所有成交对象 XtTrade 
 在新窗口打开 组成的list或者None
备注 
None表示查询失败或者当日成交列表为空
示例 
查询股票资金账号1000000365对应的当日所有成交
 account = StockAccount( ' 1000000365 ' ) 
 #xt_trader为XtQuant API实例对象 
 trades = xt_trader.query_stock_trades(account) 
 # 持仓查询
 query_stock_positions(account) 
释义 
查询资金账号对应的持仓
参数 
account - StockAccount 资金账号
返回 
该账号对应的最新持仓对象 XtPosition 
 在新窗口打开 组成的list或者None
备注 
None表示查询失败或者当日持仓列表为空
示例 
查询股票资金账号1000000365对应的最新持仓
 account = StockAccount( ' 1000000365 ' ) 
 #xt_trader为XtQuant API实例对象 
 positions = xt_trader.query_stock_positions(account) 
 # 期货持仓统计查询
 query_position_statistics(account) 
释义 
查询期货账号的持仓统计
参数 
account - StockAccount 资金账号
返回 
该账号对应的最新持仓对象 XtPositionStatistics 
 在新窗口打开 组成的list或者None
备注 
None表示查询失败或者当日持仓列表为空
示例 
查询期货资金账号1000000365对应的最新持仓
 account = StockAccount( ' 1000000365 ' , ' FUTURE ' ) 
 #xt_trader为XtQuant API实例对象 
 positions = xt_trader.query_position_statistics(account) 
 # 信用查询接口
 # 信用资产查询
 query_credit_detail(account) 
释义 
查询信用资金账号对应的资产
参数 
account - StockAccount 资金账号
返回 
该信用账户对应的资产对象 XtCreditDetail 
 在新窗口打开 组成的list或者None
备注 
None表示查询失败
通常情况下一个资金账号只有一个详细信息数据
示例 
查询信用资金账号1208970161对应的资产信息
 account = StockAccount( ' 1208970161 ' , ' CREDIT ' ) 
 #xt_trader为XtQuant API实例对象 
 datas = xt_trader.query_credit_detail(account) 
 # 负债合约查询
 query_stk_compacts(account) 
释义 
查询资金账号对应的负债合约
参数 
account - StockAccount 资金账号
返回 
该账户对应的负债合约对象 StkCompacts 
 在新窗口打开 组成的list或者None
备注 
None表示查询失败或者负债合约列表为空
示例 
查询信用资金账号1208970161对应的负债合约
 account = StockAccount( ' 1208970161 ' , ' CREDIT ' ) 
 #xt_trader为XtQuant API实例对象 
 datas = xt_trader.query_stk_compacts(account) 
 # 融资融券标的查询
 query_credit_subjects(account) 
释义 
查询资金账号对应的融资融券标的
参数 
account - StockAccount 资金账号
返回 
该账户对应的融资融券标的对象 CreditSubjects 
 在新窗口打开 组成的list或者None
备注 
None表示查询失败或者融资融券标的列表为空
示例 
查询信用资金账号1208970161对应的融资融券标的
 account = StockAccount( ' 1208970161 ' , ' CREDIT ' ) 
 #xt_trader为XtQuant API实例对象 
 datas = xt_trader.query_credit_subjects(account) 
 # 可融券数据查询
 query_credit_slo_code(account) 
释义 
查询资金账号对应的可融券数据
参数 
account - StockAccount 资金账号
返回 
该账户对应的可融券数据对象 CreditSloCode 
 在新窗口打开 组成的list或者None
备注 
None表示查询失败或者可融券数据列表为空
示例 
查询信用资金账号1208970161对应的可融券数据
 account = StockAccount( ' 1208970161 ' , ' CREDIT ' ) 
 #xt_trader为XtQuant API实例对象 
 datas = xt_trader.query_credit_slo_code(account) 
 # 标的担保品查询
 query_credit_assure(account) 
释义 
查询资金账号对应的标的担保品
参数 
account - StockAccount 资金账号
返回
该账户对应的标的担保品对象 CreditAssure 
 在新窗口打开 组成的list或者None
备注 
None表示查询失败或者标的担保品列表为空
示例 
查询信用资金账号1208970161对应的标的担保品
 account = StockAccount( ' 1208970161 ' , ' CREDIT ' ) 
 #xt_trader为XtQuant API实例对象 
 datas = xt_trader.query_credit_assure(account) 
 # 其他查询接口
 # 新股申购额度查询
 query_new_purchase_limit(account) 
释义 
查询新股申购额度
参数 
account - StockAccount 资金账号
返回 
dict 新股申购额度数据集 
{ type1: number1, type2: number2, ... } 
type - str 品种类型 
 KCB - 科创板， SH - 上海， SZ - 深圳
number - int 可申购股数
备注 
数据仅代表股票申购额度，债券的申购额度固定10000张
 # 当日新股信息查询
 query_ipo_data() 
释义
查询当日新股新债信息
参数
无
返回
dict 新股新债信息数据集
{ stock1: info1, stock2: info2, ... }
stock - str 品种代码，例如 '301208.SZ'
info - dict 新股信息 
name - str 品种名称
type - str 品种类型 
 STOCK - 股票， BOND - 债券
minPurchaseNum / maxPurchaseNum - int 最小 / 最大申购额度 
单位为股（股票）/ 张（债券）
purchaseDate - str 申购日期
issuePrice - float 发行价
返回值示例
 { ' 754810.SH ' : { ' name ' : ' 丰山发债 ' , ' type ' : ' BOND ' , ' maxPurchaseNum ' : 10000 , ' minPurchaseNum ' : 10 , ' purchaseDate ' : ' 20220627 ' , ' issuePrice ' : 100.0 }, ' 301208.SZ ' : { ' name ' : ' 中亦科技 ' , ' type ' : ' STOCK ' , ' maxPurchaseNum ' : 16500 , ' minPurchaseNum ' : 500 , ' purchaseDate ' : ' 20220627 ' , ' issuePrice ' : 46.06 }} 
备注
无
 # 账号信息查询
 query_account_infos() 
释义
查询所有资金账号
参数
无
返回
list 账号信息列表
[ XtAccountInfo ]
备注
无
 # 账号状态查询
 query_account_status() 
释义
查询所有账号状态
参数
无
返回
list 账号状态列表
[ XtAccountStatus ]
备注
无
 # 普通柜台资金查询
 query_com_fund(account) 
释义 
划拨业务查询普通柜台的资金
参数 
account - StockAccount 资金账号
返回 
result - dict 资金信息，包含以下字段 
success - bool
erro - str
currentBalance - double 当前余额
enableBalance - double 可用余额
fetchBalance - double 可取金额
interest - double 待入账利息
assetBalance - double 总资产
fetchCash - double 可取现金
marketValue - double 市值
debt - double 负债
 # 普通柜台持仓查询
 query_com_position(account) 
释义 
划拨业务查询普通柜台的持仓
参数 
account - StockAccount 资金账号
返回 
result - list 持仓信息列表[position1, position2, ...] 
position - dict 持仓信息，包含以下字段 
success - bool
error - str
stockAccount - str 股东号
exchangeType - str 交易市场
stockCode - str 证券代码
stockName - str 证券名称
totalAmt - float 总量
enableAmount - float 可用量
lastPrice - float 最新价
costPrice - float 成本价
income - float 盈亏
incomeRate - float 盈亏比例
marketValue - float 市值
costBalance - float 成本总额
bsOnTheWayVol - int 买卖在途量
prEnableVol - int 申赎可用量
 # 通用数据导出
 export_data(account, result_path, data_type, start_time = None , end_time = None , user_param = {}) 
释义
通用数据导出
参数
account - StockAccount 资金账号
result_path - str 导出路径，包含文件名及.csv后缀，如'C:\Users\Desktop\test\deal.csv'
data_type - str 数据类型，如'deal'
start_time - str 开始时间（可缺省）
end_time - str 结束时间（可缺省）
user_param - dict 用户参数（可缺省）
返回
result - dict 结果反馈信息
示例
 resp = xt_trader.export_data(acc, ' C: \\ Users \\ Desktop \\ test \\ deal.csv ' , ' deal ' ) 
 print (resp) 
 #成功输出示例：{'msg': 'export success'} 
 #失败输出示例：{'error': {'errorMsg': 'can not find account info, accountID:2000449 accountType:2'}} 
 # 通用数据查询
 query_data(account, result_path, data_type, start_time = None , end_time = None , user_param = {}) 
释义
通用数据查询，利用export_data接口导出数据后再读取其中的数据内容，读取完毕后删除导出的文件
参数
同export_data
返回
result - dict 数据信息
示例
 data = xt_trader.query_data(acc, ' C: \\ Users \\ Desktop \\ test \\ deal.csv ' , ' deal ' ) 
 print (data) 
 #成功输出示例： 
 # account_id account_Type stock_code order_type ... 
 #0 2003695 2 688488.SH 23 ... 
 #1 2003695 2 000096.SZ 23 ... 
 #失败输出示例：{'error': {'errorMsg': 'can not find account info, accountID:2000449 accountType:2'}} 
 # 约券相关接口
 # 券源行情查询
 smt_query_quoter(account) 
释义 
券源行情查询
参数 
account - StockAccount 资金账号
返回 
result - list 券源信息列表[quoter1, quoter2, ...] 
quoter - dict 券源信息，包含以下字段 
success - bool
error - str
finType - str 金融品种
stockType - str 证券类型
date - int 期限天数
code - str 证券代码
codeName - str 证券代码名称
exchangeType - str 市场
fsmpOccupedRate - float 资券占用利率
fineRate - float 罚息利率
fsmpreendRate - float 资券提前归还利率
usedRate - float 资券使用利率
unUusedRate - float 资券占用未使用利率
initDate - int 交易日期
endDate - int 到期日期
enableSloAmountT0 - float T+0可融券数量
enableSloAmountT3 - float T+3可融券数量
srcGroupId - str 来源组编号
applyMode - str 资券申请方式，"1":库存券，"2":专项券
lowDate - int 最低期限天数
 # 库存券约券申请
 smt_negotiate_order_async( self , account, src_group_id, order_code, date, amount, apply_rate, dict_param = {}) 
释义
库存券约券申请的异步接口，异步接口如果正常返回了请求序号seq，会收到on_smt_appointment_async_response的反馈
参数
account - StockAccount 资金账号
src_group_id - str 来源组编号
order_code - str 证券代码，如'600000.SH'
date - int 期限天数
amount - int 委托数量
apply_rate - float 资券申请利率
注：目前有如下参数通过一个可缺省的字典传递，键名与参数名称相同
dict_param - dict 可缺省的字典参数 
subFareRate - float 提前归还利率
fineRate - float 罚息利率
返回
返回请求序号seq，成功发起申请后的请求序号为大于0的正整数，如果为-1表示发起申请失败
示例
 account = StockAccount( ' 1000008 ' , ' CREDIT ' ) 
 dict_param = { ' subFareRate ' : 0.1 , ' fineRate ' : 0.1 } 
 #xt_trader为XtQuant API实例对象 
 seq = xt_trader.smt_negotiate_order_async(account, '' , ' 000001.SZ ' , 7 , 100 , 0.2 , dict_param) 
 # 约券合约查询
 smt_query_compact(account) 
释义 
约券合约查询
参数 
account - StockAccount 资金账号
返回 
result - list 约券合约信息列表[compact1, compact2, ...] 
compact - dict 券源信息，包含以下字段 
success - bool
error - str
createDate - int 创建日期
cashcompactId - str 头寸合约编号
oriCashcompactId - str 原头寸合约编号
applyId - str 资券申请编号
srcGroupId - str 来源组编号
comGroupId - str 资券组合编号
finType - str 金融品种
exchangeType - str 市场
code - str 证券代码
codeName - str 证券代码名称
date - int 期限天数
beginCompacAmount - float 期初合约数量
beginCompacBalance - float 期初合约金额
compacAmount - float 合约数量
compacBalance - float 合约金额
returnAmount - float 返还数量
returnBalance - float 返还金额
realBuyAmount - float 回报买入数量
fsmpOccupedRate - float 资券占用利率
compactInterest - float 合约利息金额
compactFineInterest - float 合约罚息金额
repaidInterest - float 已还利息
repaidFineInterest - float 归还罚息
fineRate - float 罚息利率
preendRate - float 资券提前归还利率
compactType - str 资券合约类型
postponeTimes - int 展期次数
compactStatus - str 资券合约状态，"0":未归还，"1":部分归还，"2":提前了结，"3":到期了结，"4":逾期了结，"5":逾期，"9":已作废
lastInterestDate - int 上次结息日期
interestEndDate - int 记息结束日期
validDate - int 有效日期
dateClear - int 清算日期
usedAmount - float 已使用数量
usedBalance - float 使用金额
usedRate - float 资券使用利率
unUusedRate - float 资券占用未使用利率
srcGroupName - str 来源组名称
repaidDate - int 归还日期
preOccupedInterest - float 当日实际应收利息
compactInterestx - float 合约总利息
enPostponeAmount - float 可展期数量
postponeStatus - str 合约展期状态，"0":未审核，"1":审核通过，"2":已撤销，"3":审核不通过
applyMode - str 资券申请方式，"1":库存券，"2":专项券
 # 回调类
 class MyXtQuantTraderCallback ( XtQuantTraderCallback ): 
 def on_disconnected ( self ): 
 """ 
 连接状态回调 
 :return: 
 """ 
 print ( " connection lost " ) 
 def on_account_status ( self , status ): 
 """ 
 账号状态信息推送 
 :param response: XtAccountStatus 对象 
 :return: 
 """ 
 print ( " on_account_status " ) 
 print (status.account_id, status.account_type, status.status) 
 def on_stock_order ( self , order ): 
 """ 
 委托信息推送 
 :param order: XtOrder对象 
 :return: 
 """ 
 print ( " on order callback: " ) 
 print (order.stock_code, order.order_status, order.order_sysid) 
 def on_stock_trade ( self , trade ): 
 """ 
 成交信息推送 
 :param trade: XtTrade对象 
 :return: 
 """ 
 print ( " on trade callback " ) 
 print (trade.account_id, trade.stock_code, trade.order_id) 
 def on_order_error ( self , order_error ): 
 """ 
 下单失败信息推送 
 :param order_error:XtOrderError 对象 
 :return: 
 """ 
 print ( " on order_error callback " ) 
 print (order_error.order_id, order_error.error_id, order_error.error_msg) 
 def on_cancel_error ( self , cancel_error ): 
 """ 
 撤单失败信息推送 
 :param cancel_error: XtCancelError 对象 
 :return: 
 """ 
 print ( " on cancel_error callback " ) 
 print (cancel_error.order_id, cancel_error.error_id, cancel_error.error_msg) 
 def on_order_stock_async_response ( self , response ): 
 """ 
 异步下单回报推送 
 :param response: XtOrderResponse 对象 
 :return: 
 """ 
 print ( " on_order_stock_async_response " ) 
 print (response.account_id, response.order_id, response.seq) 
 def on_smt_appointment_async_response ( self , response ): 
 """ 
 :param response: XtAppointmentResponse 对象 
 :return: 
 """ 
 print ( " on_smt_appointment_async_response " ) 
 print (response.account_id, response.order_sysid, response.error_id, response.error_msg, response.seq) 
 # 连接状态回调
 on_disconnected() 
释义 
失去连接时推送信息
参数 
无
返回 
无
备注 
无
 # 账号状态信息推送
 on_account_status(data) 
释义 
账号状态信息变动推送
参数 
data - XtAccountStatus 
 在新窗口打开 账号状态信息
返回 
无
备注 
无
 # 委托信息推送
 on_stock_order(data) 
释义 
委托信息变动推送,例如已成交数量，委托状态变化等
参数 
data - XtOrder 
 在新窗口打开 委托信息
返回 
无
备注 
无
 # 成交信息推送
 on_stock_trade(data) 
释义 
成交信息变动推送
参数 
data - XtTrade 
 在新窗口打开 成交信息
返回 
无
备注 
无
 # 下单失败信息推送
 on_order_error(data) 
释义 
下单失败信息推送
参数 
data - XtOrderError 
 在新窗口打开 下单失败信息
返回 
无
备注 
无
 # 撤单失败信息推送
 on_cancel_error(data) 
释义 
撤单失败信息的推送
参数 
data - XtCancelError 
 在新窗口打开 撤单失败信息
返回 
无
备注 
无
 # 异步下单回报推送
 on_order_stock_async_response(data) 
释义 
异步下单回报推送
参数 
data - XtOrderResponse 
 在新窗口打开 异步下单委托反馈
返回 
无
备注 
无
 # 约券相关异步接口的回报推送
 on_smt_appointment_async_response(data) 
释义 
异步约券相关接口回报推送
参数 
data - XtSmtAppointmentResponse 
 在新窗口打开 约券相关异步接口的反馈
返回 
无
备注 
无
 上次更新: 
邀请注册送VIP优惠券
分享下方的内容给好友、QQ群、微信群,好友注册您即可获得VIP优惠券
玩转qmt,上迅投qmt知识库
 登录后获取 
 XtQuant.XtData 行情模块 完整实例