带你学习硬核策略 之 「C++ 版 OKEX合约对冲策略」

带你学习硬核策略 之 「C++ 版 OKEX合约对冲策略」web

提及对冲策略,在各个市场中有多种多样的策略、多种多样的组合、多种多样的思路。咱们从最经典的跨期对冲来初探对冲策略的设计思路、理念。现在,数字货币市场活跃度远比市场造成之初高了不少,也出现了不少合约交易所,提供了大量可套利对冲的机会。现货跨市场套利、期现对冲套利、期货跨期套利、期货跨市场套利等等,策略层出不穷。下面咱们就一块儿 领略一个 由C++语言编写,交易市场 为OKEX合约交易所的「硬核」跨期对冲策略,策略基于「发明者量化交易平台」编写。json

策略原理websocket

为何说策略有些硬核,缘由在于 策略使用C++ 语言编写,策略阅读难度略高。可是并不妨碍读者学习到这个策略设计、思路方面的精华。策略通篇较为简洁,代码长度适中,只有500多行。行情数据获取方面,不一样于以往策略使用 rest 接口,该策略使用了websocket接口,接受交易所行情推送。
设计方面,策略结构合理,代码耦合度很低,很方便扩展或者优化。逻辑思路清晰,这样的设计不只使用、扩展很方便。做为教学策略,学习策略设计也是一个很好的范例。策略原理比较简单,即 远期合约 和近期合约 作正、反套对冲,基本原理上和商品期货的跨期对冲一致。
正套,作空远期合约,作多近期合约。
反套,作多远期合约,作空近期合约。
清楚了基本原理,剩下的就是策略如何触发对冲开仓,如何平仓,如何加仓。仓位控制方式,策略细节处理。
对冲策略主要关注的是标的物差价的波动,对差价作回归交易。然而,差价是有可能小幅震荡,或者大幅震荡,或者单边一个方向。
这就带来了对冲盈亏的不肯定性,可是风险仍是远小于单边趋势的。对于跨期策略的各类优化不少都是选择从仓位控制层面入手,从开仓平仓触发上入手。例如经典的用布林指标作为差价波动时,正套、反套的开仓、平仓点。本策略因为设计合理、耦合度很低,也能够很容易的修改为布林指标跨期对冲策略。

策略代码剖析数据结构

通篇大概看一下代码,能够总结出,代码大概主要分为四个部分。

- 1.枚举值定义,定义一些状态值,用于标记状态。一些和策略思路无关的功能函数,例如 url 编码函数,时间转换函数等,这些函数和策略思路没有关系,仅仅是对于数据作处理使用。
- 2.K线数据生成器类:策略由该生成器类对象生成的K线数据驱动。
- 3.对冲类:该类的对象能够执行具体的交易逻辑,对冲操做、策略细节的处理机制等。
- 4.策略主函数,也就是 main 函数。main 函数是策略的入口函数,主要循环在此函数内执行,此外这个函数内还执行一个重要的操做,即访问交易所的websocket 接口,获取推送来的tick行情数据,做为K线数据生成器的原料数据。socket

经过对策略代码总体上的了解,咱们下面就能够经过逐步剖析各个环节,从而完整的学习该策略的设计、思路、技巧。

枚举值定义,其它功能函数函数

一、枚举类型 State 声明
工具

    enum State {                    // 枚举类型  定义一些 状态
        STATE_NA,                   // 非正常状态
        STATE_IDLE,                 // 空闲
        STATE_HOLD_LONG,            // 持多仓
        STATE_HOLD_SHORT,           // 持空仓
    };

 




由于代码中有些函数返回某个状态,因此这些状态都定义在了枚举类型 State中。
看到代码中出现 STATE_NA 即为 非正常状态, STATE_IDLE 为空闲状态,便可以对冲操做的状态。 STATE_HOLD_LONG 为持有正套对冲仓位的状态。 STATE_HOLD_SHORT 为持有反套对冲仓位的状态。

