Description

Get a list of canonical event IDs for a given category. Each ID represents a single real-world event that OpticOdds has matched across prediction market platforms (Kalshi, Polymarket). Pass the returned IDs to the /prediction-markets/canonical-events endpoint to retrieve the full event details.

Specific Parameter Information

For a full list of parameters, scroll to the bottom of this page.

You must pass a category. Authenticate with the X-Api-Key header.

category

(Required.) The category to list events for. Must be one of the values returned by /prediction-markets/categories (e.g. politics).

include_latencies

(Optional.) When set to true, a latencies object is added to the response for performance monitoring. Defaults to false.

Example Responses

Canonical Event IDs

URL: https://api.opticodds.com/api/v3/prediction-markets/canonical-events/ids?category=politics&include_latencies=true

{
  "latencies": {
    "total": 0.0435
  },
  "data": [
    "0084abc100ac5f34988afb271ce21392",
    "00eee8b073cc5a8186937783779206d3",
    "01064646d1d654c5be8c77d1c45ef799"
  ]
}

Note: latencies is only present when include_latencies=true.