Player props

Returns a player's recent form for one prop category: the actual value from each recent game and, when a line is supplied, the hit rate, streak and average measured against it. The line can be a number, or closing to grade each game against the line a named sportsbook had captured at that game's start.

Returns a player's recent form for one prop category: the actual value from each recent game and, when a line is supplied, the hit rate, streak and average measured against it. The line can be a number, or closing to grade each game against the line a named sportsbook had captured at that game's start.

409 with matchedNames in the body when the name covers two different players, rather than pooling them into one trend. On a 200, meta.matchedNames lists the stored spellings the games came from; more than one means two spellings normalized to the same key, so check them before trusting the aggregate.

overRate is null, not 0, when no game in the window resolved. decided is its denominator and excludes pushes and unresolved games. streak runs from the most recent game and stops at the first unresolved game.

A numeric line is graded as over/under on every game, including integer lines, because a caller-supplied threshold is unambiguous. With line=closing each game is graded against the main line the book had captured at game start; every captured rung is listed under closing with isMain per rung, a game with no main rung is no_closing_line and one with several is multiple_closing_lines. A line captured in play is never treated as a close; meta.closingPhase records that only game-start captures were used.

meta.closingTruncated true means the rung fetch hit its cap and games past the cut read as no_closing_line; re-query with a smaller window. meta.gamesAvailable is a floor, not a count, when meta.gamesAvailableCapped is true.

Provisional grades are included by default; each game carries final and meta.provisional counts them. Grading is enabled sport by sport, so a player on a sport where it is not enabled has no games to return.

get/api/v1/{sport}/props/trends

Request

  • Base URL: https://api.owlsinsight.com
  • URL: https://api.owlsinsight.com/api/v1/{sport}/props/trends
  • Auth: HTTP bearer

Path parameters

sportstring required

Query parameters

playerstring required

Player name. Matched by normalized key against stored names, so punctuation, case and suffixes such as Jr. do not matter. 400 when fewer than three letters or digits remain after normalization; 409 when the name covers two different players.

categorystring required

Prop category.

linestring

Line to measure every game against: a number, or the literal closing to grade each game against the line the sportsbook in book had captured at that game's start. Without it the actuals are returned but no hit rate is computed.

bookstring

Sportsbook key whose captured closing line to grade against. Required with line=closing (400 without it); ignored otherwise. A book with no captured close for a game leaves that game as no_closing_line.

windowstring

Number of recent games to include, 1 to 50. Default 10.

confirmed_onlystring

Set to true to return only grades confirmed by a second, agreeing read of the box score. By default provisional grades are included and each carries final: false.

Response

OK

successboolean

Changes

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