Markets Endpoints

Access spread, moneyline, total, and other betting markets for games.

Get Game Markets

GET

/api/v1/nba/odds/games/:game_id/markets

Retrieve all betting markets for a specific game, with extensive filtering options.

Parameters

Name	Type	Required	Description
`game_id`	integer (path)	Required	Unique game identifier.
`market_type`	string \| array	Optional	Filter by market type (e.g., moneyline, spread, total).
`book_id`	integer \| array	Optional	Filter by sportsbook ID.

Example Request

curl -X GET "https://odds-marketplace.onrender.com/api/v1/nba/odds/games/401123456/markets?market_type=moneyline&book_id=15" \
  -H "Authorization: Bearer sk_your_api_key_here"

Example Response

{
  "success": true,
  "data": {
    "game_id": 401123456,
    "status": "scheduled",
    "markets": {
      "moneyline": {
        "market_type": "moneyline",
        "count": 5,
        "outcomes": [
          {
            "outcome_id": 987654321,
            "book_id": 15,
            "market_type": "moneyline",
            "side": "home",
            "odds": {
              "decimal": 1.91,
              "american": "-110"
            }
          }
        ]
      }
    }
  }
}

Moneyline

GET

/api/v1/nba/odds/markets/moneyline

Returns moneyline prices for one or more games across sportsbooks. Each outcome also includes vig-adjusted true probability, edge %, and EV per $100 stake.

Parameters

Name	Type	Required	Description
`date`	string	Optional	YYYY-MM-DD. Defaults to today.
`game_id`	integer \| array	Optional	Filter by game ID(s).
`team_id`	integer \| array	Optional	Filter by team ID(s).
`book_id`	integer \| array	Optional	Filter by sportsbook ID(s).
`sort`	string	Optional	'odds' (default) or 'value'.

Example Request

curl -X GET "https://odds-marketplace.onrender.com/api/v1/nba/odds/markets/moneyline?date=2024-01-15&sort=value" \
  -H "Authorization: Bearer sk_your_api_key_here"

Example Response

{
  "success": true,
  "data": [
    {
      "outcome_id": 123456789,
      "book_id": 15,
      "market_type": "moneyline",
      "side": "home",
      "team_id": 21,
      "odds": {
        "decimal": 2.15,
        "american": "+115"
      },
      "value": 0.05,
      "game_id": 401123456,
      "ev": {
        "decimal_odds": 2.15,
        "implied_probability": 0.4651,
        "true_probability": 0.49,
        "break_even_probability": 0.4651,
        "edge_percentage": 2.5,
        "ev_per_100": 5.1,
        "profitable": true,
        "stale": false,
        "arbitrage": false
      }
    }
  ],
  "count": 1
}

Spread

GET

/api/v1/nba/odds/markets/spread

Returns point spread markets and prices. Useful for finding the best spread lines. Each outcome includes vig-adjusted true probability, spread key-number adjustments, and EV metadata.

Parameters

Name	Type	Required	Description
`date`	string	Optional	YYYY-MM-DD. Defaults to today.
`game_id`	integer \| array	Optional	Filter by game ID(s).
`team_id`	integer \| array	Optional	Filter by team ID(s).
`book_id`	integer \| array	Optional	Filter by sportsbook ID(s).
`sort`	string	Optional	'value' (default) or 'odds'.

Example Request

curl -X GET "https://odds-marketplace.onrender.com/api/v1/nba/odds/markets/spread?date=2024-01-15" \
  -H "Authorization: Bearer sk_your_api_key_here"

Example Response

{
  "success": true,
  "data": [
    {
      "outcome_id": 987654321,
      "book_id": 15,
      "market_type": "spread",
      "side": "home",
      "team_id": 21,
      "point": -4.5,
      "odds": {
        "decimal": 1.91,
        "american": "-110"
      },
      "value": 2.5,
      "game_id": 401123456,
      "ev": {
        "decimal_odds": 1.91,
        "implied_probability": 0.5236,
        "true_probability": 0.51,
        "break_even_probability": 0.5236,
        "edge_percentage": -1.4,
        "ev_per_100": -2.8,
        "profitable": false,
        "stale": false,
        "arbitrage": false
      }
    }
  ],
  "count": 1
}

Total (Over/Under)

GET

/api/v1/nba/odds/markets/total

Returns over/under totals and odds. Combine with game metadata to model expected scoring and pace. Each outcome also includes vig-adjusted true probability and EV per $100 stake.

Parameters

Name	Type	Required	Description
`date`	string	Optional	YYYY-MM-DD. Defaults to today.
`game_id`	integer \| array	Optional	Filter by game ID(s).
`book_id`	integer \| array	Optional	Filter by sportsbook ID(s).
`side`	string \| array	Optional	'over' or 'under'.
`sort`	string	Optional	'value' (default) or 'odds'.

Example Request

curl -X GET "https://odds-marketplace.onrender.com/api/v1/nba/odds/markets/total?date=2024-01-15&side=over" \
  -H "Authorization: Bearer sk_your_api_key_here"

Example Response

{
  "success": true,
  "data": [
    {
      "outcome_id": 456789123,
      "book_id": 15,
      "market_type": "total",
      "side": "over",
      "point": 220.5,
      "odds": {
        "decimal": 1.91,
        "american": "-110"
      },
      "value": 0.0,
      "game_id": 401123456,
      "ev": {
        "decimal_odds": 1.91,
        "implied_probability": 0.5236,
        "true_probability": 0.50,
        "break_even_probability": 0.5236,
        "edge_percentage": -2.4,
        "ev_per_100": -4.8,
        "profitable": false,
        "stale": false,
        "arbitrage": false
      }
    }
  ],
  "count": 1
}