Skip to main content
GET
List prediction market categories

Overview

Every base event carries the venue’s categories, broadest first: category, subcategory, then region (see categoryLevels on Get Base Event). This endpoint returns those categories as one tree, so you can show them without walking every base event.

Identify a category by its path

Level names repeat under different parents. United States, for example, sits under many categories. So each node carries a path: every level from the top down to that node, joined by >. Pass a node’s path unchanged to Search Prediction Market as category. Search then returns that category and everything under it. Don’t build paths yourself; always take them from this endpoint.

What the tree contains

  • Only categories with at least one ACTIVE contract. A category whose contracts have all expired or been withdrawn drops out, so every category in the tree finds something when you search it.
  • Each level is ordered by name.
  • With no active contracts, categories is an empty array.
The tree is read from the search index, which trails the catalogue by seconds.

Response

Examples

List the category tree

Search one category picked from the tree

Errors

  • 502: the search index was unavailable

Response

The category tree; empty when no contract is active

Standard success envelope used by all success responses. data is endpoint-specific.

success
boolean
required
Example:

true

data
object