Skip to main content
The Events resource provides access to event data. Events contain one or more markets and represent the underlying question or competition being predicted.

​
Methods

MethodEndpointDescription
list(params?)GET /v1/eventsList events with filtering
retrieve(id)GET /v1/events/{id}Get event by ID
retrieve_by_slug(slug)GET /v1/events/slug/{slug}Get event by URL slug

​
list

Fetch a paginated list of events with optional filters. 
events = client.events.list({
    "limit": 10,
    "offset": 0,
    "active": True,
    "categories": ["sports", "crypto"],
})

for event in events["events"]:
    print(f"{event['title']} - {len(event.get('markets', []))} markets")

​
Parameters

ParameterTypeDescription
limitintMaximum results to return (default: 100)
offsetintNumber of results to skip for pagination
activeboolFilter by active events
closedboolFilter by closed events
archivedboolFilter by archived events
featuredboolFilter featured events only
categorieslist[str]Filter by category slugs
seriesIdlist[int]Filter by series IDs
liveboolFilter live sports events
endedboolFilter ended sports events

​
Response Fields

FieldTypeDescription
idintUnique event identifier
slugstrURL-friendly identifier
titlestrEvent title
descriptionstrEvent description
categorystrPrimary category
activeboolWhether event is active for trading
closedboolWhether event is closed
marketslistAssociated markets

​
retrieve

Get a single event by its numeric ID. 
event = client.events.retrieve(12345)

print(f"Title: {event['title']}")
print(f"Category: {event['category']}")
print(f"Markets: {len(event.get('markets', []))}")

​
Parameters

ParameterTypeDescription
idintEvent ID

​
retrieve_by_slug

Get an event by its URL slug. Useful when you have the slug from a URL or API response. 
event = client.events.retrieve_by_slug("super-bowl-2025")

print(f"Title: {event['title']}")
for market in event.get("markets", []):
    print(f"  - {market['title']}: {market['slug']}")

​
Parameters

ParameterTypeDescription
slugstrEvent URL slug

​
Sports Event Fields

Sports events include additional real-time data:
FieldTypeDescription
gameIdstrSports provider game ID
liveboolWhether game is in progress
endedboolWhether game has ended
scoreobjectCurrent score
periodstrCurrent period/quarter/half
participantslistTeams or players
events = client.events.list({"live": True, "categories": ["sports"]})

for event in events["events"]:
    if event.get("live"):
        score = event.get("score", {})
        print(f"{event['title']}: {score}")