Futures Seasonality

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

Futures seasonality. period=MONTH (default) or DAY. One series per year; the series without year is the historical mean. Prices unscaled; some points may be timestamp-only placeholders.

Request

Parameter	Type	In	Required	Description
symbol	string	path	yes	Futures symbol (path param), e.g. US.CLmain
period	string	query	no	Seasonality grain. MONTH is default, DAY is daily

Example

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

Response

Field	Type	Description
data.items	object[]
data.items[].year	integer	Year; omitted on the historical-mean series
data.items[].points	object	Seasonal points for this year or the mean series
data.items[].points[].timestamp	integer	Timestamp, unix seconds (UTC+8 aligned)
data.items[].points[].close	string	Close price
data.items[].points[].prev_close	string	Previous close

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "year": 0,
        "points": "example"
      }
    ]
  }
}