跳转至

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++);
}

5.FAQ