Odds API Suite (OA)

🎰 Professional sports betting analysis and arbitrage finder

Find guaranteed profit opportunities across sportsbooks and sweeps casinos. Built for data-driven bettors who want to identify arbitrage opportunities and hedge betting strategies.

🎯 Why Use Odds API Suite?

While focused on sports betting, this toolkit can help sweeps casino players who also use sportsbooks:

  • Find Arbitrage: Discover guaranteed profit opportunities between sportsbooks
  • Hedge Bets: Protect your bankroll with opposing bets
  • Live Odds: Monitor real-time odds from 10+ major bookmakers
  • PrizePicks Strategy: Use free squares for guaranteed profits
  • Data-Driven: Make decisions based on real-time market data

✨ Key Features

  • 🎯 PrizePicks Arbitrage: Guaranteed profit using free squares
  • 💰 Hedge Betting: Find arbitrage between major sportsbooks
  • 📊 Live Odds Display: Real-time odds from 10+ bookmakers
  • 🔄 Smart API Management: Automatic rate limiting and key cycling
  • 🏀 Multi-Sport: NFL, NBA, MLB, NHL, WNBA, NCAA Football
  • 💾 Data Export: Save odds to timestamped JSON for analysis
  • ⚡ Smart Caching: Reduces API calls while keeping data fresh

🚀 Installation (Super Easy!)

Works on: Windows, macOS, and Linux

Don’t worry if you’re new to this - just follow these simple steps:

Step 1: Install the Software

Option A: One-Command Install (Easiest!)

  1. Open Terminal (Mac: search “Terminal” in Spotlight, Windows: search “Command Prompt”)
  2. Copy and paste this command, then press Enter: 
    curl -L https://www.bankbonimus.com/assets/downloads/install-odds-api-suite.sh | bash
  3. Wait 10-30 seconds - it will download and install automatically

Option B: Manual Download (If Option A Doesn’t Work)

  1. Click here to download Odds API Suite (saves to Downloads)
  2. Click here to download the installer (saves to Downloads)
  3. Open Terminal, then copy and paste these commands (press Enter after each): 
    cd ~/Downloads
bash install-odds-api-suite.sh

Step 2: Get Your FREE API Key (Required)

You need this to see live odds - takes 30 seconds to set up:

  1. Visit the-odds-api.com and click “Sign Up”
  2. Enter your email and create a password
  3. Check your email for confirmation link
  4. Copy your API key from the dashboard (looks like: abc123def456...)

Free tier gives you 500 requests per month - plenty for daily use!

Step 3: Set Up Your API Key

Copy and paste ONE of these commands (pick the easier one for you):

Method 1 - Quick Setup (simplest):

export ODDS_API_KEY="paste-your-actual-key-here"

(Replace paste-your-actual-key-here with your real key from Step 2)

Method 2 - Permanent Setup (so you don’t have to do it again):

echo "paste-your-actual-key-here" > ~/.odds-api-keys

(Replace paste-your-actual-key-here with your real key from Step 2)

Step 4: Test It Works!

Type this command:

oa api-status

You should see: “✅ All API keys are active and working!”

If you see an error: Make sure you did Step 3 correctly with your real API key.

That’s it! You’re ready to find arbitrage opportunities. Try: oa prizepicks

🎮 Quick Start (For Beginners!)

Now that you’re installed, here’s how to use it:

Find Your First Arbitrage Opportunity

What is arbitrage? It’s when you can bet on both sides of a game and make money no matter who wins!

Super simple 3-step process:

  1. Open Terminal
  2. Type this command: 
    oa prizepicks
  3. Wait 5 seconds - It will show you opportunities like this: 
    Player: LeBron James
Side: Over 25.5 points
PrizePicks: -137 (use your free square)
DraftKings: +120 (bet $50 on Under)
Guaranteed Profit: $12.50

How to use this:

  • Use your PrizePicks free square on “LeBron Over 25.5”
  • Bet $50 on DraftKings for “LeBron Under 25.5”
  • You profit $12.50 no matter what happens!

