Documentation IndexFetch the complete documentation index at: /llms.txtUse this file to discover all available pages before exploring further.
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
You are viewing documentation for Polymarket US
Retrieve and filter events
list(params?)
GET /v1/events
retrieve(id)
GET /v1/events/{id}
retrieveBySlug(slug)
GET /v1/events/slug/{slug}
const events = await client.events.list({ limit: 10, offset: 0, active: true, categories: ['sports', 'crypto'], }); for (const event of events.events) { console.log(`${event.title} - ${event.markets?.length ?? 0} markets`); }
limit
offset
active
closed
archived
featured
categories
seriesId
live
ended
id
slug
title
description
category
markets
const event = await client.events.retrieve(12345); console.log(`Title: ${event.title}`); console.log(`Category: ${event.category}`); console.log(`Markets: ${event.markets?.length ?? 0}`);
const event = await client.events.retrieveBySlug('super-bowl-2025'); console.log(`Title: ${event.title}`); for (const market of event.markets ?? []) { console.log(` - ${market.title}: ${market.slug}`); }
gameId
score
period
participants
const events = await client.events.list({ live: true, categories: ['sports'] }); for (const event of events.events) { if (event.live) { console.log(`${event.title}: ${JSON.stringify(event.score)}`); } }
