Skip to content

Event-contract primary categories and subcategory/competition ​

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

Event-contract primary categories and subcategory/competition tags. Returns category (exchange raw value e.g. SPORTS), category_id, localized name, and tags. Pass category_id from this API into series / competition endpoints. Public symbols use KS. prefix, not OpenD EC. No subscribe required. For series list use quote.event_contract_series; for competition filters use quote.event_contract_filter_competition.

Parameters ​

No parameters.

Example ​

bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/event-contract/category' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response parameters ​

NameTypeDescription
data.categoriesobject[]
data.categories[].categorystringRaw primary category, e.g. SPORTS
data.categories[].category_idintNumeric category id for follow-up filters
data.categories[].category_namestringCategory English name, e.g. Sports
data.categories[].tagsstringRaw subcategory tags, e.g. ['FOOTBALL','NBA']

Errors ​

ret_codeerror.codeDescription
0—Success
-3invalid_parameterMissing or invalid parameter
-8unsupportedNot supported
-10no_dataNo data

Response example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "categories": [
      {
        "category": "example",
        "category_id": 0,
        "category_name": "example",
        "tags": "example"
      }
    ]
  }
}