That’s it! You just found a guaranteed profit opportunity.

Find Hedge Betting Opportunities

# Default: Compare Fliff vs DraftKings
oa hedge

# Custom bookmakers
oa hedge --bookmaker fanduel betmgm

# Specific sport
oa hedge --sports basketball_nba

View Live Odds

# Show current odds (default: Fliff, all sports)
oa odds

# Specific bookmaker
oa odds --bookmaker draftkings

# Multiple bookmakers and sports
oa odds --bookmaker fliff draftkings --sports basketball_nba americanfootball_nfl

Check API Status

# Check your API key status and remaining quota
oa api-status

# Verbose output with details
oa api-status --verbose

📋 Common Commands

Core Commands

Command Short Description
oa prizepicks oa pp Find PrizePicks arbitrage
oa hedge oa h Find hedge opportunities
oa odds oa o Display live odds
oa api-status oa status Check API quota

Sport-Specific Shortcuts

oa nba                     # NBA odds
oa nba --hedge             # NBA arbitrage opportunities
oa nba --bookmaker draftkings

oa nfl                     # NFL odds
oa nfl --hedge             # NFL arbitrage

oa mlb                     # MLB odds
oa nhl                     # NHL odds
oa wnba                    # WNBA odds
oa ncaaf                   # NCAA Football odds

🏈 Supported Sports & Bookmakers

Sports

  • NFL - American Football
  • NBA - Basketball
  • MLB - Baseball
  • NHL - Hockey
  • WNBA - Women’s Basketball
  • NCAA Football - College Football

Bookmakers

  • Fliff - Social sportsbook (sweeps casino style)
  • DraftKings - Major US sportsbook
  • FanDuel - Major US sportsbook
  • BetMGM - MGM’s sportsbook
  • Caesars - Caesars sportsbook
  • PointsBet - Australian-based book
  • PrizePicks - Daily fantasy picks

💡 Practical Examples

Example 1: PrizePicks Free Square Strategy

# Step 1: Find opportunities
oa prizepicks

# Example Output:
# Player: LeBron James
# Side: Over 25.5 points
# PrizePicks: -137 (use your free square)
# DraftKings: +120 (hedge bet)
# Guaranteed Profit: $12.50

# Step 2: Execute
# - Use PrizePicks free square on LeBron Over 25.5
# - Bet $50 on LeBron Under 25.5 at DraftKings
# - Profit guaranteed regardless of outcome

Example 2: Finding Hedge Opportunities

# Compare multiple bookmakers
oa hedge --bookmaker fliff draftkings fanduel

# Example Output:
# Game: Lakers vs Warriors
# Fliff: Lakers +110, Warriors -130
# DraftKings: Lakers -105, Warriors +125
# Arbitrage: 2.3% guaranteed return
# Strategy: Bet Lakers on DraftKings, Warriors on Fliff

Example 3: Daily Monitoring Routine

# Morning routine - check all opportunities
oa hedge                    # General arbitrage scan
oa prizepicks              # Free square opportunities
oa api-status              # Check remaining API quota

# Game day focus
oa nba --hedge             # NBA-specific arbitrage
oa nfl --bookmaker draftkings fanduel  # NFL odds comparison

Example 4: Data Collection for Analysis

# Gather odds data for later analysis
oa odds --bookmaker fliff draftkings fanduel --no-cache

# This creates timestamped JSON files like:
# multi_bookmaker_moneylines_20241123_143022.json
# Use these files for your own analysis and strategies

📊 Understanding the Output

Arbitrage Display

Matchup               Books           Min Loss  Book1 Odds  Book2 Odds  Strategy
Lakers @ Warriors     Fliff vs DK     -2.1%     +110/-130   -105/+125   Away/Home
  • Min Loss: Negative = profit, positive = loss
  • Strategy: Which sides to bet (Away/Home or Home/Away)
  • Books: Which bookmakers to use

PrizePicks Display

Player           Side   Point  Market     PrizePicks  DraftKings  Profit
LeBron James     Over   25.5   points     -137        +120        $12.50

