WagerGPT API Docs

WagerGPT API Documentation V1

Introduction

Welcome to the WagerGPT Docs! This API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

You can use your WagerGPT API access code to authenticate any request you make, it's the same code you used to access the Telegram bot.

The WagerGPT API doesn’t support bulk updates. You can work on only one object per request. The WagerGPT API will change as we release new versions and tailor functionality. This documentation outlines the current endpoints available in the WagerGPT API, which offers data, predictions, and analysis for 9 sports leagues. Each endpoint provides specific data like game stats, player odds, injuries, and more.

League Overview

There are currently 9 leagues available. More coming soon!

  1. NFL (National Football League)

  2. NHL (National Hockey League)

  3. SHL (Swedish Hockey League)

  4. EPL (English Premier League)

  5. Tennis (ATP)

  6. Horse Racing (UK)

  7. NBA (National Basketball Association)

  8. NCAA Basketball (College Basketball)

  9. MMA (Mixed Martial Arts)

API Overview

The WagerGPT is divided into 3 categories

  1. Data - Team performance, player performance, odds, injuries, and lineups

  2. Predictions - Daily AI Picks across all leagues and Top 5 Picks

  3. Analysis - Prompt WagerGPT for personalized research live analysis, bet construction, & more

Data

NFL

1. NFL Player Game Stats by Week

  • Endpoint: GET /nfl-player-game-stats-by-week

  • Description: Fetches NFL player game statistics by week.

  • Parameters: access_token, season, week

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'season': '2023REG', #Season Examples: 2015REG, 2015PRE, 2015POST
          'week': '1' #Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.
      }
      
      response = requests.get("http://api.wagergpt.co/nfl-player-game-stats-by-week", params=params)
      print(response.json())
    • Curl:

    curl -X GET "http://api.wagergpt.co/nfl-player-game-stats-by-week?access_token=YOUR_ACCESS_TOKEN&season=2023REG&week=1"

