Migrating from the-odds-api in 5 minutes

The whole migration: one URL change

If you're using the-odds-api.com directly, swap the base URL to parlay-api.com. That's it.

# Python (requests)
- BASE_URL = "https://api.the-odds-api.com/v4"
+ BASE_URL = "https://parlay-api.com/v1"

r = requests.get(
    f"{BASE_URL}/sports/baseball_mlb/odds",
    params={"markets": "h2h", "regions": "us"},
    headers={"X-API-KEY": "YOUR_PARLAYAPI_KEY"},
)

If you're using their official the-odds-api SDK, point it at our base URL via the SDK's config option, or migrate to plain requests / fetch. Most users do the latter; the response is identical.

// JavaScript (fetch)
- const BASE = "https://api.the-odds-api.com/v4";
+ const BASE = "https://parlay-api.com/v1";

const events = await fetch(
  `${BASE}/sports/baseball_mlb/odds?markets=h2h®ions=us`,
  { headers: { "X-API-KEY": YOUR_KEY } }
).then(r => r.json());

Endpoint compatibility

Sport keys: 100% identical for US majors

You don't need to change a single sport_key string for these:

• baseball_mlb, basketball_nba, americanfootball_nfl, icehockey_nhl
• americanfootball_ncaaf, basketball_ncaab, basketball_wnba
• mma_mixed_martial_arts, mma_ufc
• soccer_epl, soccer_spain_la_liga, soccer_germany_bundesliga, soccer_italy_serie_a, soccer_france_ligue_one
• soccer_uefa_champs_league, soccer_uefa_europa_league, soccer_conmebol_copa_libertadores

We add 60+ sport keys the-odds-api doesn't carry: French Ligue 2, Brazilian Serie B, Korean KBO baseball, Japanese NPB, Polish Ekstraklasa, Swiss Super League, Czech table tennis, esports leagues (CS2, LoL, Valorant, Dota 2), and more. Full list at /v1/sports?all=true.

Bookmaker keys: superset

Every bookmaker key the-odds-api uses, we use. We just have 19 more on top.

The same keys

draftkings, fanduel, betmgm, caesars, pointsbetus, williamhill_us, betonlineag, betrivers, bovada, mybookieag, pinnacle, unibet_us, wynnbet.

Additional keys we ship

• Exchanges: novig, prophetx, sportrade
• DFS pick'em: prizepicks, underdog, sleeper, pick6, betr
• Prediction markets: kalshi, polymarket
• French books: betclic, pmu, unibet_fr, winamax
• UK / EU: bet365, fliff, esportsbet
• Plus: fanatics, espnbet, hardrockbet

Pricing comparison

Credit costs per call are similar (1 credit per book per market). Compare your current monthly the-odds-api spend against ours at the same call volume; most teams cut their bill by 60-85%.

What's actually different (the honest part)

Things you gain

• Player props on the same /odds endpoint with markets=player_*
• WebSocket streaming for real-time updates (no polling)
• Prediction-market integration (Kalshi, Polymarket) on supported events
• DFS pick'em ingestion (PrizePicks, Underdog, etc.)
• Built-in /best-line endpoint for line-shopping bots
• Free tier exists (the-odds-api requires a paid plan past 500 credits)

Things to know

• Player prop closing-line history starts 2026-04-24. Game-line closing history goes back to 1999 for NFL, 2017 for NBA. If you need pre-2026 prop history, that data does not exist in any public archive (this is a structural gap, not a ParlayAPI limit).
• Refresh cadence is 30 to 60 seconds per book on REST tiers. Pro+ adds WebSocket streaming with sub-second updates.
• Some niche the-odds-api sports (cricket regional leagues, certain Asian markets) we do not cover yet. Check /v1/sports?all=true first.

Common gotchas

Authentication header

Both APIs accept X-API-KEY as a header. We also accept ?apiKey= as a query param for compatibility with code that uses the-odds-api's older docs. Either works.

Rate limits

We rate-limit per API key at 500 requests/minute on free, 2,000/min on Starter+, 10,000/min on Pro+, custom on Business+. Throttle in your client to stay under the limit.

Response timestamps

Same commence_time ISO-8601 UTC format. Same last_update per bookmaker. No code change needed.

Bookmaker filter

Same ?bookmakers= comma-separated key list. We support all keys the-odds-api does plus the additional ones above.

Ready?

Sign up gets you an API key in 30 seconds. No credit card. Free tier supports real testing volume (1,000 credits/month).