Event-Contract Milestones

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

List currently listed event-contract milestones with category, competition, related-event filters and cursor pagination. Returns real milestone symbols, title, dates, primary event and related events.

Parameters

Parameter	Type	In	Required	Description
category	string	query	no	Raw category, English name or numeric ID; omit for all categories.
competition	string	query	no	Competition value, e.g. NFL; case-insensitive.
related_event	string	query	no	Related event symbol, format KS.<...>.EVENT.
page_flag	string	query	no	Cursor; omit on the first page and pass back pagination.page_flag.
page_size	int	query	no	Page size, default and maximum 200.

Request Example

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

Response Fields

Field	Type	Description
code	int	0 for success; non-zero business error code.
message	string	success on success; error text on failure.
trace_id	string	Request trace ID returned on failure.
data.milestones[].milestone_code	string	Real KS milestone symbol.
data.milestones[].title	string	English milestone title.
data.milestones[].category_id	int	Category ID.
data.milestones[].competition	string	Raw competition value.
data.milestones[].type	int	Raw MilestoneType enum value.
data.milestones[].start_date	string	Start time, UTC ISO8601.
data.milestones[].end_date	string	End time, UTC ISO8601.
data.milestones[].primary_event_code	string	Primary event KS symbol.
data.milestones[].related_events	string[]	Valid related-event KS symbols.
data.milestones[].notification_message	string	English notification text.

Error Codes

code	message	trace_id	Trigger
0	success	—	Success; no matches return an empty list.
-3	invalid parameter	Returned by the API	Use the event-contract events or category API to discover valid symbols.

Response Example

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

Failure response

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