kyugao/qmt_bridge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
qmt_bridge/reference/thinktrader_docs/nativeApi_xttrader.txt
T

1676 lines
58 KiB
Plaintext
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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 行情模块 完整实例
Reference in New Issue View Git Blame Copy Permalink