Get a market group

curl --request GET \
  --url https://api.splashsports.com/predictions-service/api/prediction_markets/{id}

const options = {method: 'GET'};

fetch('https://api.splashsports.com/predictions-service/api/prediction_markets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "market_group": {
    "id": "market_group_123",
    "event_start": 1704067200000,
    "sub_category": "nfl",
    "event_id": "game_456",
    "type": "gameline",
    "markets": []
  },
  "filters": [
    {
      "title": "Game lines",
      "types": [
        "gameline"
      ],
      "group_by": "market_type"
    },
    {
      "title": "Player Props",
      "types": [
        "player_prop"
      ],
      "group_by": "prop_type",
      "filters": [
        {
          "title": "Touchdowns",
          "types": [
            "touchdowns",
            "first_touchdown",
            "team_first_touchdown"
          ]
        },
        {
          "title": "Passing",
          "types": [
            "passing_yards",
            "passing_touchdowns",
            "passing_completions",
            "passing_attempts",
            "interceptions_thrown",
            "most_passing_yards"
          ]
        },
        {
          "title": "Receiving",
          "types": [
            "receiving_yards",
            "receptions",
            "longest_reception"
          ]
        },
        {
          "title": "Rushing",
          "types": [
            "rushing_yards",
            "rushing_attempts"
          ]
        },
        {
          "title": "Rush + Rec",
          "types": [
            "scrimmage_yards"
          ]
        },
        {
          "title": "Fantasy",
          "types": [
            "fantasy_points_ppr"
          ]
        }
      ]
    }
  ],
  "included": {
    "events": [],
    "teams": [],
    "entities": [],
    "sub_categories": []
  },
  "status": "success"
}

Markets

Get a market group

One market group by id. A player_prop group has the same shape here as in a listing: one market per prop type, each carrying its ladder in alternate_lines.

filters are the game page’s tabs, and each tab carries exactly what the client sends to GET /events/{event_id}/details to fill it: types as ?type=, group_by as ?group_by=, and on Player Props each of its filters as a comma-separated ?prop_type= list.

Tabs, in order: Player Props (player_prop) and Game lines (gameline).
Computed per game. Game lines appears when the game has an active game line with a tradeable market. Player Props appears when at least one prop is tradeable. Nothing opens onto an empty list.
Prop filters appear only in a league whose prop list needs them (NFL and MLB). In every other league the field is absent and the tab is one list of sections. Render filters when present; never assume them.
Always present and always an array. A group with no game (a future) gets [].
If the tabs cannot be read, the group is still returned with filters: [].

Cached for 5 seconds.

GET

prediction_markets

{id}

Get a market group

curl --request GET \
  --url https://api.splashsports.com/predictions-service/api/prediction_markets/{id}

const options = {method: 'GET'};

fetch('https://api.splashsports.com/predictions-service/api/prediction_markets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "market_group": {
    "id": "market_group_123",
    "event_start": 1704067200000,
    "sub_category": "nfl",
    "event_id": "game_456",
    "type": "gameline",
    "markets": []
  },
  "filters": [
    {
      "title": "Game lines",
      "types": [
        "gameline"
      ],
      "group_by": "market_type"
    },
    {
      "title": "Player Props",
      "types": [
        "player_prop"
      ],
      "group_by": "prop_type",
      "filters": [
        {
          "title": "Touchdowns",
          "types": [
            "touchdowns",
            "first_touchdown",
            "team_first_touchdown"
          ]
        },
        {
          "title": "Passing",
          "types": [
            "passing_yards",
            "passing_touchdowns",
            "passing_completions",
            "passing_attempts",
            "interceptions_thrown",
            "most_passing_yards"
          ]
        },
        {
          "title": "Receiving",
          "types": [
            "receiving_yards",
            "receptions",
            "longest_reception"
          ]
        },
        {
          "title": "Rushing",
          "types": [
            "rushing_yards",
            "rushing_attempts"
          ]
        },
        {
          "title": "Rush + Rec",
          "types": [
            "scrimmage_yards"
          ]
        },
        {
          "title": "Fantasy",
          "types": [
            "fantasy_points_ppr"
          ]
        }
      ]
    }
  ],
  "included": {
    "events": [],
    "teams": [],
    "entities": [],
    "sub_categories": []
  },
  "status": "success"
}

Path Parameters

string

required

The market group id.

Query Parameters

status

string

Comma-separated subset of active, settled, expired. Omitted = all statuses, so a finished game's page still renders. See Market statuses.

Example:

"active,settled"

Response

The group, its tabs and the resources it references.

market_group

MarketGroup · object

required

A market group. type says which kind; each kind has its own page: GamelineMarketGroup, FutureTeamChampionMarketGroup, PlayerPropMarketGroup. Fields marked with a type are present only on that type.

Show child attributes

filters

GameTab · object[]

required

The game page's tabs. [] for a group with no game.

Show child attributes

included

Included · object

required

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

Show child attributes

status

string

required

Allowed value: "success"

Getting started

Reference

Types

Get a market group

Path Parameters

Query Parameters

Response