Skip to main content
GET
List market groups

Query Parameters

sub_category
string

Comma-separated leagues. One or more of nba, nfl, ncaaf, nhl, mlb, ncaab, wnba, epl, mls. See Leagues.

Example:

"nfl,nba"

Free-text search over market titles.

type
string

Comma-separated market group types: gameline, future_team_champion, player_prop. Take the values from a sub-category's filters[].types rather than hardcoding them. When omitted, only gameline and future_team_champion groups are returned, so a client that never asks for player props never receives them. See Market group types.

Example:

"gameline,future_team_champion"

prop_type
string

Comma-separated player prop types, from a Player Props filter's types. Returns only those types and implies type=player_prop when type is omitted. The values are per league; a game's tabs say which it carries.

  • Football: touchdowns, first_touchdown, team_first_touchdown, passing_yards, passing_touchdowns, passing_completions, passing_attempts, interceptions_thrown, most_passing_yards, receiving_yards, receptions, longest_reception, rushing_yards, rushing_attempts, scrimmage_yards, fantasy_points_ppr
  • Basketball: points, rebounds, assists, points_rebounds_assists, three_points_made, steals, blocks, double_double
  • Hockey: goals, assists, points
  • Baseball: hits, total_bases, hits_runs_rbis, home_runs, rbis, stolen_bases, strikeouts, outs, earned_runs_allowed, hits_allowed, walks_allowed
  • Soccer: goals, assists, goals_plus_assists, first_goal

Full table with display titles: Player prop types.

Example:

"touchdowns,first_touchdown"

event_id
string

Only groups for this game (the group's event_id). Works for every type, so it also narrows gameline groups.

entity_id
string

Only this player's groups, across games. Implies type=player_prop when type is omitted.

team_id
string

Only players on this team. Pages one team's section of GET /events/{event_id}/details, e.g. ?event_id=<game>&prop_type=team_first_touchdown&team_id=<team>. Implies type=player_prop when type is omitted.

status
string

Comma-separated subset of active, settled, expired. Omitted = active only. An empty value or a value outside the list is a 400. See Market statuses.

Example:

"active,settled"

offset
integer
default:0

Number of results to skip.

Required range: x >= 0
limit
integer
default:50

Maximum number of results to return.

Required range: 1 <= x <= 50

Response

A page of market groups.

data
MarketGroup · object[]
required
included
Included · object
required

The resources the primary data references. Resolve event_id, team_id and entity_id here.

total
integer
required

Total count of matching market groups.

offset
integer
required
limit
integer
required
status
string
required
Allowed value: "success"