ReqOrderInsert
报单录入请求,录入错误时对应响应OnRspOrderInsert、OnErrRtnOrderInsert,正确时对应回报OnRtnOrder、OnRtnTrade。
可以录入限价单、市价单、备兑等交易所支持的指令,撤单时使用ReqOrderAction。
不支持预埋单、条件单录入。
1.函数原型
virtual int ReqOrderInsert(CThostFtdcInputOrderField *pInputOrder, int nRequestID) = 0;
2.参数
pInputOrder:输入报单
| 字段类型 | 字段名称 | 含义 | 值 |
|---|---|---|---|
| TThostFtdcBrokerIDType | BrokerID | 经纪公司代码 | 必填 |
| TThostFtdcInvestorIDType | InvestorID | 投资者代码 | 必填 |
| TThostFtdcInstrumentIDType | InstrumentID | 合约代码 | 必填 |
| TThostFtdcOrderRefType | OrderRef | 报单引用 | 可自定义或不填 |
| TThostFtdcUserIDType | UserID | 用户代码 | 无 |
| TThostFtdcCombOffsetFlagType | CombOffsetFlag | 开平标志 | 必填 |
| TThostFtdcCombHedgeFlagType | CombHedgeFlag | 投机套保标志 | 必填 |
| TThostFtdcDateType | GTDDate | GTD日期 | 无 |
| TThostFtdcBusinessUnitType | BusinessUnit | 业务单元 | 无 |
| TThostFtdcExchangeIDType | ExchangeID | 交易所代码 | 无 |
| TThostFtdcInvestUnitIDType | InvestUnitID | 投资单元代码 | 无 |
| TThostFtdcAccountIDType | AccountID | 投资者帐号 | 无 |
| TThostFtdcCurrencyIDType | CurrencyID | 币种代码 | 无 |
| TThostFtdcClientIDType | ClientID | 客户代码 | 无 |
| TThostFtdcIPAddressType | IPAddress | IP地址 | 无 |
| TThostFtdcMacAddressType | MacAddress | Mac地址 | 无 |
| TThostFtdcVolumeType | VolumeTotalOriginal | 数量 | 必填 |
| TThostFtdcVolumeType | MinVolume | 最小成交量 | 无 |
| TThostFtdcBoolType | IsAutoSuspend | 自动挂起标志 | 必填 |
| TThostFtdcRequestIDType | RequestID | 请求编号 | 无 |
| TThostFtdcBoolType | UserForceClose | 用户强评标志 | 必填 |
| TThostFtdcBoolType | IsSwapOrder | 互换单标志 | 必填 |
| TThostFtdcOrderPriceTypeType | OrderPriceType | 报单价格条件 | 必填 |
| TThostFtdcDirectionType | Direction | 买卖方向 | 必填 |
| TThostFtdcTimeConditionType | TimeCondition | 有效期类型 | 必填 |
| TThostFtdcVolumeConditionType | VolumeCondition | 成交量类型 | 必填 |
| TThostFtdcContingentConditionType | ContingentCondition | 触发条件 | 必填 |
| TThostFtdcForceCloseReasonType | ForceCloseReason | 强平原因 | 必填 |
| TThostFtdcPriceType | LimitPrice | 价格 | 必填 |
| TThostFtdcPriceType | StopPrice | 止损价 | 无 |
OrderPriceType:确定输入的报单类型。比如限价单则填写THOST_FTDC_OPT_LimitPrice、市价单则填写THOST_FTDC_OPT_BestPrice。
Direction:确定买卖方向。
CombOffsetFlag:确定开平标志。
CombHedgeFlag:确定投机套保标志。个股期权只支持投机或者备兑。备兑只支持认购期权的卖开或买平。
TimeCondition:确定报单有效期类型 。
VolumeCondition:确定成交量类型。
ContingentCondition:确定触发条件。
ForceCloseReason:普通用户下单填写THOST_FTDC_FCC_NotForceClose 非强平。
UserForceClose:填0或者1,或者不填。
IsSwapOrder:填0。
IsAutoSuspend:填0。
OrderRef:OrderRef是本地会话全局唯一编号,必须保持递增;可由用户维护,也可由系统自动填写。一定为数字。
nRequestID:请求ID,对应响应里的nRequestID,无递增规则,由用户自行维护。
3.返回
0,代表成功。
-1,表示网络连接失败;
-2,表示未处理请求超过许可数;
-3,表示每秒发送请求数超过许可数。
4.调用示例
//限价单:
OrderInsert()
{
CThostFtdcInputOrderField OrderField;
memset(&OrderField, 0, sizeof(OrderField));
strcpy(OrderField.BrokerID, "8888");
strcpy(OrderField.InvestorID, "880002");
strcpy(OrderField.InstrumentID, "11008766");
strcpy(OrderField.OrderRef, "");
OrderField.OrderPriceType=THOST_FTDC_OPT_LimitPrice;
OrderField.Direction = THOST_FTDC_D_Sell;
OrderField.CombOffsetFlag[0]= THOST_FTDC_OF_Open;
OrderField.CombHedgeFlag[0]=THOST_FTDC_HF_Speculation;
OrderField.LimitPrice = 0.315;
OrderField.VolumeTotalOriginal = 1;
OrderField.TimeCondition = THOST_FTDC_TC_GFD;
OrderField.VolumeCondition = THOST_FTDC_VC_AV;
OrderField.ContingentCondition = THOST_FTDC_CC_Immediately;
OrderField.ForceCloseReason = '0';
OrderField.IsAutoSuspend = 0;
OrderField.IsSwapOrder = 0;
OrderField.UserForceClose = 0;
m_pUserApi->ReqOrderInsert(&OrderField, nRequestID++);
}