二、字符串替换,本策略中没有调用,算是一个备用的工具函数,主要处理字符串。

string replace(string s, const string from, const string& to)


三、功能为转换为十六进制字符的函数 toHex

inline unsigned char toHex(unsigned char x)


四、处理url编码的函数

std::string urlencode(const std::string& str)


五、时间转换函数,把字符串格式的时间转换为时间戳。

uint64_t _Time(string &s)


K线数据生成器类
oop

    class BarFeeder {                                                                       // K线 数据生成器类
        public:
            BarFeeder(int period) : _period(period) {                                       // 构造函数,参数为 period 周期, 初始化列表中初始化
                _rs.Valid = true;                                                           // 构造函数体中初始化 K线数据的 Valid属性。
            }    

            void feed(double price, Chart *c=nullptr, int chartIdx=0) {                     // 输入数据,nullptr 空指针类型,chartIdx 索引默认参数为 0
                uint64_t epoch = uint64_t(Unix() / _period) * _period * 1000;               // 秒级时间戳祛除不完整时间周期(不完整的_period 秒数),转为 毫秒级时间戳。
                bool newBar = false;                                                        // 标记 新K线Bar 的标记变量
                if (_rs.size() == 0 || _rs[_rs.size()-1].Time < epoch) {                    // 若是 K线数据 长度为 0 。 或者 最后一bar 的时间戳小于 epoch(K线最后一bar 比当前最近的周期时间戳还要靠前)
                    Record r;                                                               // 声明一个 K线bar 结构
                    r.Time = epoch;                                                         // 构造当前周期的K线bar 
                    r.Open = r.High = r.Low = r.Close = price;                              // 初始化 属性
                    _rs.push_back(r);                                                       // K线bar 压入 K线数据结构
                    if (_rs.size() > 2000) {                                                // 若是K线数据结构长度超过 2000 , 就剔除最先的数据。
                        _rs.erase(_rs.begin());
                    }
                    newBar = true;                                                          // 标记
                } else {                                                                    // 其它状况,不是出现新bar 的状况下的处理。
                    Record &r = _rs[_rs.size() - 1];                                        // 引用 数据中最后一bar 的数据。
                    r.High = max(r.High, price);                                            // 对引用数据的最高价更新操做。
                    r.Low = min(r.Low, price);                                              // 对引用数据的最低价更新操做。
                    r.Close = price;                                                        // 对引用数据的收盘价更新操做。
                }
        
                auto bar = _rs[_rs.size()-1];                                               // 取最后一柱数据 ,赋值给 bar 变量
                json point = {bar.Time, bar.Open, bar.High, bar.Low, bar.Close};            // 构造一个 json 类型数据
                if (c != nullptr) {                                                         // 图表对象指针不等于 空指针,执行如下。
                   if (newBar) {                                                            // 根据标记判断,若是出现新Bar 
                        c->add(chartIdx, point);                                            // 调用图表对象成员函数add,向图表对象中插入数据(新增K线bar)
                        c->reset(1000);                                                     // 只保留1000 bar的数据
                    } else {
                        c->add(chartIdx, point, -1);                                        // 不然就更新(不是新bar),这个点(更新这个bar)。
                    } 
                }
            }
            Records & get() {                                                               // 成员函数,获取K线数据的方法。
                return _rs;                                                                 // 返回对象的私有变量 _rs 。(即 生成的K线数据)
            }
        private:
            int _period;
            Records _rs;
    };

 


这个类主要就是负责把获取到的 tick 数据加工成差价K线,用于驱动策略对冲逻辑。
可能有的读者有疑问,为何要用 tick 数据呢?为何要构造一个 这样的K线数据生成器呢?直接用K线数据很差么?这样的疑问三连发,在我当初写一些对冲策略的时候也有迸发出来过。在写过差价布林对冲策略时就找到了答案。因为单个合约的K线数据是这一个合约在必定周期内的价格变化统计。
而两个合约的差价 的K线数据则是在必定周期内的差价价格变化统计,所以不能简单的拿两个合约各自的K线数据作减法运算,计算每根K线Bar上各个数据的差值,当作差价。这样最明显的错误就例如,两个合约的最高价、最低价,并不必定是同一时刻的。因此相减出来的数值没有太大意义。
所以咱们须要使用实时的tick数据,实时计算差价,实时统计成必定周期内的价格变更(即K线柱上的高开低收)。这样咱们就须要一个K线数据生成器,单独做为一个类,很好的进行处理逻辑分离。

