Skip to main content
GET
Python (SDK)

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

Candidate photos

Every contract carries photo. On an election contract whose candidate has a portrait, it is an object; on every other contract, including non-election contracts and party or chamber-control outcomes, it is null.
  • url is a 256×256 webp.
  • Every photo is freely licensed: public domain, CC0, CC BY or CC BY-SA. Show credit and license with the image, or on a credits page the image links to: the license requires it.
  • These are the same portraits Get Election Map returns.
  • Photos are on staging (https://api.tradearies.dev). On production photo is null until the rollout is announced in the changelog.

Candidate metadata

Every contract carries party, frontRunner, incumbent and candidateStatus. On an election contract they come from the venue’s candidate metadata, refreshed hourly; on every other contract, including party or chamber-control outcomes, all four are null.
Any of the four can be null on an election contract the venue has no value for. These are the same values Get Election Map uses. They are on staging (https://api.tradearies.dev); on production they are null until the rollout is announced in the changelog.

Example

Errors

  • 400 — eventId missing or malformed
  • 404 — no event with that ID, or a conditional one
  • 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