跳转至

ReqOffsetSetting

对冲设置请求,对应响应:对冲设置请求响应OnRspOffsetSetting,对冲设置通知OnRtnOffsetSetting,对冲设置错误回报OnErrRtnOffsetSetting

大商所二阶段行权优化详见大商所行权优化二阶段业务

注意:该接口仅适用大商所

1. 函数原型

virtual int ReqOffsetSetting(CThostFtdcInputOffsetSettingField *pInputOffsetSetting, int nRequestID) = 0;

2. 参数

pInputOffsetSetting:输入的对冲设置

字段类型字段名称含义
TThostFtdcBrokerIDType BrokerID 经纪公司代码 必填
TThostFtdcInvestorIDType InvestorID 投资者代码 必填
TThostFtdcInstrumentIDType InstrumentID 合约代码 见示例
TThostFtdcInstrumentIDType UnderlyingInstrID 标的期货合约代码 见示例
TThostFtdcProductIDType ProductID 产品代码 见示例
TThostFtdcOffsetTypeType OffsetType 对冲类型 必填
TThostFtdcVolumeType Volume 申请对冲的合约数量 必填
TThostFtdcBoolType IsOffset 是否对冲 必填
TThostFtdcRequestIDType RequestID 请求编号
TThostFtdcUserIDType UserID 用户代码 必填
TThostFtdcExchangeIDType ExchangeID 交易所代码 必填"DCE"
TThostFtdcIPAddressType IPAddress IP地址
TThostFtdcMacAddressType MacAddress Mac地址

关于InstrumentID、UnderlyingInstrID、ProductID填写规范

(1)期权对冲,选填InstrumentID(期权合约)、UnderlyingInstrID(标的期货合约)、ProductID(期权产品)三个字段,至少一个不为空;

(2)期货对冲,选填InstrumentID(期货合约)、ProductID(期货品种)字段,UnderlyingInstrID字段不填;

(3)行权后对冲、履约后对冲,选填UnderlyingInstrID(标的期货合约),ProductID(期权品种)字段,InstrumentID不填;

Volume:设置合约级别的期权对冲和期货对冲且IsOffset=true时,要求填入的Volume在[1,99999999]区间内,其他情况不检查手数字段,99999999表示全部手数。

RequestID:对于同一“投资者+对冲粒度+对冲类型”的对冲,后台只会保留一笔;若用户需要区分每笔不同的报单,建议使用RequestID字段区分,此字段只做回显,不做其他检查。

例:

(1)期权对冲

品种级别对冲:ProductID需要填具体,UnderlyingInstrID、InstrumentID为空

期权系列级别对冲:ProductID为空或具体,UnderlyingInstrID需要填具体,InstrumentID为空

合约级别对冲:ProductID、UnderlyingInstrID为空或者具体,InstrumentID需要填具体,Volume在[1,99999999]区间内,99999999表示全部手数

(2)行权后对冲、履约后对冲

客户级别对冲:ProductID、UnderlyingInstrID为空

品种级别对冲:ProductID需要填具体,UnderlyingInstrID为空

合约级别对冲:ProductID为空或者具体,UnderlyingInstrID为具体

(3)期货对冲

客户级别对冲:ProductID、InstrumentID为空

品种级别对冲:ProductID需要填具体,InstrumentID为空

合约级别对冲:ProductID为空或者具体,InstrumentID需要填具体,Volume在[1,99999999]区间内,99999999表示全部手数

3. 返回

0,代表成功。

-1,表示网络连接失败;

-2,表示未处理请求超过许可数;

-3,表示每秒发送请求数超过许可数。

4. 调用示例

// 合约级别对冲
CThostFtdcInputOffsetSettingField a = { 0 };
strcpy_s(a.BrokerID, "9999");
strcpy_s(a.InvestorID, "00001");
strcpy_s(a.InstrumentID, "a2507-C-3850");
strcpy_s(a.UnderlyingInstrID, "a2507");
strcpy_s(a.ProductID, "a_o");
a.OffsetType = THOST_FTDC_OT_OPT_OFFSET;
a.Volume = 1;
a.IsOffset = 1;
strcpy_s(a.UserID, "00001");
strcpy_s(a.ExchangeID, "DCE");
m_pUserApi->ReqOffsetSetting(&a, 1);

5. FAQ