事件合約里程碑列表

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": ""
}