List matched sports events

Maximum number of matched events to return per page. Range 1–100, default 25.

Opaque cursor from a previous response's pagination.next_cursor (nextCursor in TypeScript, NextCursor in Go). Must be used with the same filter set — a cursor from include_settled=true cannot be replayed against include_settled=false, and a cursor from one league, scheduled_date or participant cannot be replayed under another; either returns 400.

Restrict the list to one league, matched against each event's own league value. Without it every league is listed.

Only the leagues listed here are accepted, case-insensitively. Any other value returns 400 listing them — an unrecognized filter is never ignored, because a silently dropped filter returns a full page that looks filtered.

pagination.total counts only that league's events, and cursors are bound to the filter that created them: replay a next_cursor with the same filters, or start again from the first page.

Restrict the list to the games on one calendar day, as YYYY-MM-DD in America/New_York: the scheduled_date each event publishes. That is the day its event_id ends in, or later for a postponed game. A game that starts at 8:30 PM Eastern on the 20th is on the 20th, although its scheduled_start is on the 21st in UTC.

The default population is today's games plus a one-day grace (see include_settled), so a date further in the past matches nothing unless include_settled=true, which also reads the days of the settled archive. Any value that is not a calendar date in that form returns 400. pagination.total counts only that day's events, and cursors are bound to the filter.

Restrict the list to events that have a participant with this key (participants[].key, such as okc), matched case-insensitively. Participant keys are unique only within a league: la is the Rams in the NFL and the Sparks in the WNBA, so pair this with league unless you want both. Send one key; a comma-joined value is a 400. pagination.total counts only the matching events, and cursors are bound to the filter.

Selects which events this request draws from. Defaults to false: the current games, meaning events whose scheduled start has not certainly passed — today's games, plus a one-day grace so a late start that runs past midnight Eastern is never dropped mid-play. Set it to true to also get the settled archive: events that left the live matching run, usually because the venues settled or delisted them, kept for 30 days. That adds games whose date is further in the past, including ones a venue still lists as open, and games a venue cancelled, which can be future-dated: Polymarket resolves a game that was never played 50-50, as it did a postseason game its series never needed, before its scheduled day. The default population leaves a cancelled game out, so false never lists a game that was not played.

Venues settle and delist a game's markets at different times, so the endpoint filters on the game's own date (its scheduled start, and never earlier than the date its event_id ends in) rather than on an upstream status. Nothing is reported as settled that the venue has not settled; these events are simply not current, which is what the default page is for. A postponed game takes its new date, so its event stays current until the makeup game.

A game that has started is served with the fullest mapping it had — the version from before its first venue settled and delisted it — rather than only the venues still listing it. That holds in the default population too, so today's finished games stay listed with every venue until they are past-dated; with true it holds for older games as well. Games archived before 2026-10-04 21:26 UTC kept only the venues that still listed them when they left (usually two), and age out of the 30-day archive by 2026-11-04.

Player-prop admission policy. It requires include_submarkets=true; with include_submarkets=false, which is the default on a page, it is a 400. Matched case-insensitively. strict (the default) includes only groups of at least two distinct providers with verified player/game/stat/threshold/side identity and a completely reviewed equivalent settlement profile. same_prop retains exact prop identity but also admits different or unverified settlement rules, identified by settlement_equivalence and rule_comparisons. Unknown rules never prove equivalence. Applies with include_settled; cursors cannot be reused between policies. Does not change game-line matching or the default moneyline projection. Historical snapshots without verified player identity do not expose props.

When true, each event lists every matched submarket (spreads, totals, period lines and player props) instead of only its full-game moneyline, and events matched only on those submarkets are included too. When false, an event appears only when its full-game moneyline is matched, so submarkets is never empty. Defaults to false, which keeps a page small. Every submarket has the same shape, so code written against the moneyline reads the rest unchanged. This is an identity mapping only; fetch current status, quotes, and liquidity from the referenced market resources. Explicit player_prop_match requires this to be true.

Such pages are large: on 2026-10-04 a 50-event page with every submarket was about 880 KB (190 KB gzipped), and a 20-event player_prop_match=same_prop page about 3 MB. Send Accept-Encoding: gzip and a smaller limit when you need them.

When true, every moneyline, spread and total also lists rule_comparisons: the three rows (tie, overtime and push), each with every source market's value, a description and an evidence link, that sit behind its settlement_equivalence. When false, the default, a game line carries settlement_equivalence alone: the verdict is always there and only the rows are left out. The rows are about 60% of an event's bytes on a busy football slate, so ask for them when you want the evidence. A player prop always carries its own matrix, whatever this is. The flag changes what each event lists and never which events a page returns, so a cursor works with either value.