---
title: "Event Contract Categories"
method: GET
path: "/forecast/category/tree"
tags: ["tradingEventContracts"]
---

# Event Contract Categories

`GET /forecast/category/tree`

Returns the category names, parent ids, and markets for Event Contracts.

## Response `200`

Returns a list of category identifiers and name to be used for more granular contract discovery.

- CategoryTreeResponse
  - `categories` CategoryTreeResponseCategories — A JSON object containing all category IDs and their relevant information.
    - `categoryId` CategoryTreeResponseCategoriesCategoryId — Category identifier.
      - `name` string — Category name.
      - `parent_id` string — Identifier of parent category (if applicable).
      - `markets` unknown[] — List of affiliated markets (if applicable).
        - unknown

## Other responses

- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — internal server error, returned when incoming request cannot be processed. It can sometimes include subset of bad requests. For example, wrong accountId passed and it can only be detected later in handling request. Error contains reason of the problem.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)