🔧 Advanced Features

API Key Cycling

Use multiple API keys for higher request limits:

# Set up multiple keys
export ODDS_API_KEYS="key1,key2,key3"

# Check status of all keys
oa api-status --verbose

Caching System

  • Default cache: 5 minutes
  • Use --no-cache to force fresh data
  • Automatic cleanup on restart
  • Reduces API usage for repeated queries

Data Export

All commands automatically save data to JSON files with timestamps for later analysis and record-keeping.

🚨 Troubleshooting

API Issues

# Check your API key status
oa api-status --verbose

# Test with fresh data
oa odds --bookmaker fliff --no-cache

# Verify API key is set
echo $ODDS_API_KEY

Common Errors

“Using demo API keys”

  • Set up your real API key (see setup section above)

“Rate limit hit”

  • Wait for quota to reset (usually hourly)
  • Add more API keys for higher limits
  • Use caching to reduce API calls

“No data available”

  • Sport may be out of season
  • Bookmaker may be temporarily down
  • Try a different bookmaker or sport

Performance Tips

# Reduce API usage by being specific
oa nba --bookmaker fliff           # Just one sport and bookmaker

# Use cache for repeated analysis
oa hedge                           # Uses cached data if available
oa hedge --no-cache               # Forces fresh API call

📈 Betting Strategy Tips

Risk Management

  • Start Small: Test with minimum bets first
  • Bankroll Management: Never bet more than 1-2% of total bankroll
  • Verify: Always double-check odds on bookmaker websites
  • Compliance: Follow all bookmaker terms of service

Maximizing Profits

  • Multiple Accounts: Have accounts with several bookmakers
  • Fast Execution: Odds change quickly - act fast
  • Fresh Data: Use --no-cache during active trading
  • Record Keeping: Document all bets for tax purposes

For Sweeps Casino Players

  • Fliff Integration: Fliff is a sweeps casino with sports betting
  • Free Play: Use sweeps coins for low-risk hedge opportunities
  • Cross-Platform: Combine sweeps winnings with hedge strategies
  • Bankroll Building: Use arbitrage to grow your bankroll safely

📥 Download & Installation Summary

One-Command Install

curl -L https://www.bankbonimus.com/assets/downloads/install-odds-api-suite.sh | bash

Manual Install

  1. Download odds-api-suite.tar.gz
  2. Download install-odds-api-suite.sh
  3. Run: bash install-odds-api-suite.sh

Set Up Your API Key

# Get your FREE API key at https://the-odds-api.com/
# (Sign up takes 30 seconds, free tier = 500 requests/month)

# Set up your API key (replace with YOUR key)
export ODDS_API_KEY="your-actual-key-from-the-odds-api-com"

# Test installation
oa api-status

System Requirements

  • Platform: Windows, macOS (M1/Intel), Linux
  • Python: 3.8 or higher
  • Internet: Required for live odds
  • API Key: FREE from the-odds-api.com (required - get your own)

⚠️ Important Disclaimers

  • Educational Purpose: This tool is for educational and analytical purposes
  • API Keys: You must provide your own API key - the package does not include working keys
  • No Credentials Included: This is open-source software with no private keys or credentials
  • Verify Everything: Always verify odds on official bookmaker websites
  • Betting Risk: Never bet more than you can afford to lose
  • Legal Compliance: Follow all local laws regarding sports betting
  • Terms of Service: Comply with all bookmaker terms and conditions
  • Not Financial Advice: This tool does not provide financial advice

📚 Additional Resources

  • Run oa COMMAND --help for detailed help on any command
  • Free API tier: 500 requests/month at the-odds-api.com
  • Commands auto-save data to JSON files for analysis
  • Cache system reduces API usage automatically

Ready to find your first arbitrage opportunity? Install now and start analyzing odds:

curl -L https://www.bankbonimus.com/assets/downloads/install-odds-api-suite.sh | bash
export ODDS_API_KEY="your-key-here"
oa prizepicks