<<<<<<< HEAD ======= >>>>>>> origin/main MLB Odds API · Real-Time Lines, Player Props & Historical Data | ParlayAPI

MLB odds API with real-time lines, the deepest props on the board, live now

Moneylines, run lines, totals, and player props for every MLB game, aggregated from 30+ sportsbooks and sources in the last 24 hours - with sub-5-second freshness on the major books. The pennant race is on and the postseason opens September 29. Same response shape as the-odds-api, so an existing integration migrates in one URL change. Free tier, no card required.

45+
Sources, last 24h
4,000+
Prop markets (all sports)
sub-5s
Freshness, major books
1,000
Free credits / month

What the API covers for MLB

One sport key - baseball_mlb - the same key the-odds-api uses. Platform-wide figures below are measured across all 90+ sports we carry; MLB is currently the busiest sport on the pipeline.

Game linesMoneylines, run lines & totals

Full-game h2h, run line (spread), and total prices from the books that matter - DraftKings, FanDuel, Pinnacle, bet365, Caesars, BetMGM and more. Measured in the last 24 hours, 34 sources wrote MLB game-line rows, on the pipeline that processes 100k+ game-line updates per hour platform-wide.

GET /v1/sports/baseball_mlb/odds GET /v1/sports/baseball_mlb/events

Player propsHits, total bases, home runs, RBIs

MLB player props on canonical market keys: player_hits, player_total_bases, player_home_runs, player_rbis and more. Measured in the last 24 hours, 40 sources wrote over 3 million MLB prop rows across 2,800+ distinct market keys - the deepest props coverage of any sport on the board right now.

GET /v1/sports/baseball_mlb/props

Real timeStreaming & live odds

REST polling on every tier with sub-5-second freshness on major books. Business tier and above adds WebSocket streaming, so late-season line moves are pushed to you instead of burning credits on polls. See /pricing for which tiers include streaming.

wss: /ws/odds/baseball_mlb

HistoricalMLB closing lines back to 2010

111,000+ MLB closing game lines back to 2010, inside a platform archive of 1.7M+ closing game lines with continuous coverage from 2005 and 30M+ prop closing lines since June 2022 - the raw material for CLV tracking and backtesting MLB models.

GET /v1/historical/sports/baseball_mlb/odds GET /v1/historical/sports/baseball_mlb/closing-odds

Where MLB coverage stands today

MLB is in season and it shows: measured in the last 24 hours (2026-08), 34 sources wrote MLB game-line rows and 40 wrote props, more than any other sport on the board. Regular-season coverage runs through the pennant race, and the postseason follows from September 29 on the same pipeline. Verify per-book depth yourself on the live MLB coverage page - it reads from live ingest.

Check the data before you sign up

Claims are cheap. These pages read from the same live API you'd be buying, so you can verify MLB coverage yourself, right now, without an account.

Live odds board

The current MLB board, straight from the API - the same rows an /odds call returns.

parlay-api.com/live →

Coverage explorer

Which books are writing which sports and markets, measured from live ingest - including the MLB detail page.

parlay-api.com/coverage →

Status & freshness

Per-source ingest health and data freshness, updated continuously. If a book goes quiet, you'll see it here before we do a postmortem.

parlay-api.com/status →

Already on the-odds-api? Migrate in one URL change

ParlayAPI mirrors the-odds-api's v4 REST shape for MLB data: same baseball_mlb sport key, same paths, same query parameters, same response JSON. Swap the base URL and your existing code keeps working. Full guide: /migrate-from-the-odds-api.

the one-line change
# before
curl "https://api.the-odds-api.com/v4/sports/baseball_mlb/odds?regions=us&markets=h2h,spreads,totals&apiKey=YOUR_TOA_KEY"

# after
curl "https://parlay-api.com/v4/sports/baseball_mlb/odds?regions=us&markets=h2h,spreads,totals&apiKey=YOUR_PARLAY_KEY"

