/rankings/prop-candidates
Find players whose recent form clears a threshold in one market
Find players whose recent form clears a threshold in one market
Query Parameters
Statistic to search. Required. The same key identifies the market in the odds feed, so a market the feed names differently returns no odds.
Value in
- "dispossessed"
- "expectedAssists"
- "expectedGoals"
- "foulInvolvements"
- "fouls"
- "goalAssist"
- "goals"
- "interceptionWon"
- "keyPass"
- "onTargetScoringAttempt"
- "possessionLostCtrl"
- "saves"
- "scoredOrAssisted"
- "shots"
- "totalCross"
- "totalOffside"
- "totalPass"
- "totalTackle"
- "wasFouled"
- "xGxA"
- "yellowCard"
Start of the fixture window, exclusive. Required. Form is also measured as of this instant, so a search for tomorrow does not count today.
date-timeEnd of the fixture window, inclusive. Required.
date-timeComma-separated competition phase IDs to search. Supply this or competitionIds, not both; omit both for every visible competition in the bounded fixture window.
length <= 100Comma-separated canonical competition IDs. Go resolves their active phases from the fixture window. Supply this or phaseIds, not both; omit both for every visible competition in the window.
length <= 100Comma-separated fixture IDs, narrowing the window
length <= 100Comma-separated player positions
length <= 100Value an appearance must reach, greater than or equal, to count as a hit; defaults to 1. Fractional thresholds work: 0.5 selects appearances with at least one.
How many qualifying appearances the form figures cover; defaults to 10, maximum 50.
1 <= value <= 50Minimum minutes played for an appearance to count; defaults to 1, so a named substitute who never came on is not a data point.
0 <= value <= 120Minimum qualifying appearances a player must have; defaults to 0.
0 <= value <= 50Restrict to home or away appearances, on both the upcoming fixture and the sample; defaults to both.
Value in
- "both"
- "home"
- "away"
Count only appearances made in the phases named by phaseIds; defaults to TRUE.
Count only appearances the player started; defaults to TRUE.
Attach the figure of the player each substitute came on for; defaults to false. It is never folded into the candidate's own totals.
Compute the recent-versus-older trend; defaults to false. Sorting by -trend implies it.
Minimum hit rate, as a percentage between 0 and 100; defaults to 0.
Compare the window average against this value; defaults to 0, which disables the filter.
Direction of the averageThreshold comparison; defaults to above.
Value in
- "above"
- "below"
Drop players whose team has played more than this many fixtures since they last featured. A player with no appearance on record is dropped, not kept.
0 <= value <= 100Keep only players in the latest lineup projection of the named kind; defaults to all, which applies no filter.
Value in
- "all"
- "confirmed"
- "predicted"
Restrict prices to one line, and drop players nobody is quoting.
Minimum best available over price, and drop players nobody is quoting.
Ordering; defaults to -average.
Value in
- "-average"
- "-games"
- "-hitRate"
- "-kickoff"
- "-total"
- "-trend"
- "average"
- "kickoff"
Maximum resources to return; defaults to 25
1 <= value <= 10025Opaque cursor for the next page
Opaque cursor for the previous page
Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "https://example.com/rankings/prop-candidates?market=dispossessed&kickoffFrom=2019-08-24T14%3A15%3A22Z&kickoffTo=2019-08-24T14%3A15%3A22Z"{ "data": [ { "activity": { "gamesSinceLastAppearance": 0, "inPredictedLineup": true, "startedLastGame": true }, "fixture": { "awayTeam": { "id": "string", "name": "string", "slug": "string" }, "competition": { "id": "string", "name": "string", "slug": "string" }, "homeTeam": { "id": "string", "name": "string", "slug": "string" }, "id": "string", "isHome": true, "kickoffAt": "2019-08-24T14:15:22Z", "opponent": { "id": "string", "name": "string", "slug": "string" }, "phase": { "id": "string", "name": "string", "slug": "string" }, "slug": "string" }, "form": { "average": 0, "games": 0, "hitRate": 0, "hits": 0, "perNinety": 0, "total": 0.1 }, "market": { "key": "string", "threshold": 0.1 }, "odds": [ { "line": 0, "quotes": [ { "bookmaker": "string", "bookmakerId": "string", "over": 0, "under": 0 } ] } ], "player": { "id": "string", "name": "string", "slug": "string" }, "position": "string", "recentAppearances": [ { "fixture": { "awayScore": 0, "awayTeam": { "id": "string", "name": "string", "slug": "string" }, "homeScore": 0, "homeTeam": { "id": "string", "name": "string", "slug": "string" }, "id": "string", "kickoffAt": "2019-08-24T14:15:22Z", "slug": "string" }, "minutesPlayed": 0, "position": "string", "replacedPlayer": { "id": "string", "value": 0 }, "value": 0.1 } ], "team": { "id": "string", "name": "string", "slug": "string" }, "trend": { "changePercent": 0.1, "direction": "string", "gamesUsed": 0, "olderAverage": 0.1, "olderGames": 0, "recentAverage": 0.1, "recentGames": 0 } } ], "links": { "next": "string", "previous": "string", "self": "string" }, "page": { "hasNext": true, "hasPrevious": true, "limit": 0, "nextCursor": "string", "previousCursor": "string" }}