Historical data

Lists archived games with scores and the number of odds, props and player-stat rows held for each.

Lists archived games with scores and the number of odds, props and player-stat rows held for each.

At least one of sport, season, team or startDate is required.

commenceTime is the scheduled start in UTC. Present when recorded; /history/odds rows with recordedAt before it are pre-game.

homeScore and awayScore are present when the final score was captured at archive, absent otherwise; periodScores, when present, lists each period by label (Q1, OT1, or the inning or period number) with both sides.

homeTeamId and awayTeamId are the roster ids the odds endpoints use (home_team_id, away_team_id); absent when a name is not on our roster.

oddsSnapshots counts every stored row, including rows /history/odds filters out for unusable prices, so it can exceed what that endpoint returns.

playerStats: rows on /history/stats. gradedResults (live-archived games): graded results on /api/v1/{sport}/props/results?game_id=.

Historical endpoints share a per-key in-flight limit that is lower than the general concurrent-request limit. A request beyond it returns 429 with a Retry-After header giving the delay in seconds; wait that long and resend.

503 with a Retry-After header means the archive could not serve that request: the query was too expensive to run in one request, or the archive read path was busy. Wait the indicated seconds before resending; if it repeats, narrow the request with the filters this endpoint accepts.

Page one event at a time with limit and offset and stop when a page comes back shorter than limit. Do not fan out one request per book or market in parallel.

get/api/v1/history/games

Request

  • Base URL: https://api.owlsinsight.com
  • URL: https://api.owlsinsight.com/api/v1/history/games
  • Auth: HTTP bearer

Query parameters

sportstring

Filter by sport key.

seasonstring

Season label, for example 2024-25.

teamstring

Team name; matches home or away.

gameTypestring

Game type.

startDatestring

Earliest game date to include, YYYY-MM-DD.

endDatestring

Latest game date to include, YYYY-MM-DD.

limitstring

Page size. Default 50, maximum 100.

offsetstring

Number of rows to skip, for pagination.

Response

OK

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.