Basketball odds, right inside your AI assistant.
Ask Claude, ChatGPT, Codex or Copilot for live NBA, EuroLeague and 100+ competitions' odds from 6 bookmakers, or call the REST API. One API key for both.
6 bookmakers · 100+ competitions · 10-min refresh · MCP server + REST API
Just ask
Your assistant calls HoopsAPI for you: live prices, line movement, fair odds, even the code.
“What are tonight's NBA odds? Show the best moneyline for each game and which bookmaker has it.”
list_games
“Compare Pinnacle and 1xBet on Real Madrid's next EuroLeague game: handicap and total.”
list_games, get_game
“Remove the margin from Pinnacle's moneyline for the Knicks game and give me fair win probabilities.”
list_games
“Which EuroLeague games have the biggest disagreement between bookmakers right now?”
list_discrepancies · Pro plan
“How has the handicap moved on the Lakers v Warriors game since it opened?”
get_game_history · Data plan
“Write a Python script that alerts me when any bookmaker offers more than 2.10 on an NBA handicap.”
your API key in code
Connect in two minutes
Same API key as the REST API. Each tool call counts as one request. Full setup guide
- Open Customize → Connectors (Settings → Connectors in some versions), click + and choose Add custom connector.
- Name it HoopsAPI and enter the URL https://hoopsapi.com/mcp.
- Set authentication to "No sign-in" and add a request header: Authorization = Bearer YOUR_API_KEY.
- Enable the connector in a chat and ask about basketball odds.
If your account doesn't show request headers yet (Anthropic is rolling them out), use the URL https://hoopsapi.com/mcp?key=YOUR_API_KEY instead and keep it private: anyone with that URL can use your key.
- Turn on Developer mode: Settings → Apps & Connectors → Advanced settings (on Business and Enterprise plans an admin enables it).
- Create a connector, name it HoopsAPI and enter the URL https://hoopsapi.com/mcp?key=YOUR_API_KEY.
- Set authentication to "No authentication", accept the warning and create it.
- In a chat, choose Developer mode from the + menu, enable HoopsAPI and ask about basketball odds.
ChatGPT connectors can't send an API key header, so the key goes in the URL: keep that URL private, and regenerate the key from your dashboard if it leaks. Which ChatGPT plans include Developer mode changes over time; check OpenAI's help pages if you don't see it.
- Run this once; --scope user makes HoopsAPI available in every project.
claude mcp add --transport http --scope user hoopsapi https://hoopsapi.com/mcp \
--header "Authorization: Bearer YOUR_API_KEY"- Put your key in an environment variable, then add the server to ~/.codex/config.toml (or run the codex mcp add command).
# export HOOPSAPI_KEY=YOUR_API_KEY
[mcp_servers.hoopsapi]
url = "https://hoopsapi.com/mcp"
bearer_token_env_var = "HOOPSAPI_KEY"
# or: codex mcp add hoopsapi --url https://hoopsapi.com/mcp --bearer-token-env-var HOOPSAPI_KEY- Add this to .vscode/mcp.json in your project. VS Code asks for the key the first time the server starts and stores it securely.
{
"inputs": [
{ "type": "promptString", "id": "hoopsapi-key", "description": "HoopsAPI key", "password": true }
],
"servers": {
"hoopsapi": {
"type": "http",
"url": "https://hoopsapi.com/mcp",
"headers": { "Authorization": "Bearer ${input:hoopsapi-key}" }
}
}
}Multi-provider comparison
Multiple bookmakers normalised to a single schema with canonical team names. Compare odds across books in one request.
Odds movement history
Track line movement over time. Spot steam moves and sharp action before the market adjusts. Available on the Data plan.
Discrepancy detection
Automatically surfaces the biggest cross-book differences for moneyline, handicap lines, and over/under totals.
Or call the REST API
{
"count": 2,
"games": [
{
"game_id": 1627902278,
"competition": "NBA",
"home": "Cleveland Cavaliers",
"away": "Atlanta Hawks",
"start_time": "2026-04-14T23:00:00",
"providers": {
"provider_a": {
"moneyline": { "home": 1.61, "away": 2.52 },
"handicap": { "line": -4.0, "home": 1.96, "away": 1.96 },
"over_under": { "line": 237.0, "over": 1.95, "under": 1.97 }
},
"provider_b": {
"moneyline": { "home": 1.55, "away": 2.45 },
"handicap": { "line": -3.5, "home": 1.87, "away": 1.95 },
"over_under": { "line": 235.5, "over": 1.95, "under": 1.87 }
},
"provider_c": {
"moneyline": { "home": 1.57, "away": 2.50 },
"handicap": { "line": -4.5, "home": 1.80, "away": 2.00 },
"over_under": { "line": 236.5, "over": 1.83, "under": 1.83 }
}
}
}
]
}Simple, predictable pricing
Fixed daily limits. No overages. No surprises.
Frequently Asked Questions
- Can I use HoopsAPI with Claude, ChatGPT, Codex or Copilot?
- Yes. Add the HoopsAPI MCP server (https://hoopsapi.com/mcp) with your API key, then ask for odds in plain language. Each tool call counts as one request on your plan. Setup steps are at hoopsapi.com/ai.
- What bookmakers are covered?
- Multiple major bookmakers, all normalised to a single schema with canonical team names. Check the /providers endpoint for the current list.
- How often is data updated?
- Every 10 minutes for all bookmakers, including quarter and half-time markets.
- Can I use this for arbitrage or modelling?
- Yes. The discrepancies endpoint surfaces the biggest cross-book differences automatically. Historical data on the Data plan gives you full line movement.
- What happens when I hit my daily limit?
- You get a 429 response saying when your next request is available and which plan raises the limit. No overages, no surprise bills. The limit is a rolling 24 hours.
- Do you cover leagues outside the NBA?
- Over 100 competitions across 40+ countries: Euroleague, ACB, NBL, Serie A, Bundesliga, and many more.
- Is there a free trial?
- The Free tier is the trial. 10 requests per day, no time limit, no card required. Upgrade when you're ready.