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 active=true&aggregator=<venue> only that venue is
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.
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… | |||
