事件合约里程碑列表

GET /api/v1.0/quote/event-contract/milestones

获取当前上架的事件合约里程碑，支持分类、赛事和关联事件筛选，并使用游标分页。返回真实里程碑代码、标题、时间、主事件和关联事件。

请求参数

参数	类型	位置	必填	说明
category	string	查询	否	分类原始值、英文名或数字 ID；不传返回全部分类。
competition	string	查询	否	赛事原值，如 NFL；忽略大小写。
related_event	string	查询	否	关联事件代码，格式 KS.<...>.EVENT。
page_flag	string	查询	否	翻页标记；首页不传，下一页回传 pagination.page_flag。
page_size	int	查询	否	单页条数，默认及最大 200。

请求示例

curl -s "https://webapi.moomoo.com/api/v1.0/quote/event-contract/milestones?page_size=20" \
  -H "Authorization: Bearer <AccessToken>" | jq

响应字段

字段	类型	说明
code	int	成功为 0；失败为非 0 业务错误码。
message	string	成功时为 success；失败时为错误信息。
trace_id	string	失败时由接口返回的请求追踪 ID。
data.milestones[].milestone_code	string	真实里程碑 KS 代码。
data.milestones[].title	string	里程碑英文标题。
data.milestones[].category_id	int	分类 ID。
data.milestones[].competition	string	赛事原值。
data.milestones[].type	int	MilestoneType 原始枚举值。
data.milestones[].start_date	string	开始时间，UTC ISO8601。
data.milestones[].end_date	string	结束时间，UTC ISO8601。
data.milestones[].primary_event_code	string	主事件 KS 代码。
data.milestones[].related_events	string[]	有效关联事件 KS 代码。
data.milestones[].notification_message	string	英文通知文案。

错误码

code	message	trace_id	触发条件
0	success	—	成功；没有匹配项时返回空列表。
-3	invalid parameter	由接口返回	请先通过事件合约事件或分类接口确认筛选值。

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "milestones": [{
      "milestone_code": "KS.example.MILESTONE",
      "title": "Example milestone",
      "category_id": 1,
      "competition": "NFL",
      "type": 1,
      "start_date": "2026-10-16T00:00:00Z",
      "end_date": "2026-10-16T04:00:00Z",
      "primary_event_code": "KS.example.EVENT",
      "related_events": ["KS.example.EVENT"]
    }]
  },
  "pagination": {"completed": true, "page_flag": "", "total": 1}
}

失败响应

{
  "code": -3,
  "message": "invalid parameter",
  "trace_id": ""
}