交易

下单、撤单、批量委托、持仓/资产/成交查询等交易功能。

需要认证

交易方法需要在创建客户端时传入 api_key 参数。

client = QMTClient(host="192.168.1.100", api_key="your-secret-key")

交易操作客户端方法集合，对应 /api/trading/* 端点。

place_order(stock_code: str, order_type: int, order_volume: int, price_type: int = 5, price: float = 0.0, strategy_name: str = '', order_remark: str = '', account_id: str = '') -> dict

委托下单。

参数：

名称	类型	描述	默认
stock_code	str	股票代码，如 "000001.SZ"	必需
order_type	int	委托类型 — 23=买入, 24=卖出	必需
order_volume	int	委托数量（股）	必需
price_type	int	报价类型	5
price	float	委托价格	0.0
strategy_name	str	策略名称	''
order_remark	str	委托备注	''
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	包含 order_id 等委托结果的字典

cancel_order(order_id: int, account_id: str = '') -> dict

撤销委托。

参数：

名称	类型	描述	默认
order_id	int	要撤销的委托 ID	必需
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	撤单结果

cancel_order_by_sysid(market: int, sysid: str, account_id: str = '') -> dict

按系统编号撤单。

参数：

名称	类型	描述	默认
market	int	市场代码	必需
sysid	str	系统编号	必需
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	撤单结果

cancel_order_by_sysid_async(market: int, sysid: str, account_id: str = '') -> dict

按系统编号异步撤单（结果通过 WebSocket 回调返回）。

参数：

名称	类型	描述	默认
market	int	市场代码	必需
sysid	str	系统编号	必需
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	包含请求序号的字典

query_orders(account_id: str = '', cancelable_only: bool = False, account_type: str = '') -> dict

查询当日委托列表。

参数：

名称	类型	描述	默认
account_id	str	交易账户 ID	''
cancelable_only	bool	仅返回可撤委托	False

返回：

类型	描述
dict	委托列表数据

query_positions(account_id: str = '', account_type: str = '') -> dict

查询当前持仓列表。

参数：

名称	类型	描述	默认
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	持仓列表数据

query_asset(account_id: str = '', account_type: str = '') -> dict

查询账户资产信息。

参数：

名称	类型	描述	默认
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	账户资产信息字典

query_trades(account_id: str = '', account_type: str = '') -> dict

查询当日成交记录。

参数：

名称	类型	描述	默认
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	成交记录列表数据

query_order_detail(order_id: int, account_id: str = '') -> dict

查询指定委托的详细信息。

参数：

名称	类型	描述	默认
order_id	int	委托 ID	必需
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	委托详情字典

batch_order(orders: list[dict]) -> dict

批量下单。

参数：

名称	类型	描述	默认
orders	list[dict]	委托列表，每个元素的结构与 place_order() 的参数相同	必需

返回：

类型	描述
dict	批量下单结果

batch_cancel(cancel_requests: list[dict]) -> dict

批量撤单。

参数：

名称	类型	描述	默认
cancel_requests	list[dict]	撤单请求列表	必需

返回：

类型	描述
dict	批量撤单结果

get_account_status(account_id: str = '') -> dict

获取交易账户连接状态。

参数：

名称	类型	描述	默认
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	连接状态信息

query_account_status_detail() -> dict

查询账户状态详情。

返回：

类型	描述
dict	账户状态详情

query_secu_account(account_id: str = '') -> dict

查询证券子账户。

参数：

名称	类型	描述	默认
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	证券子账户信息

place_order_async(stock_code: str, order_type: int, order_volume: int, price_type: int = 5, price: float = 0.0, strategy_name: str = '', order_remark: str = '', account_id: str = '') -> dict

异步委托下单（结果通过 WebSocket 回调返回）。

参数含义与 place_order() 相同。

返回：

类型	描述
dict	包含请求序号的字典

cancel_order_async(order_id: int, account_id: str = '') -> dict

异步撤单（结果通过 WebSocket 回调返回）。

参数：

名称	类型	描述	默认
order_id	int	要撤销的委托 ID	必需
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	包含请求序号的字典

query_single_order(order_id: int, account_id: str = '') -> dict

查询单笔委托。

参数：

名称	类型	描述	默认
order_id	int	委托 ID	必需
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	委托信息字典

query_single_trade(trade_id: int, account_id: str = '') -> dict

查询单笔成交。

参数：

名称	类型	描述	默认
trade_id	int	成交 ID	必需
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	成交信息字典

query_single_position(stock_code: str, account_id: str = '') -> dict

查询单只股票的持仓。

参数：

名称	类型	描述	默认
stock_code	str	股票代码	必需
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	单只股票持仓信息字典

query_new_purchase_limit(account_id: str = '') -> dict

查询新股申购额度。

参数：

名称	类型	描述	默认
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	申购额度信息

query_ipo_data() -> dict

查询当前 IPO 日历数据。

返回：

类型	描述
dict	IPO 日历数据

query_account_infos() -> dict

查询所有已注册交易账户的信息。

返回：

类型	描述
dict	全部交易账户信息字典

query_com_fund(account_id: str = '') -> dict

查询 COM 账户资金（期权/期货账户）。

参数：

名称	类型	描述	默认
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	COM 账户资金信息

query_com_position(account_id: str = '') -> dict

查询 COM 账户持仓（期权/期货账户）。

参数：

名称	类型	描述	默认
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	COM 账户持仓信息

export_data(result_path: str, data_type: str = '', start_time: str = '', end_time: str = '', user_param: str = '', account_id: str = '') -> dict

导出交易数据到文件。

参数：

名称	类型	描述	默认
result_path	str	导出文件路径	必需
data_type	str	数据类型	''
start_time	str	开始时间	''
end_time	str	结束时间	''
user_param	str	用户自定义参数	''
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	导出结果

query_data(result_path: str, data_type: str = '', start_time: str = '', end_time: str = '', user_param: str = '', account_id: str = '') -> dict

查询已导出的交易数据。

参数：

名称	类型	描述	默认
result_path	str	结果文件路径	必需
data_type	str	数据类型	''
start_time	str	开始时间	''
end_time	str	结束时间	''
user_param	str	用户自定义参数	''
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	查询结果

sync_transaction_from_external(operation: str, data_type: str, deal_list: list[dict], account_id: str = '') -> dict

从外部系统同步成交记录。

参数：

名称	类型	描述	默认
operation	str	操作类型	必需
data_type	str	数据类型	必需
deal_list	list[dict]	成交记录列表	必需
account_id	str	交易账户 ID	''

返回：

类型	描述
dict	同步结果