期货相关性

GET /api/v1.0/quote/{symbol}/future/correlation

获取期货与最多 4 个相关期货的相关系数时间序列。 related_codes 必填，逗号分隔。cycle 为计算窗口，range 为返回时间范围。 相关系数已还原到 [-1, 1]。

请求参数

参数	类型	位置	必填	说明
symbol	string	路径	是	期货代码（路径参数），例: US.CLmain
related_codes	string	查询	是	相关期货代码，逗号分隔，最多 4 个，例: US.GCmain,US.ESmain
cycle	string	查询	否	统计窗口：THREE_MONTH=三个月（默认）/ SIX_MONTH=六个月 / ONE_YEAR=一年 / THREE_YEAR=三年
range	string	查询	否	返回时间范围：ONE_DAY=近一天 / THREE_MONTH / SIX_MONTH / ONE_YEAR=近一年（默认）/ THREE_YEAR
page_size	int	查询	否	每条相关期货返回的点数，默认 30，最大 200
page_flag	string	查询	否	翻页标记。首页不传；下一页回传 pagination.page_flag

请求示例

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/future/correlation?related_codes=1&cycle=1&range=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

响应参数

参数	类型	说明
data.items	object[]
data.total	integer	时间范围内的总点数（以最长序列为准）
data.items[].code	integer	主期货代码
data.items[].related_code	integer	相关期货代码
data.items[].points	object	相关系数时间序列
data.items[].points[].timestamp	integer	时点（Unix 秒，东八区对齐）
data.items[].points[].correlation	string	相关系数
pagination.completed	string	是否已覆盖请求时间范围内全部点
pagination.page_flag	string	下一页起始下标。completed 为 true 时为空串

错误码

ret_code	error.code	说明
0	—	成功
-3	invalid_parameter	参数缺失或不在允许范围内
-7	invalid_symbol	标的不存在
-8	unsupported	市场或品类不支持
-9	permission_denied	没有对应权限
-10	no_data	没有可返回的数据
-11	rate_limited	调用过于频繁

响应示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "total": "example",
    "items": [
      {
        "code": 0,
        "related_code": 0,
        "points": "example"
      }
    ]
  },
  "pagination": {
    "completed": true,
    "page_flag": ""
  }
}