对冲类学习

    class Hedge {                                                                           // 对冲类,策略主要逻辑。
      public:
        Hedge() {                                                                           // 构造函数
            ...
        };
        
        State getState(string &symbolA, Depth &depthA, string &symbolB, Depth &depthB) {        // 获取状态,参数: 合约A名称 、合约A深度数据, 合约B名称、 合约B深度数据
            
            ...
        }
        bool Loop(string &symbolA, Depth &depthA, string &symbolB, Depth &depthB, string extra="") {       // 开平仓 策略主要逻辑
            
            ...
        }    

      private:
        vector<double> _addArr;                                     // 对冲加仓列表
        string _state_desc[4] = {"NA", "IDLE", "LONG", "SHORT"};    // 状态值 描述信息
        int _countOpen = 0;                                 // 开仓次数
        int _countCover = 0;                                // 平仓次数
        int _lastCache = 0;                                 // 
        int _hedgeCount = 0;                                // 对冲次数
        int _loopCount = 0;                                 // 循环计数(循环累计次数)
        double _holdPrice = 0;                              // 持仓价格
        BarFeeder _feederA = BarFeeder(DPeriod);            // A合约 行情 K线生成器
        BarFeeder _feederB = BarFeeder(DPeriod);            // B合约 行情 K线生成器
        State _st = STATE_NA;                               // 对冲类型 对象的 对冲持仓状态
        string _cfgStr;                                     // 图表配置 字符串
        double _holdAmount = 0;                             // 持仓量
        bool _isCover = false;                              // 是否平仓 标记
        bool _needCheckOrder = true;                        // 设置是否 检查订单
        Chart _c = Chart("");                               // 图表对象,并初始化
    };

 



因为代码比较长,省略了一部分,主要显示一下这个对冲类的结构,构造函数Hedge就不说了,主要是对象初始化。剩下,主要有2个功能函数。
- getState

这个函数主要处理订单检测,订单撤销,仓位检测,仓位平衡等工做。由于在对冲交易过程当中,是避免不了单腿的状况(即一个合约成交了,一个合约没有成交),若是在下单逻辑中进行检测,而后处理追单或者平仓,策略逻辑会比较乱。因此设计这部分的时候采起了另外一种思路。若是触发对冲操做,下单一次,不管是否出现单腿对冲的状况,默认是对冲成功了,而后在getState函数中检测仓位平衡,独立出来检测处理平衡的这个逻辑。

- Loop

策略的交易逻辑封装在这个函数中,其中调用 getState , 使用K线数据生成器对象生成 差价的K线数据,进行对冲开仓、平仓、加仓逻辑的判断。还有一些对于图表的数据更新操做。

