改单
适用市场
| 市场 | 品种 |
|---|---|
| 香港市场 | 股票、期权、窝轮、牛熊证、界内证、ETFs、期货 |
| 美国市场 | 股票、期权、ETFs、期货 |
| A股市场 | 股票、ETFs |
| 新加坡市场 | 期货 |
| 日本市场 | 期货 |
modify_order
接口说明
修改指定订单
modify_order(orderid, qty, price=None, aux_price=None, trail_type=None, trail_value=None, trail_spread=None)
每 30 秒最多提交 40 笔改单。
改单接口调用结果,仅表示改单请求是否成功,不表示改单结果是否成功。
对于港交所的品种,如果因价格偏离导致改单失败,原订单会被撤单。对于其他交易所的品种,如果改单失败,原订单维持改单前的状态不变。
参数
| 参数名 | 类型 | 说明 | 范围 |
|---|---|---|---|
| orderid | string | 订单号 | -- |
| qty | float | 数量(自动向下调整到可交易数量) | -- |
| price | float | 价格 | -- |
| aux_price | float | 触发价格 | -- |
| trail_type | TrailType | 跟踪类型 | -- |
| trail_value | float | 跟踪金额/跟踪比例 | -- |
| trail_spread | float | 指定价差 | -- |
各类订单类型对应的必传参数有所不同,详见下表
| <small><strong>参数名</strong></small> | <small><strong>限价单</strong></small> | <small><strong>市价单</strong></small> | <small><strong>止损市价单</strong></small> | <small><strong>止损限价单</strong></small> | <small><strong>触及市价单(止盈)</strong></small> | <small><strong>触及限价单(止盈)</strong></small> | <small><strong>跟踪止损市价单</strong></small> | <small><strong>跟踪止损限价单</strong></small> |
|---|---|---|---|---|---|---|---|---|
| orderid | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> |
| qty | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> |
| price | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | |||||
| aux_price | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | <div align="center">✓</div> | ||||
| trail_type | <div align="center">✓</div> | <div align="center">✓</div> | ||||||
| trail_value | <div align="center">✓</div> | <div align="center">✓</div> | ||||||
| trail_spread | <div align="center">✓</div> |
✓:必传参数
返回
| 返回类型 | 返回值说明 |
|---|---|
| string | 订单ID |
示例说明
修改指定订单的数量为100股
modify_order(orderid="FH123456789", qty=100, price=None, aux_price=None, trail_type=None, trail_value=None, trail_spread=None)
示例返回值
"FH123456789"