2. NFL Team Season Stats

  • Endpoint: GET /nfl-team-season-stats

  • Description: Retrieves NFL team season statistics.

  • Parameters: access_token, season

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'season': '2023REG' #Season Examples: 2015REG, 2015PRE, 2015POST
      }
      response = requests.get("http://api.wagergpt.co/nfl-team-season-stats", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nfl-team-season-stats?access_token=YOUR_ACCESS_TOKEN&season=2023REG"

3. NFL Player Odds

  • Endpoint: GET /nfl-player-odds

  • Description: Provides NFL player odds for a specific event.

  • Parameters: access_token, event_id

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'event_id': 'EVENT_ID' # Specify the event ID
      }
      response = requests.get("http://api.wagergpt.co/nfl-player-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nfl-player-odds?access_token=YOUR_ACCESS_TOKEN&event_id=EVENT_ID"

4. NFL Odds

  • Endpoint: GET /nfl-odds

  • Description: Fetches odds for NFL games.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/nfl-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nfl-odds?access_token=YOUR_ACCESS_TOKEN"

5. NFL Injuries

  • Endpoint: GET /nfl-injuries

  • Description: Lists NFL injuries by season and week.

  • Parameters: access_token, season, week

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'season': '2023REG', # Season Examples: 2015REG, 2015PRE, 2015POST
          'week': '1' # Week of the season. Valid values: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.
      }
      response = requests.get("http://api.wagergpt.co/nfl-injuries", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nfl-injuries?access_token=YOUR_ACCESS_TOKEN&season=2023REG&week=1"

NHL

1. NHL Injuries

  • Endpoint: GET /nhl-injuries

  • Description: Lists NHL injured players.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/nhl-injuries", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nhl-injuries?access_token=YOUR_ACCESS_TOKEN"

2. NHL Game Stats

  • Endpoint: GET /nhl-game-stats

  • Description: Retrieves NHL game statistics for a given date.

  • Parameters: access_token, date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'date': 'YYYY-MM-DD' # Example: '2024-01-24'
      }
      response = requests.get("http://api.wagergpt.co/nhl-game-stats", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nhl-game-stats?access_token=YOUR_ACCESS_TOKEN&date=YYYY-MM-DD"

3. NHL Player Odds

  • Endpoint: GET /nhl-player-odds

  • Description: Provides NHL player odds for a specific event.

  • Parameters: access_token, event_id

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'event_id': 'EVENT_ID' # Specify the event ID
      }
      response = requests.get("http://api.wagergpt.co/nhl-player-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nhl-player-odds?access_token=YOUR_ACCESS_TOKEN&event_id=EVENT_ID"

4. NHL Player Stats

  • Endpoint: GET /nhl-player-stats

  • Description: Fetches NHL player game statistics for a given date.

  • Parameters: access_token, date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'date': 'YYYY-MM-DD' # Example: '2024-01-11'
      }
      response = requests.get("http://api.wagergpt.co/nhl-player-stats", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nhl-player-stats?access_token=YOUR_ACCESS_TOKEN&date=YYYY-MM-DD"

5. NHL Odds

  • Endpoint: GET /nhl-odds

  • Description: Retrieves odds for NHL games.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/nhl-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nhl-odds?access_token=YOUR_ACCESS_TOKEN"

SHL (Swedish Hockey League)

1. SHL Odds

  • Endpoint: GET /shl-odds

  • Description: Provides odds for SHL (Swedish Hockey League) games.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/shl-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/shl-odds?access_token=YOUR_ACCESS_TOKEN"

EPL (English Premier League)

1. EPL Game Stats

  • Endpoint: GET /epl-game-stats

  • Description: Fetches EPL game statistics for a specific date.

  • Parameters: access_token, date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'date': 'YYYY-MM-DD' # Example: '2022-10-14'
      }
      response = requests.get("http://api.wagergpt.co/epl-game-stats", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/epl-game-stats?access_token=YOUR_ACCESS_TOKEN&date=YYYY-MM-DD"

2. EPL Player Stats

  • Endpoint: GET /epl-player-stats

  • Description: Retrieves EPL player game statistics for a given date.

  • Parameters: access_token, date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'date': 'YYYY-MM-DD' # Example: '2022-10-14'
      }
      response = requests.get("http://api.wagergpt.co/epl-player-stats", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/epl-player-stats?access_token=YOUR_ACCESS_TOKEN&date=YYYY-MM-DD"

3. EPL Odds

  • Endpoint: GET /epl-odds

  • Description: Provides odds for EPL games.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/epl-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/epl-odds?access_token=YOUR_ACCESS_TOKEN"

4. EPL Injuries

  • Endpoint: GET /epl-injuries

  • Description: Lists EPL injuries.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/epl-injuries", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/epl-injuries?access_token=YOUR_ACCESS_TOKEN"

Tennis

1. ATP Odds

  • Endpoint: GET /tennis-odds

  • Description: Fetches tennis odds, specifically for ATP Singles games for the next 7 days.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/tennis-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/tennis-odds?access_token=YOUR_ACCESS_TOKEN"

days.

Horse Racing

1. Horse Racing Odds

  • Endpoint: GET /horse-racing-odds

  • Description: Provides horse racing odds for events.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/horse-racing-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/horse-racing-odds?access_token=YOUR_ACCESS_TOKEN"

2. Racing Data

  • Endpoint: GET /racing-data

  • Description: Fetches racing data for a given date range.

  • Parameters: access_token, start_date, end_date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'start_date': 'YYYY-MM-DD', # Example: '2024-01-01'
          'end_date': 'YYYY-MM-DD'    # Example: '2024-01-07'
      }
      response = requests.get("http://api.wagergpt.co/racing-data", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/racing-data?access_token=YOUR_ACCESS_TOKEN&start_date=YYYY-MM-DD&end_date=YYYY-MM-DD"

NBA

1. NBA Starting Lineups

  • Endpoint: GET /nba-starting-lineups

  • Description: Retrieves NBA starting lineups for a given date.

  • Parameters: access_token, date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'date': 'YYYY-MM-DD' # Example: '2024-01-25'
      }
      response = requests.get("http://api.wagergpt.co/nba-starting-lineups", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nba-starting-lineups?access_token=YOUR_ACCESS_TOKEN&date=YYYY-MM-DD"

2. NBA Injuries

  • Endpoint: GET /nba-injuries

  • Description: Lists NBA injuries.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/nba-injuries", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nba-injuries?access_token=YOUR_ACCESS_TOKEN"

3. NBA Player Stats

  • Endpoint: GET /nba-player-stats

  • Description: Fetches NBA player game statistics for a given date.

  • Parameters: access_token, date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'date': 'YYYY-MM-DD' # Example: '2024-01-11'
      }
      response = requests.get("http://api.wagergpt.co/nba-player-stats", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nba-player-stats?access_token=YOUR_ACCESS_TOKEN&date=YYYY-MM-DD"

4. NBA Game Stats

  • Endpoint: GET /nba-game-stats

  • Description: Provides NBA game statistics for a given date.

  • Parameters: access_token, date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'date': 'YYYY-MM-DD' # Example: '2024-01-11'
      }
      response = requests.get("http://api.wagergpt.co/nba-game-stats", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nba-game-stats?access_token=YOUR_ACCESS_TOKEN&date=YYYY-MM-DD"

5. NBA Player Odds

  • Endpoint: GET /nba-player-odds

  • Description: Offers NBA player odds for a specific event.

  • Parameters: access_token, event_id

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'event_id': 'EVENT_ID' # Specify the event ID
      }
      response = requests.get("http://api.wagergpt.co/nba-player-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nba-player-odds?access_token=YOUR_ACCESS_TOKEN&event_id=EVENT_ID"

6. NBA Odds

  • Endpoint: GET /nba-odds

  • Description: Retrieves odds for NBA games.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/nba-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/nba-odds?access_token=YOUR_ACCESS_TOKEN"

NCAA Basketball

1. NCAA Odds

  • Endpoint: GET /ncaa-odds

  • Description: Provides odds for NCAA basketball games.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/ncaa-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/ncaa-odds?access_token=YOUR_ACCESS_TOKEN"

2. NCAA Game Stats

  • Endpoint: GET /ncaa-game-stats

  • Description: Fetches NCAA basketball game statistics for a given date.

  • Parameters: access_token, date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'date': 'YYYY-MM-DD' # Example: '2024-01-11'
      }
      response = requests.get("http://api.wagergpt.co/ncaa-game-stats", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/ncaa-game-stats?access_token=YOUR_ACCESS_TOKEN&date=YYYY-MM-DD"

3. NCAA Player Stats

  • Endpoint: GET /ncaa-player-stats

  • Description: Retrieves NCAA basketball player game statistics for a given date.

  • Parameters: access_token, date

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'date': 'YYYY-MM-DD' # Example: '2024-01-11'
      }
      response = requests.get("http://api.wagergpt.co/ncaa-player-stats", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/ncaa-player-stats?access_token=YOUR_ACCESS_TOKEN&date=YYYY-MM-DD"

4. NCAA Injuries

  • Endpoint: GET /ncaa-injuries

  • Description: Lists NCAA basketball injuries.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/ncaa-injuries", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/ncaa-injuries?access_token=YOUR_ACCESS_TOKEN"

MMA

1. MMA Odds

  • Endpoint: GET /mma-odds

  • Description: Fetches odds for MMA events.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/mma-odds", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/mma-odds?access_token=YOUR_ACCESS_TOKEN"

Predictions

Daily Picks

  • Endpoint: GET /daily-picks

  • Description: Retrieves the latest daily picks.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/daily-picks", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/daily-picks?access_token=YOUR_ACCESS_TOKEN"

Top 5 Picks

  • Endpoint: GET /top-5-picks

  • Description: Provides the latest top 5 picks.

  • Parameters: access_token

  • Examples:

    • Python:

      import requests
      
      params = {'access_token': 'YOUR_ACCESS_TOKEN'}
      response = requests.get("http://api.wagergpt.co/top-5-picks", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/top-5-picks?access_token=YOUR_ACCESS_TOKEN"

Analysis

WagerGPT Analyzer

  • Endpoint: GET /analysis

  • Description: Performs live analysis based on user input and returns a response.

  • Parameters: access_token, input

  • Examples:

    • Python:

      import requests
      
      params = {
          'access_token': 'YOUR_ACCESS_TOKEN',
          'input': 'YOUR_ANALYSIS_QUERY' # Example: 'Who will win the next NBA game?'
      }
      response = requests.get("http://api.wagergpt.co/analysis", params=params)
      print(response.json())
    • Curl:

      curl -X GET "http://api.wagergpt.co/analysis?access_token=YOUR_ACCESS_TOKEN&input=YOUR_ANALYSIS_QUERY"

Last updated