策略主函数优化

 

    void main() {  
    
        ...
        
        string realSymbolA = exchange.SetContractType(symbolA)["instrument"];    // 获取设置的A合约(this_week / next_week / quarter ) ,在 OKEX 合约 当周、次周、季度 对应的真实合约ID 。
        string realSymbolB = exchange.SetContractType(symbolB)["instrument"];    // ...
        
        string qs = urlencode(json({{"op", "subscribe"}, {"args", {"futures/depth5:" + realSymbolA, "futures/depth5:" + realSymbolB}}}).dump());    // 对 ws 接口的要传的参数进行 json 编码、 url 编码
        Log("try connect to websocket");                                                                                                            // 打印链接 WS接口的信息。
        auto ws = Dial("wss://real.okex.com:10442/ws/v3|compress=gzip_raw&mode=recv&reconnect=true&payload="+qs);     // 调用FMZ API Dial 函数 访问  OKEX 期货的 WS 接口
        Log("connect to websocket success");
        
        Depth depthA, depthB;                               // 声明两个 深度数据结构的变量 用于储存A合约和B合约 的深度数据
        auto fillDepth = [](json &data, Depth &d) {         // 用接口返回的json 数据,构造 Depth 数据的代码。
            d.Valid = true;
            d.Asks.clear();
            d.Asks.push_back({atof(string(data["asks"][0][0]).c_str()), atof(string(data["asks"][0][1]).c_str())});
            d.Bids.clear();
            d.Bids.push_back({atof(string(data["bids"][0][0]).c_str()), atof(string(data["bids"][0][1]).c_str())});
        };
        string timeA;   // 时间 字符串 A 
        string timeB;   // 时间 字符串 B 
        while (true) {
            auto buf = ws.read();                           // 读取 WS接口 推送来的数据
            
            ...
            
    }

 




策略启动后是从main 函数开始执行,策略在main 函数的初始化工做中,订阅了websocket 接口的tick行情。main 函数最主要的工做就是构造了一个主循环,不停的接收交易所websocket 接口推送来的tick行情,而后调用对冲类对象的成员函数: Loop 函数。由行情数据 驱动 Loop 函数中的交易逻辑。
须要说明的一点,上文中说道的tick行情,实际是订阅的订单薄深度数据接口,获取的是每档的订单薄数据。可是策略中只是使用了第一档的数据,其实就和tick行情数据差很少了,策略中并无用其它档的数据,也没有用第一档的订单量数值。
详细看下 策略是如何订阅 websocket 接口的数据,又是如何设置的。


string qs = urlencode(json({{"op", "subscribe"}, {"args", {"futures/depth5:" + realSymbolA, "futures/depth5:" + realSymbolB}}}).dump());
Log("try connect to websocket");
auto ws = Dial("wss://real.okex.com:10442/ws/v3|compress=gzip_raw&mode=recv&reconnect=true&payload="+qs);
Log("connect to websocket success");


首先要对订阅的接口所传的订阅消息 json 参数进行 url 编码,也就是 payload 参数的值。而后比较重要的一步就是调用 发明者量化交易平台的 API 接口函数 Dial 函数。Dial 函数可用于访问交易所 websocket 接口。咱们这里进行一些设置,让即将建立的 websocket 链接控制对象 ws 具备断线自动重连(订阅消息依然使用 payload 参数的值 qs字符串),实现这个功能就须要在 Dial 函数的参数字符串中增长配置选项。

Dial函数参数的开头部分以下:


wss://real.okex.com:10442/ws/v3

是须要访问的websocket接口地址,以后用 | 分隔。
compress=gzip_raw&mode=recv&reconnect=true&payload="+qs 都是配置参数。

这样设置后,即便websocket 链接断开,发明者量化交易平台 托管者底层系统也会进行自动重连,及时地获取到最新的行情数据。
抓住每次差价波动,快速捕获到合适的对冲行情。

仓位控制

仓位控制采用相似 「波菲纳契」数列的对冲仓位比例,进行控制。

  for (int i = 0; i < AddMax + 1; i++) {                                          // 构造 控制加仓数量的数据结构,相似 波菲纳契数列 对冲数量 比例。
      if (_addArr.size() < 2) {                                                   // 前两次加仓量变化为: 加一倍对冲数量 递增
          _addArr.push_back((i+1)*OpenAmount);
      }
      _addArr.push_back(_addArr[_addArr.size()-1] + _addArr[_addArr.size()-2]);   // 最后 两个加仓数量相加,算出当前的加仓数量储存到 _addArr数据结构中。
  }

 



能够看到每次增长的加仓仓位数量都是最近的上两个仓位的和。
这样的仓位控制能够实现差价越大,套利对冲数量相对增长,对仓位进行分散,从而把握住小差价波动小仓位,大差价波动仓位适当增大。

平仓:止损止盈

固定的止盈差价,止损差价。
持仓差价到达止盈位置、止损位置即进行止盈、止损。

入市、离市 周期设计

参数 NPeriod 控制的周期对策略的开仓平仓进行必定的动态控制。

策略图表

策略自动生成差价 K线图表,标记相关交易信息。

C++策略自定义图表画图操做,也很是简便,能够看到在 对冲类的构造函数中,咱们使用了写好的图表配置字符串_cfgStr配置给了图表对象_c , _c 是对冲类 私有成员初始化时调用发明者量化自定义图表API接口函数 Chart 函数构造的图表对象。

  _cfgStr = R"EOF(
  [{
  "extension": { "layout": "single", "col": 6, "height": "500px"},
  "rangeSelector": {"enabled": false},
  "tooltip": {"xDateFormat": "%Y-%m-%d %H:%M:%S, %A"},
  "plotOptions": {"candlestick": {"color": "#d75442", "upColor": "#6ba583"}},
  "chart":{"type":"line"},
  "title":{"text":"Spread Long"},
  "xAxis":{"title":{"text":"Date"}},
  "series":[
      {"type":"candlestick", "name":"Long Spread","data":[], "id":"dataseriesA"},
      {"type":"flags","data":[], "onSeries": "dataseriesA"}
      ]
  },
  {
  "extension": { "layout": "single", "col": 6, "height": "500px"},
  "rangeSelector": {"enabled": false},
  "tooltip": {"xDateFormat": "%Y-%m-%d %H:%M:%S, %A"},
  "plotOptions": {"candlestick": {"color": "#d75442", "upColor": "#6ba583"}},
  "chart":{"type":"line"},
  "title":{"text":"Spread Short"},
  "xAxis":{"title":{"text":"Date"}},
  "series":[
      {"type":"candlestick", "name":"Long Spread","data":[], "id":"dataseriesA"},
      {"type":"flags","data":[], "onSeries": "dataseriesA"}
      ]
  }
  ]
  )EOF";
  _c.update(_cfgStr);                 // 用图表配置 更新图表对象
  _c.reset();                         // 重置图表数据。

 




