{"id":2821,"date":"2026-04-10T10:00:00","date_gmt":"2026-04-10T10:00:00","guid":{"rendered":"https:\/\/oddspapi.io\/blog\/?p=2821"},"modified":"2026-09-16T15:01:57","modified_gmt":"2026-09-16T15:01:57","slug":"volleyball-odds-api-live-odds","status":"publish","type":"post","link":"https:\/\/oddspapi.io\/blog\/volleyball-odds-api-live-odds\/","title":{"rendered":"Volleyball Odds API: 214 Books Price a EuroVolley Fixture"},"content":{"rendered":"

What a Volleyball Odds API Returns on a Real Fixture<\/h2>\n

France v Romania, CEV EuroVolley, two hours before first serve. One call to \/odds<\/code> returned 214 bookmakers<\/strong> and 20 distinct market IDs<\/strong>: match winner, five individual set winners, eleven set handicap rungs and three total-sets lines. Pinnacle sat on the board at 1.168 for France with a limit of 4,464 on the Romania side.<\/p>\n

Three days out, a German 2. Bundesliga fixture on the same feed returned 14 books and 3 markets.<\/p>\n

Both numbers are true, and the gap between them is the thing nobody tells you before you scope a volleyball project. Board width tracks the tier of the competition and the clock. Write your code for the fixture you actually plan to trade, then check it against the tier you actually plan to cover.<\/p>\n

Board Width Across One Snapshot<\/h2>\n

Every priced volleyball fixture on the board at 15:00 UTC on 16 September 2026, pre-match only:<\/p>\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Competition<\/th>\nFixture<\/th>\nTime to start<\/th>\nBooks<\/th>\nMarket IDs<\/th>\n<\/tr>\n<\/thead>\n
CEV EuroVolley<\/td>\nFrance v Romania<\/td>\n2h<\/td>\n214<\/strong><\/td>\n20<\/td>\n<\/tr>\n
CEV EuroVolley<\/td>\nPoland v Bulgaria<\/td>\n1h<\/td>\n212<\/td>\n20<\/td>\n<\/tr>\n
CEV EuroVolley<\/td>\nNetherlands v Estonia<\/td>\n2h<\/td>\n209<\/td>\n20<\/td>\n<\/tr>\n
CEV EuroVolley<\/td>\nCzechia v Slovenia<\/td>\n4h<\/td>\n142<\/td>\n20<\/td>\n<\/tr>\n
South American Championship<\/td>\nArgentina v Colombia<\/td>\n2h<\/td>\n151<\/td>\n15<\/td>\n<\/tr>\n
Pan American Cup, Women<\/td>\nUSA v Canada<\/td>\n11h<\/td>\n107<\/td>\n19<\/td>\n<\/tr>\n
Pan American Cup, Women<\/td>\nGuatemala v Venezuela<\/td>\n7h<\/td>\n82<\/td>\n20<\/td>\n<\/tr>\n
2. Bundesliga (GER)<\/td>\nTUS Mondorf v Etv Hamburg<\/td>\n74h<\/td>\n19<\/td>\n3<\/td>\n<\/tr>\n
2. Bundesliga (GER)<\/td>\nMLK Volleys Koln v Usc Braunschweig<\/td>\n73h<\/td>\n14<\/td>\n3<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

Pinnacle priced 9 of the 17 pre-match fixtures in that snapshot. It anchors the national-team boards and skips the German second tier, which matches how it treats lower divisions in other sports<\/a>.<\/p>\n

The Volleyball Market Board Is 20 Definitions<\/h2>\n

Volleyball carries 20 market definitions in the feed, across 8 families. That is the whole board, and the EuroVolley fixtures above carried all 20 of them. Counts are the number of books posting each market on France v Romania:<\/p>\n

\n\n\n\n\n\n\n\n\n
Market ID<\/th>\nMarket<\/th>\nPeriod<\/th>\nBooks<\/th>\n<\/tr>\n<\/thead>\n
231<\/code><\/td>\nWinner<\/td>\nresult<\/code><\/td>\n203<\/td>\n<\/tr>\n
233<\/code> \/ 235<\/code> \/ 237<\/code> \/ 239<\/code> \/ 2311<\/code><\/td>\nFirst through Fifth Set Winner<\/td>\np1<\/code> to p5<\/code><\/td>\n170 down to 43<\/td>\n<\/tr>\n
2313<\/code> \/ 2315<\/code> \/ 2317<\/code><\/td>\nTotal Sets Over Under 3.5 \/ 4.0 \/ 4.5<\/td>\nresult<\/code><\/td>\n171 \/ 45 \/ 168<\/td>\n<\/tr>\n
2319<\/code> to 2339<\/code><\/td>\nSet Handicap, 11 rungs from -2.5 to +2.5<\/td>\nresult<\/code><\/td>\n147 at -1.5<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

Two things to know before you hardcode anything. The set handicap ladder carries whole-number rungs (-2.0<\/code>, -1.0<\/code>, 0.0<\/code>, +1.0<\/code>, +2.0<\/code>) alongside the half rungs, and a whole rung can push. The individual set winners carry a period<\/code> of p1<\/code> through p5<\/code> while everything else is result<\/code>, so group on period<\/code> and not on the market name.<\/p>\n

Step 1: Find the Tournaments That Have Fixtures<\/h3>\n

\/tournaments<\/code> needs sportId<\/code>. Leave it out and you get MISSING_PARAMETER<\/code> rather than the full list.<\/p>\n

import os, requests\n\nAPI_KEY = os.environ[\"ODDSPAPI_API_KEY\"]\nBASE_URL = \"https:\/\/api.oddspapi.io\/v4\"\n\ntournaments = requests.get(\n    f\"{BASE_URL}\/tournaments\",\n    params={\"apiKey\": API_KEY, \"sportId\": 23},\n).json()\n\nlive = [t for t in tournaments\n        if t[\"upcomingFixtures\"] or t[\"futureFixtures\"] or t[\"liveFixtures\"]]\nlive.sort(key=lambda t: t[\"futureFixtures\"] + t[\"upcomingFixtures\"], reverse=True)\n\nprint(f\"{len(tournaments)} volleyball tournaments, {len(live)} with fixtures on the board\")\nfor t in live[:8]:\n    print(f'  {t[\"tournamentId\"]:>6}  {t[\"tournamentName\"][:38]:40} '\n          f'future={t[\"futureFixtures\"]:>4} upcoming={t[\"upcomingFixtures\"]}')<\/code><\/pre>\n
That returned 313 tournaments, 58 of them holding fixtures: NCAA Women’s Regular Season (778 scheduled), the German 2. Bundesliga (326), Italy’s Serie A2 Women (272) and Japan’s SV League Women (263), which opens on 10 October.<\/p>\n
A scheduled fixture is not a priced fixture. Sportsbooks open a volleyball board somewhere between a few days and a few hours out, so a fixture list that runs months ahead will sit at hasOdds: false<\/code> until the books arrive. Check the flag, then call \/odds<\/code> to find out how wide the board really is.<\/p>\n
Step 2: Measure the Board, Don’t Assume It<\/h3>\n
import os, requests, time\nfrom datetime import date, timedelta\n\nAPI_KEY = os.environ[\"ODDSPAPI_API_KEY\"]\nBASE_URL = \"https:\/\/api.oddspapi.io\/v4\"\n\n\ndef call(path, **params):\n    \"\"\"A 429 body is valid JSON, so check the error key before you read a payload.\"\"\"\n    for _ in range(5):\n        payload = requests.get(f\"{BASE_URL}\/{path}\",\n                               params={\"apiKey\": API_KEY, **params}, timeout=120).json()\n        error = payload.get(\"error\") if isinstance(payload, dict) else None\n        if error and error[\"code\"] == \"RATE_LIMITED\":\n            time.sleep(error.get(\"retryMs\", 2000) \/ 1000 + 0.5)\n            continue\n        return payload\n    raise RuntimeError(\"rate limited five times\")\n\n\ntoday = date.today()\nfixtures = call(\"fixtures\", sportId=23,\n                **{\"from\": today.isoformat(),\n                   \"to\": (today + timedelta(days=9)).isoformat()})\n\npriced = [f for f in fixtures if f[\"hasOdds\"]]\nprint(f\"{len(fixtures)} fixtures in the window, {len(priced)} carry odds\\n\")\n\nfor fixture in priced:\n    time.sleep(1.0)\n    books = call(\"odds\", fixtureId=fixture[\"fixtureId\"])[\"bookmakerOdds\"]\n    market_ids = {mid for b in books.values() for mid in b[\"markets\"]}\n    print(f'{len(books):>4} books  {len(market_ids):>2} markets  '\n          f'pinnacle={\"pinnacle\" in books!s:5} '\n          f'{fixture[\"participant1Name\"]} v {fixture[\"participant2Name\"]}')<\/code><\/pre>\n
Two gotchas are baked into that snippet. \/odds<\/code> takes a fixtureId<\/code> and returns a single object keyed on bookmakerOdds<\/code>; pass sportId<\/code> instead and you get a 400. And a rate-limit response is a 200-shaped JSON body with an error<\/code> key, so a script that reads bookmakerOdds<\/code> straight out of the payload will read a throttle as an empty board.<\/p>\n
Step 3: Read the Market Definitions<\/h3>\n
\/markets<\/code> takes sportId<\/code> and ignores it. You get all 33,115 definitions in the feed, every sport, every rung. Filter on the sportId<\/code> field yourself.<\/p>\n
definitions = requests.get(f\"{BASE_URL}\/markets\", params={\"apiKey\": API_KEY}).json()\nvolleyball = {str(m[\"marketId\"]): m for m in definitions if m[\"sportId\"] == 23}\nprint(f\"{len(definitions)} market definitions in the feed, {len(volleyball)} of them volleyball\")\n\nFIXTURE = \"id2300062465840714\"   # France v Romania, CEV EuroVolley\nbooks = requests.get(f\"{BASE_URL}\/odds\",\n                     params={\"apiKey\": API_KEY, \"fixtureId\": FIXTURE}).json()[\"bookmakerOdds\"]\n\nposted = {}\nfor book in books.values():\n    for market_id in book[\"markets\"]:\n        posted[market_id] = posted.get(market_id, 0) + 1\n\nfor market_id, count in sorted(posted.items(), key=lambda kv: -kv[1]):\n    d = volleyball[market_id]\n    line = f' {d[\"handicap\"]:+.1f}' if d[\"marketName\"] in (\"Set Handicap\", \"Total Sets Over Under\") else \"\"\n    print(f'  {market_id:>5}  {count:>3} books  {d[\"marketName\"]}{line}  [{d[\"period\"]}]')<\/code><\/pre>\n
Step 4: Guard the Quote Before You Rank It<\/h3>\n
214 books is the payload. It is not the number of prices you can bet into.<\/p>\n
Run the set handicap at -1.5 through four checks and the field drops to 135. Sixty-seven books were suspended or had the market switched off. Eleven posted two legs whose changedAt<\/code> stamps sat hours apart, which is a quote that moved on one side and went stale on the other. One shipped half the market: 1xbet returned First Set Winner with a single outcome attached, and a one-legged market computes a margin of minus 12.74%, which is how a naive scanner invents an arb that was never on the screen.<\/p>\n
import os, requests, statistics\nfrom collections import Counter\nfrom datetime import datetime\n\nAPI_KEY = os.environ[\"ODDSPAPI_API_KEY\"]\nBASE_URL = \"https:\/\/api.oddspapi.io\/v4\"\nFIXTURE = \"id2300062465840714\"   # France v Romania, CEV EuroVolley\nMARKET = \"2323\"                  # Set Handicap -1.5\n\ndefinitions = {str(m[\"marketId\"]): m\n               for m in requests.get(f\"{BASE_URL}\/markets\", params={\"apiKey\": API_KEY}).json()\n               if m[\"sportId\"] == 23}\nlegs_expected = definitions[MARKET][\"marketLength\"]\n\nbooks = requests.get(f\"{BASE_URL}\/odds\",\n                     params={\"apiKey\": API_KEY, \"fixtureId\": FIXTURE}).json()[\"bookmakerOdds\"]\n\nquotes, dropped = {}, Counter()\nfor slug, book in books.items():\n    market = book[\"markets\"].get(MARKET)\n    if book[\"suspended\"] or not market or not market[\"marketActive\"]:\n        dropped[\"suspended or market off\"] += 1\n        continue\n    prices, stamps = {}, []\n    for outcome_id, outcome in market[\"outcomes\"].items():\n        price = outcome[\"players\"][\"0\"]\n        if price[\"active\"] and price[\"price\"] > 1.0:\n            prices[outcome_id] = price[\"price\"]\n            stamps.append(datetime.fromisoformat(price[\"changedAt\"].replace(\"Z\", \"+00:00\")))\n    # A book can ship half a market. Count against the definition, not against what arrived.\n    if len(prices) != legs_expected:\n        dropped[\"partial market\"] += 1\n        continue\n    # Legs repriced hours apart are not a quote you can bet into.\n    if (max(stamps) - min(stamps)).total_seconds() > 600:\n        dropped[\"stale leg\"] += 1\n        continue\n    quotes[slug] = prices\n\nprint(f\"{len(books)} books on the fixture, {len(quotes)} quote a complete {MARKET}\")\nfor reason, count in dropped.items():\n    print(f\"  dropped {count}: {reason}\")\n\nmargins = {s: sum(1 \/ v for v in p.values()) - 1 for s, p in quotes.items()}\nprint(f\"\\nmedian margin {statistics.median(margins.values()) * 100:.2f}%, \"\n      f\"tightest {min(margins, key=margins.get)} at {min(margins.values()) * 100:.2f}%\")\n\ntuples = Counter(tuple(sorted(p.items())) for p in quotes.values())\nprint(f\"{len(quotes)} quotes, {len(tuples)} distinct price pairs, \"\n      f\"largest cluster {tuples.most_common(1)[0][1]} books\")\n\nfor outcome_id in sorted(next(iter(quotes.values()))):\n    slug, price = max(((s, p[outcome_id]) for s, p in quotes.items()), key=lambda x: x[1])\n    print(f\"  outcome {outcome_id}: best {price} at {slug}, \"\n          f\"pinnacle {quotes.get('pinnacle', {}).get(outcome_id)}\")<\/code><\/pre>\n
Output on the EuroVolley fixture:<\/p>\n
214 books on the fixture, 135 quote a complete 2323\n  dropped 67: suspended or market off\n  dropped 11: stale leg\n  dropped 1: partial market\n\nmedian margin 7.80%, tightest asports.bet at 4.75%\n135 quotes, 24 distinct price pairs, largest cluster 33 books\n  outcome 2323: best 1.416 at asports.bet, pinnacle 1.416\n  outcome 2324: best 3.15 at winbet.bg, pinnacle 2.93<\/code><\/pre>\n
Now dedupe. Those 135 guarded quotes carry 24 distinct price pairs, and the largest single cluster is 33 slugs posting the same two numbers. cloneOf<\/code> does not catch this; independent brands land on identical prices because they buy the same feed. Collapse on the price tuple before you average anything or claim a book count, or your consensus is one trading desk counted 33 times.<\/p>\n
On match winner the same fixture ran 203 books, a median margin of 6.95%, and 54 distinct price pairs. Betfair’s exchange was tightest at 3.26%, Pinnacle next at 4.81% with limits of 750 and 4,464.<\/p>\n
Step 5: Check the Participant Order<\/h3>\n
One more guard, and it costs nothing to run. On Sweden v Slovakia earlier the same day, 199 books quoted match winner and 19 of them had the two participants the other way round<\/strong>: 180 books had Sweden around 1.54, those 19 had the same outcome ID at 2.02 to 2.95. Take the top price off that board without checking and you have backed Slovakia while your spreadsheet says Sweden.<\/p>\n
Anchor on the majority, or on Pinnacle when it is present, and drop the books that disagree about which side is favourite:<\/p>\n
from collections import Counter\n\nfavourite = Counter(min(p, key=p.get) for p in quotes.values()).most_common(1)[0][0]\nagreed = {s: p for s, p in quotes.items() if min(p, key=p.get) == favourite}\nprint(f\"{len(quotes) - len(agreed)} books list the participants in the opposite order\")<\/code><\/pre>\n
Free Historical Volleyball Odds<\/h2>\n
Test coverage on a fixture that has been played. A live \/odds<\/code> call outside the market-open window reports a false zero, and for a sport where books open the board hours rather than weeks ahead, that is most of the calendar.<\/p>\n
Poland v Serbia, CEV EuroVolley Women, played on 6 September. Pinnacle shipped 11 markets, 798 snapshots and 617 price moves on that one fixture:<\/p>\n
PLAYED = \"id2300062374375050\"   # Poland v Serbia, 6 Sep 2026\n\npayload = requests.get(f\"{BASE_URL}\/historical-odds\",\n                       params={\"apiKey\": API_KEY, \"fixtureId\": PLAYED,\n                               \"bookmakers\": \"pinnacle\"}).json()\n\n# \/historical-odds keys on \"bookmakers\". \/odds keys on \"bookmakerOdds\".\nseries = payload[\"bookmakers\"][\"pinnacle\"][\"markets\"][\"231\"][\"outcomes\"]\n\nfor outcome_id, outcome in series.items():\n    snapshots = outcome[\"players\"][\"0\"]\n    moves = [s for i, s in enumerate(snapshots)\n             if i == 0 or s[\"price\"] != snapshots[i - 1][\"price\"]]\n    live = [s for s in snapshots if s[\"active\"]]\n    limits = [s[\"limit\"] for s in snapshots if s[\"limit\"]]\n    print(f'outcome {outcome_id}: {len(snapshots)} snapshots, {len(moves)} price moves')\n    print(f'  open  {snapshots[0][\"price\"]:>6} at {snapshots[0][\"createdAt\"]}')\n    print(f'  close {live[-1][\"price\"]:>6} at {live[-1][\"createdAt\"]}')\n    print(f'  limit {min(limits):.0f} to {max(limits):.0f}')<\/code><\/pre>\n
Pinnacle opened the match at 21:00:41 on 5 September, sixteen hours before first serve, with Poland at 2.77 and Serbia at 1.454. It closed Poland 2.08 and Serbia 1.763. The limit on the Serbia side climbed from 55 to 1,132 across those sixteen hours, which is the shape you want for a closing-line study: the small early number is a placeholder, and the real money arrives late.<\/p>\n
Two other books on the same fixture: 1xbet logged 2,160 snapshots and 1,125 price moves, betano 1,430 and 454. Collapse consecutive identical prices before you count repricing. The feed stores a snapshot whether or not the number moved, and the inflation factor is specific to the book, so a raw snapshot count ranks the poller rather than the trading desk. The same lesson shows up on bet365 historical odds<\/a>, where 230,515 snapshots collapse to 29,569 real moves.<\/p>\n
Live Volleyball Odds Over WebSocket<\/h2>\n
A volleyball set turns over in minutes and the set handicap moves with it. Polling every thirty seconds across a 200-book board burns your request budget and still misses the move. The WebSocket feed<\/a> pushes each price change as the book publishes it, which is the only sane way to track the p1<\/code> to p5<\/code> set markets while a match is running.<\/p>\n
One caveat that applies in play and not pre-match: bookmakerIsActive<\/code> is not a liveness flag once the match starts. Read the price-level active<\/code> flag and changedAt<\/code> instead.<\/p>\n
FAQ<\/h2>\n
What sport ID is volleyball in OddsPapi?<\/h3>\n
Volleyball is sportId: 23<\/code>. Beach volleyball is a separate sport at sportId: 30<\/code>.<\/p>\n
How many bookmakers price a volleyball fixture?<\/h3>\n
It depends on the tier and how close the fixture is. A CEV EuroVolley national-team fixture measured two hours out on 16 September 2026 carried 214 bookmakers and all 20 volleyball markets. A German 2. Bundesliga fixture three days out carried 14 books and 3 markets. Call \/odds<\/code> on the fixture you care about rather than working from a headline number.<\/p>\n
How many markets are available per volleyball match?<\/h3>\n
Volleyball carries 20 market definitions: match winner (231<\/code>), the five individual set winners (233<\/code>, 235<\/code>, 237<\/code>, 239<\/code>, 2311<\/code>), three total-sets lines (2313<\/code>, 2315<\/code>, 2317<\/code>) and eleven set handicap rungs (2319<\/code> to 2339<\/code>). The EuroVolley fixtures above carried all 20.<\/p>\n
Which bookmakers cover volleyball?<\/h3>\n
Pinnacle anchors the national-team boards and posted 1.168 against 5.21 with limits up to 4,464 on France v Romania. Betfair’s exchange was tightest on that fixture at 3.26%. The rest of the 214 include SBOBet, 1xbet, bwin, unibet, draftkings and the crypto cohort led by bcgame, which posted all 20 markets.<\/p>\n
Does OddsPapi cover NCAA volleyball?<\/h3>\n
NCAA Women’s Regular Season is tournament ID 43847 and held 778 scheduled fixtures when this post was measured. Bookmaker coverage follows the sportsbooks rather than the schedule, so read hasOdds<\/code> on the fixture and then call \/odds<\/code> to see the board.<\/p>\n
Can I get historical volleyball odds?<\/h3>\n
Yes, on the free tier. Pinnacle’s board on Poland v Serbia carried 798 snapshots across 11 markets, opening sixteen hours before first serve at 2.77 and closing at 2.08. Use \/historical-odds<\/code> on a played fixture, and note that it keys on bookmakers<\/code> where \/odds<\/code> keys on bookmakerOdds<\/code>.<\/p>\n
Is there a free tier for volleyball data?<\/h3>\n
Yes. The free tier includes 250 requests a month, and historical odds are included at no extra cost.<\/p>\n