Where the-odds-api is the better pick

the-odds-api is older, simpler, and more battle-tested, with a much larger base of tutorials, Stack Overflow answers, and community wrappers to copy from. If your MLB needs are basic - one region, game lines only, no streaming - its smaller surface area is a genuine advantage. Our honest roundup of the-odds-api alternatives compares seven providers side by side, us included.

Quickstart

Endpoint shapes below are the real ones from the API docs. Auth is either the-odds-api-style apiKey= query param or an X-API-Key header.

curl - MLB game lines
curl "https://parlay-api.com/v1/sports/baseball_mlb/odds?regions=us&markets=h2h,spreads,totals&bookmakers=draftkings,fanduel,pinnacle" \
  -H "X-API-Key: YOUR_KEY"

# player props - one call returns all books for the sport
curl "https://parlay-api.com/v1/sports/baseball_mlb/props" \
  -H "X-API-Key: YOUR_KEY"
Python - pip install parlay-api
from parlay_api import ParlayAPI

client = ParlayAPI(api_key="YOUR_KEY")

# Tonight's board: moneylines, run lines, totals
odds = client.odds("baseball_mlb", regions="us", markets="h2h,spreads,totals")

# Player props on canonical market keys
props = client.props("baseball_mlb", markets=["player_hits", "player_home_runs"])

# De-vig a two-way prop into fair probabilities
fair_over, fair_under = ParlayAPI.devig(over_price=-110, under_price=-110)

SDK on GitHub: JacobiusMakes/parlay-api-python (MIT-licensed). Building with an AI agent instead? There's an official MCP server with 22 tools: pip install parlayapi-mcp.

MLB odds API - frequently asked

Is there a free MLB odds API?

Yes. ParlayAPI's free tier includes 1,000 credits per month with no credit card required, and it covers MLB game lines the same as paid plans. One call to /v1/sports/baseball_mlb/odds returns moneyline, run line (spread), and total prices. Current paid tiers are listed at /pricing.

Does the MLB odds API include player props?

Yes, and MLB is the deepest sport on the board right now. GET /v1/sports/baseball_mlb/props returns MLB player props - hits, total bases, home runs, RBIs, runs and more - on canonical market keys (player_hits, player_total_bases, player_home_runs, player_rbis). Measured in the last 24 hours (2026-08), 40 sources wrote over 3 million MLB prop rows across 2,800+ distinct market keys.

Can I get historical MLB odds and closing lines?

Yes. The archive holds 111,000+ MLB closing game lines back to 2010, inside a platform archive of 1.7M+ closing game lines with continuous coverage back to 2005, plus 30M+ prop closing lines since June 2022. Query /v1/historical/sports/baseball_mlb/odds for snapshots or /v1/historical/sports/baseball_mlb/closing-odds for closing lines - useful for CLV tracking and model backtests.

Is ParlayAPI compatible with the-odds-api for MLB data?

Yes - ParlayAPI mirrors the-odds-api's v4 REST shape: the same baseball_mlb sport key, the same endpoint paths, the same query parameters, and the same JSON response shape. Migrating an existing integration is a base-URL change from api.the-odds-api.com/v4 to parlay-api.com/v4 - see the migration guide. To be fair, the-odds-api is older and simpler with a larger base of tutorials; if you don't need props depth, streaming, or prediction-market signals, it remains a solid choice.

Does the API support real-time or streaming MLB odds?

Yes. REST polling is available on every tier, with sub-5-second freshness on major books. Business tier and above adds WebSocket streaming at /ws/odds/baseball_mlb, which pushes line movement to you instead of making you poll. Platform-wide we process 100k+ game-line updates per hour and roughly half a million prop updates per hour. You can watch the live board at /live before signing up.

Ready for the stretch run.

The pennant race is on and the postseason opens September 29. Sign up free - 1,000 credits a month, no card required - and have MLB lines flowing in minutes.