This endpoint retrieves a list of events based on the provided query parameters.
You can filter events either by (season year, week) OR (day, month, calendar year)
season type, and league ID are additional filters.
Note: The first week of the NFL postseason is week 1, season_type = POST
For NFL and NCAAF events, the response includes both week and season_type_agnostic_week fields.
The season_type_agnostic_week is a continuous week number across the entire season (regular season weeks 1-18 for NFL, 1-16 for NCAAF, with postseason weeks continuing from there).
Pagination is supported to navigate through large sets of data.
If none of (day/month/calendar_year, start_date/end_date, week,
season_type_agnostic_week) is supplied, results default to a rolling
window (recent past through the next ~30 days) rather than the league's
entire slate. Pass an explicit start_date/end_date to see events outside
this window.
Each sports event also carries market_count and market_counts_by_venue
so a client can tell which games have something to trade without reading
/odds per event. market_count is the number of distinct OPEN markets
(provider status active; suspended, closed, settled and unknown statuses
are not counted) in sources the tenant can read, the same visibility as
GET /markets; market_counts_by_venue gives the same count per venue
(aggregator, e.g. polymarket, kalshi), and its values can sum to more
than market_count because market_count counts a market once. Finished
events report 0. With sources=<csv> (or active=true&aggregator=<venue>)
only those venues are counted. A market being open does not mean it is currently priced; read
GET /events/{id}/odds for prices. null means the count could not be
computed right now (never 0); the list still serves. Crypto windows do
not carry these fields.
Venue parameters. with_markets_from=<csv> filters EVENTS: only events with
an OPEN market on one of the venues (their market_counts_by_venue is nonzero for
one of them), applied before pagination. sources=<csv> restricts the COUNTS:
market_count and market_counts_by_venue count only those venues and no event is
dropped. Use both (with_markets_from=sxbet&sources=sxbet) for "only this venue's
games, counting only its markets". Venues: kalshi, limitless, polymarket,
polymarket_us, predict_fun, prophetx, sxbet; spellings such as sx_bet or
predictfun are accepted. An unknown venue is a 400 invalid_parameters with
parameter, invalid_values and valid_keys; a canonical parameter next to its
own alias (with_markets_from with has_venue_markets or venue) is a 400 with
conflicts_with. has_venue_markets=true[&venue=] is the older spelling of
with_markets_from (same filter; without venue it means
polymarket,kalshi,prophetx). active=true&aggregator= is a different, older
filter: events with a current PRICED position from one venue, so its result can
differ from with_markets_from (an open market need not be priced).
Listed ProphetX boards also carry quote_status_by_venue.prophetx:
no_prices means no tenant-visible positive ProphetX price in the durable
latest projection, prices_present means at least one, and unknown means
the bounded quote read was unavailable. This is not a freshness, liquidity,
or execution-readiness guarantee. Other venues are omitted; unknown market
counts yield a null map. Discovery membership and counts are unchanged.
Crypto (league_id=CRYPTO; tenants entitled to the CRYPTO league only). One event
per crypto up/down window (event_id = the window id), with empty participants and a
title like BTC Up or Down 10:30-10:45 UTC (always UTC). Status is scheduled,
in_progress (inside the window), completed (from window_end, even if no venue has
posted a result yet) or cancelled (every listing voided). The additive
crypto_window object carries the asset, horizon, window bounds and the per-market
groups (list responses carry market_id, venues and alignment only; fetch
/events/{id} for constituents and results). With none of status, start_date or
end_date the set is live plus upcoming windows starting within 24 hours; an explicit
status or date replaces that default (completed is the last 24 hours), and
start_date..end_date may span at most 7 days. season_year is accepted and means the
UTC year of window_start. status=cancelled is not supported as
a filter. asset and horizon filter; active=true&aggregator=kalshi returns windows
the venue currently lists with a quote no older than 15 minutes (predict_fun,
prophetx, polymarket_us and sxbet are valid and empty). Default per_page is 100, maximum 200. Sports-only
filters (week, season_type*, participant_id, team_id, player_id,
day, month, year, calendar_year) are a 400 for this league;
include_scoreboard and the source-mapping parameters are accepted and ignored.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
