Skip to main content
GET
Get an event and all contracts under it

Overview

An event is one real-world question (for example HORC_1126). The contracts under it are the individual tradable outcomes or strikes. This endpoint returns the event’s metadata plus the full contract list in one response.

This is the current view

Search reads a full-text index that trails the catalogue by seconds. This endpoint reads the catalogue itself. Anything that must be current — in particular state and tradable — should be read here, using the symbol from a search hit as the key, rather than taken from the hit.

Response

data.event carries the event, data.contracts the array of contracts:

Fields worth knowing

Example

Errors

  • 400 — eventId missing or malformed
  • 404 — no event with that ID
  • 500 — unexpected server error

Path Parameters

eventId
string
required
Example:

"HORC_1126"

Response

Event with its contracts

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

success
boolean
required
Example:

true

data
object