WagerGPT API Documentation

Access sports data, betting odds, and AI-powered betting analysis through a simple REST API.

Get Started API Reference

Overview

The WagerGPT API provides access to comprehensive sports data, betting odds, and AI-powered betting analysis. The API is organized into three main categories:

Sports Data

Access detailed statistics, injuries, lineups, and game data for various sports including NFL, NBA, NHL, EPL, and more.

Betting Odds

Get real-time betting odds for games, player props, and other markets across multiple sports and leagues.

AI Analysis

Leverage AI-powered betting analysis, daily picks, and custom analysis for making informed betting decisions.

Getting Started

To use the WagerGPT API, you'll need an access token. All API requests must include this token as a query parameter.

Base URL: http://api.wagergpt.xyz

Example request:

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

Authentication

The WagerGPT API uses a simple token-based authentication system. You must include your access token with every API request as a query parameter.

Authentication Example 
curl -X GET "http://api.wagergpt.xyz/daily-picks?access_token=f635dafd-f2e8-45c7-ac0d-4bce589e1702"

If you don't include a valid access token, you'll receive a 401 Unauthorized response:

{
  "error": "Unauthorized"
}

API Endpoints

The WagerGPT API provides a wide range of endpoints organized into three main categories.

Sports Data Endpoints

These endpoints provide access to detailed sports statistics, player data, injuries, and game information.

NFL Player Game Stats GET

/nfl-player-game-stats-by-week

Retrieves NFL player game statistics for a specific season and week.

Query Parameters:
  • access_token (required) - Your API access token
  • season (required) - Season in format YYYY or YYYYSEASON_TYPE (e.g., 2023 or 2023REG)
  • week (required) - Week of the season
Example:
curl -X GET "http://api.wagergpt.xyz/nfl-player-game-stats-by-week?access_token=YOUR_ACCESS_TOKEN&season=2023REG&week=1"
NFL Team Season Stats GET

/nfl-team-season-stats

Retrieves NFL team statistics for a specific season.

Query Parameters:
  • access_token (required) - Your API access token
  • season (required) - Season in format YYYY or YYYYSEASON_TYPE (e.g., 2023 or 2023REG)
Example:
curl -X GET "http://api.wagergpt.xyz/nfl-team-season-stats?access_token=YOUR_ACCESS_TOKEN&season=2023REG"
NFL Injuries GET

/nfl-injuries

Retrieves current NFL injury reports.

Query Parameters:
  • access_token (required) - Your API access token
Example:
curl -X GET "http://api.wagergpt.xyz/nfl-injuries?access_token=YOUR_ACCESS_TOKEN"
NBA Starting Lineups GET

/nba-starting-lineups

Retrieves current NBA starting lineups.

Query Parameters:
  • access_token (required) - Your API access token
Example:
curl -X GET "http://api.wagergpt.xyz/nba-starting-lineups?access_token=YOUR_ACCESS_TOKEN"

View All Sports Data Endpoints

Betting Odds Endpoints

These endpoints provide access to betting odds for various sports and markets.

NFL Odds GET

/nfl-odds

Retrieves current NFL betting odds.

Query Parameters:
  • access_token (required) - Your API access token
Example:
curl -X GET "http://api.wagergpt.xyz/nfl-odds?access_token=YOUR_ACCESS_TOKEN"
NFL Player Odds GET

/nfl-player-odds

Retrieves current NFL player prop betting odds.

Query Parameters:
  • access_token (required) - Your API access token
  • event_id (required) - The ID of the event
Example:
curl -X GET "http://api.wagergpt.xyz/nfl-player-odds?access_token=YOUR_ACCESS_TOKEN&event_id=61dcc385d9c0927b9392d04c3b944198"
NBA Odds GET

/nba-odds

Retrieves current NBA betting odds.

Query Parameters:
  • access_token (required) - Your API access token
Example:
curl -X GET "http://api.wagergpt.xyz/nba-odds?access_token=YOUR_ACCESS_TOKEN"

View All Betting Odds Endpoints

AI Analysis Endpoints

These endpoints provide AI-powered betting analysis and picks.

Daily Picks GET

/daily-picks

Retrieves the latest AI-generated daily betting picks across various sports.

Query Parameters:
  • access_token (required) - Your API access token
Example:
curl -X GET "http://api.wagergpt.xyz/daily-picks?access_token=YOUR_ACCESS_TOKEN"
Response Example:
{
  "picks": "šŸšØ WagerGPT Daily AI Picks šŸšØ\n\nUpdated every 5 minutes! \n\nšŸ€ NBA Picks šŸ€ \n-------------------\n1. Charlotte Hornets / Cleveland Cavaliers UNDER 234.5 @ -112\n2. Dallas Mavericks / Memphis Grizzlies UNDER 239.0 @ -115\n...",
  "timestamp": "Fri, 07 Mar 2025 13:00:28 GMT",
  "top_5_picks_response": "1. Charlotte Hornets / Cleveland Cavaliers UNDER 234.5 @ -112 (NBA)\n2. Winnipeg Jets ML @ -115 (NHL)\n..."
}
Top 5 Picks GET

/top-5-picks

Retrieves the top 5 AI-generated betting picks.

Query Parameters:
  • access_token (required) - Your API access token
Example:
curl -X GET "http://api.wagergpt.xyz/top-5-picks?access_token=YOUR_ACCESS_TOKEN"
Custom Analysis GET

/analysis

Generates custom AI analysis based on your specific query.

Query Parameters:
  • access_token (required) - Your API access token
  • input (required) - Your analysis query (e.g., "Should I bet on the Lakers tonight?")
Example:
curl -X GET "http://api.wagergpt.xyz/analysis?access_token=YOUR_ACCESS_TOKEN&input=Should%20I%20bet%20on%20the%20Lakers%20tonight%3F"
Response Example:
{
  "final_response": "Based on my analysis, betting on the Lakers tonight is a moderate-value play. They're 4-1 ATS in their last 5 home games and their offensive efficiency has improved 7.2% since the All-Star break. Their opponent is on the second night of a back-to-back with travel involved, historically a -3.8 point impact. The current spread of -5.5 is slightly below my projected line of -6.5, indicating a small edge. Consider a 1-unit play on Lakers -5.5.",
  "printed_output": "Thinking process details..."
}

Error Handling

The WagerGPT API uses conventional HTTP response codes to indicate the success or failure of an API request.

Code Description
200 - OK The request was successful.
400 - Bad Request The request was invalid or missing required parameters.
401 - Unauthorized The access token was missing or invalid.
404 - Not Found The requested resource was not found.
500 - Internal Server Error An error occurred on the server.

Error responses will include a JSON object with an error message:

{
  "error": "Unauthorized"
}

Rate Limits

To ensure the stability of the API, rate limits are applied to all endpoints. The current rate limits are:

  • 100 requests per minute per access token
  • 5,000 requests per day per access token

If you exceed these limits, you'll receive a 429 Too Many Requests response.