- 调用 _c.update(_cfgStr); 使用 _cfgStr 配置到图表对象。
- 调用 _c.reset(); 重置图表数据。

在策略代码须要给图表插入数据时,也是经过 直接调用 _c 对象的成员函数,或者 把 _c 的引用做为参数传递,进而调用_c的对象成员函数(方法)去进行图表数据更新,插入操做。
例如:

_c.add(chartIdx, {{"x", UnixNano()/1000000}, {"title", action}, {"text", format("diff: %f", opPrice)}, {"color", color}});

下单交易后,在K线图表上打上标签记录。

以下,绘制K线是经过 调用 BarFeeder 类的 成员函数 feed 时,把图表对象 _c 的引用 做为参数 传入。

void feed(double price, Chart *c=nullptr, int chartIdx=0)

即feed函数的形参 c 。

  json point = {bar.Time, bar.Open, bar.High, bar.Low, bar.Close};            // 构造一个 json 类型数据
  if (c != nullptr) {                                                         // 图表对象指针不等于 空指针,执行如下。
     if (newBar) {                                                            // 根据标记判断,若是出现新Bar 
          c->add(chartIdx, point);                                            // 调用图表对象成员函数add,向图表对象中插入数据(新增K线bar)
          c->reset(1000);                                                     // 只保留1000 bar个数据
      } else {
          c->add(chartIdx, point, -1);                                        // 不然就更新(不是新bar),这个点(更新这个bar)。
      } 
  }

 



经过调用 图表对象 _c 的add成员函数,向图表中插入新的K线Bar数据。
代码:c->add(chartIdx, point);

回测


本策略仅为学习交流使用,实盘使用时请根据实盘实际状况,自行修改优化。

策略地址:https://www.fmz.com/strategy/163447

更多有趣的策略尽在「发明者量化交易平台」 : https://www.fmz.com

相关文章
相关标签/搜索