Appearance
实时报单
PositionOpen
PositionOpen(
const string symbol, // 报单合约代码
const ENUM_ORDER_TYPE order_type, // 报单类型
const long volume, // 报单数量
const double price, // 报单价格
const ulong deviation = ULONG_MAX, // 报单自定义滑点
const double sl = 0.0, // 报单止损价,已失效
const double tp = 0.0, // 报单止盈价,已失效
const int account_index = 0 // 报单账户的序号
) -> bool
功能:按参数配置开仓报单到CTP柜台,报单前有多重检查:是否允许自动交易、账户是否登录、报单合约是否交易时间、报单类型和报单信息是否有效
参数:
symbol:报单合约代码,必须参数
order_type:报单类型,必须参数,ORDER_TYPE_BUY ->买入;ORDER_TYPE_SELL ->卖出
volume:报单数量,必须参数,整数类型
price:报单价格,必须参数,0.0标识市价单
deviation:报单自定义滑点,可选参数,无自定义则默认使用CTrade类的配置信息
sl:报单止损价,可选参数,已失效
tp:报单止盈价,可选参数,已失效
account_index:报单账户的序号,可选参数,单账户默认参数即可,多账户操作需指定账户序号
返回值类型:bool,是否报单成功。报单成功指报单信息被CTP柜台和交易所接收,异步报单,不代表实时成交
PositionClose
PositionClose(
const string symbol, // 报单合约代码
const ENUM_ORDER_TYPE order_type, // 报单类型
const long volume, // 报单数量
const double price, // 报单价格
const long close_type = ORDER_TYPE_EXIT, // 平仓类型
const ulong deviation = ULONG_MAX, // 报单自定义滑点
const int account_index = 0 // 报单账户的序号
) -> bool
功能:按参数配置平仓报单到CTP柜台,报单前有多重检查:是否允许自动交易、账户是否登录、报单合约是否交易时间、报单类型和报单信息是否有效
参数:
symbol:报单合约代码,必须参数
order_type:报单类型,必须参数,ORDER_TYPE_BUY ->买入;ORDER_TYPE_SELL ->卖出
volume:报单数量,必须参数,整数类型
price:报单价格,必须参数,0.0标识市价单
close_type:平仓类型,可选参数,ORDER_TYPE_EXIT(-1) ->平仓;ORDER_TYPE_EXITTODAY(-2) ->平今仓;上交所和能源所需要指定平仓的今仓或昨仓,其他交易所使用默认值即可
deviation:报单自定义滑点,可选参数,无自定义则默认使用CTrade类的配置信息
account_index:报单账户的序号,可选参数,单账户默认参数即可,多账户操作需指定账户序号
返回值类型:bool,是否报单成功。报单成功指报单信息被CTP柜台和交易所接收,异步报单,不代表实时成交
PositionClose(
const string ticket, // CTP持仓标识
const long volume, // 报单数量
const double price, // 报单价格
const ulong deviation = ULONG_MAX // 报单自定义滑点
) -> bool
功能:使用[CTP持仓]标识指定平仓的快捷实时平仓指令
参数:
ticket:[CTP持仓]标识,必须参数
volume:报单数量,必须参数,整数类型,0标识全部平仓
price:报单价格,必须参数,0.0标识市价单
deviation:报单自定义滑点,可选参数,无自定义则默认使用CTrade类的配置信息
返回值类型:bool,是否报单成功。报单成功指报单信息被CTP柜台和交易所接收,异步报单,不代表实时成交
PositionClose(
const int pos, // CTP持仓序号,序号从1开始
const long volume, // 报单数量
const double price, // 报单价格
const ulong deviation = ULONG_MAX // 报单自定义滑点
) -> bool
功能:使用[CTP持仓]序号指定平仓的快捷实时平仓指令
参数:
pos:[CTP持仓]序号,序号从1开始,必须参数
volume:报单数量,必须参数,整数类型,0标识全部平仓
price:报单价格,必须参数,0.0标识市价单
deviation:报单自定义滑点,可选参数,无自定义则默认使用CTrade类的配置信息
返回值类型:bool,是否报单成功。报单成功指报单信息被CTP柜台和交易所接收,异步报单,不代表实时成交
PositionModify(已失效)
PositionModify(const string ticket, const double sl, const double tp) -> bool
功能:修改指定[CTP持仓]标识的止损价、止盈价,已失效,止损止盈功能迁移到[MT5持仓]操作
参数:
ticket:[CTP持仓]标识,必须参数
sl:止损价,必须参数
tp:止盈价,必须参数
返回值类型:bool
PositionModify(const int pos, const double sl, const double tp) -> bool
功能:修改指定[CTP持仓]序号的止损价、止盈价,已失效,止损止盈功能迁移到[MT5持仓]操作
参数:
pos:[CTP持仓]序号,序号从1开始,必须参数
sl:止损价,必须参数
tp:止盈价,必须参数
返回值类型:bool
PositionAuto
PositionAuto(
const string symbol, // 报单合约代码
const ENUM_ORDER_TYPE order_type, // 报单类型
const long volume, // 报单数量
const double price, // 报单价格
const ulong deviation = ULONG_MAX, // 报单自定义滑点
const int account_index = 0 // 报单账户的序号
) -> bool
功能:开平仓自动适配的报单,先平仓剩余部分开仓,上交所和能源所平今仓优先
参数:
symbol:报单合约代码,必须参数,'NULL'或空字符串指图表合约
order_type:报单类型,必须参数,ORDER_TYPE_BUY ->买入;ORDER_TYPE_SELL ->卖出
volume:报单数量,必须参数,整数类型
price:报单价格,必须参数,0.0标识市价单
deviation:报单自定义滑点,可选参数,无自定义则默认使用CTrade类的配置信息
account_index:报单账户的序号,可选参数,单账户默认参数即可,多账户操作需指定账户序号
返回值类型:bool,是否报单成功。报单成功指报单信息被CTP柜台和交易所接收,异步报单,不代表实时成交
Buy
Buy(
const string symbol, // 报单合约代码
const long volume, // 报单数量
double price, // 报单价格
const double sl = 0.0, // 报单止损价,已失效
const double tp = 0.0, // 报单止盈价,已失效
const int account_index = 0 // 报单账户的序号
) -> bool
功能:快捷买入开仓报单
参数:
symbol:报单合约代码,必须参数,'NULL'或空字符串指图表合约
volume:报单数量,必须参数,整数类型
price:报单价格,必须参数,0.0标识市价单
sl:报单止损价,可选参数,已失效
tp:报单止盈价,可选参数,已失效
account_index:报单账户的序号,可选参数,单账户默认参数即可,多账户操作需指定账户序号
返回值类型:bool,是否报单成功。报单成功指报单信息被CTP柜台和交易所接收,异步报单,不代表实时成交
Sell
Sell(
const string symbol, // 报单合约代码
const long volume, // 报单数量
double price, // 报单价格
const double sl = 0.0, // 报单止损价,已失效
const double tp = 0.0, // 报单止盈价,已失效
const int account_index = 0 // 报单账户的序号
) -> bool
功能:快捷卖出开仓报单
参数:
symbol:报单合约代码,必须参数,'NULL'或空字符串指图表合约
volume:报单数量,必须参数,整数类型
price:报单价格,必须参数,0.0标识市价单
sl:报单止损价,可选参数,已失效
tp:报单止盈价,可选参数,已失效
account_index:报单账户的序号,可选参数,单账户默认参数即可,多账户操作需指定账户序号
返回值类型:bool,是否报单成功。报单成功指报单信息被CTP柜台和交易所接收,异步报单,不代表实时成交
MT5CTP报单指令
| ENUM_ORDER_TYPE_FILLING | 报单价格 price(0.0) | 报单价格 price(>0.0) |
|---|---|---|
| ORDER_FILLING_RETURN | 市价单 | 限价单 |
| ORDER_FILLING_FOK | 市价单 FOK | 限价单 FOK |
| ORDER_FILLING_IOC | 市价单 FAK | 限价单 FAK |
各交易所支持情况:
| 交易所 | 限价单 | 市价单 | 限价单FOK | 市价单FOK | 限价单FAK | 市价单FAK |
|---|---|---|---|---|---|---|
| 中金所期货 | ✅️ | ✅️ | ✅️ | ❌️ | ✅️ | ❌️ |
| 中金所期权 | ✅️ | ❌️ | ✅️ | ❌️ | ✅️ | ❌️ |
| 大商所期货 | ✅️ | ✅️ | ✅️ | ✅️ | ✅️ | ✅️ |
| 大商所期权 | ✅️ | ❌️ | ✅️ | ❌️ | ✅️ | ❌️ |
| 郑商所期货 | ✅️ | ✅️ | ❌️ | ❌️ | ✅️ | ✅️ |
| 郑商所期权 | ✅️ | ✅️ | ✅️ | ✅️ | ✅️ | ✅️ |
| 上期所期货 | ✅️ | ❌️ | ✅️ | ❌️ | ✅️ | ❌️ |
| 上期所期权 | ✅️ | ❌️ | ✅️ | ❌️ | ✅️ | ❌️ |
- 能源所报单指令与上期所一致,交易所没有支持市价单。如果报单指令使用市价单,MT5CTP使用涨跌停价格报单。
- 广期所与大商所报单指令类似。
- 各交易所的报单指令可能会升级和更新,以交易所最新公告为准。
- 以交易所不支持的报单指令报单,交易所会返回报单指令错误信息。
- 中金所的市价单,MT5CTP使用中金所五档市价转限价。
- 上期所期货期权、能源所期货期权和中金所期货期权FAK限价单MT5CTP使用任意成交数量。
- MT5CTP建议报单时优选各交易所都支持的报单指令,避免报单错误。