WC2026 SOCCER PROPSComing soon · launch date not yet set
WC2026 Soccer Player Props API
Per-player WC2026 props with competition-scoped hit rates: anytime goalscorer, to score 2+, assists, shots on target. Books typically post these markets 24 to 48 hours before each fixture, so the feed would light up across every matchday window once it ships.
1,000 req/day on the free plan (2,000 with GitHub). No credit card.
Endpoint goes live the moment the props ingest ships.
What you'll get
The same prop primitives that work for NBA and NHL, scoped honestly to the tournament. One free key, one shape.
Cross-book best line
Best over and best under per market in a single request, with the book that posted the price.
Tournament hit rates
hit_rate_competition tracks how often the player has cleared the line across their WC2026 matches, not stale club-season noise.
Unified player_id
Props join cleanly to /v1/wc2026/matches/{id}, /v1/wc2026/teams/{id}, and the rest of the tournament surface.
Matchday windows
Books post these props 24 to 48 hours before each fixture; the feed lights up across every matchday and quiets between.
Bets Chat ready
JSON envelope mirrors the NHL props shape, so existing prop integrations port over with no schema rework.
Pre-launch integration
Schema below is final. Wire it up now and the endpoint goes live the moment the props ingest ships.
Markets covered
Four core WC2026 markets at launch. Audited, no novelty props.
| Market | Description |
|---|---|
anytime_goalscorer | Yes / no: does the player score at any point in the match |
to_score_2plus | Yes / no: does the player score two or more goals (brace, hat-trick, etc.) |
assists | Over / under threshold for assists |
shots_on_target | Over / under threshold for shots on target |
Planned endpoint shape
The contract is final. Integrate against it and the endpoint goes live the moment the ingest lands.
GET /v1/wc2026/players/:id/props
{
"data": {
"player_id": "bb_player_8r3npx6szfa1",
"player_name": "Kylian Mbappé",
"match_id": "bb_match_4q7m2tzkrhxa",
"competition": "fifa_world_cup_2026",
"kickoff_utc": "2026-06-XX...",
"markets": [
{
"market": "anytime_goalscorer",
"yes_odds": -135,
"no_odds": +110,
"hit_rate_competition": 0.58,
"books_count": 9,
"best_yes": { "book": "draftkings", "price": -125 },
"best_no": { "book": "fanduel", "price": +115 }
},
{
"market": "shots_on_target",
"line": 1.5,
"over_odds": -120,
"under_odds": +100,
"hit_rate_competition": 0.62,
"books_count": 9,
"best_over": { "book": "betmgm", "price": -110 },
"best_under": { "book": "caesars", "price": +105 }
}
],
"updated_at": "2026-06-XX..."
},
"meta": { "cached": false, "cache_age_ms": 0 }
}SDK call, planned
The SDK call below is the planned shape. Wire it up now, the client method goes live alongside the endpoint.
- · Four markets returned in one call
- · Cross-book best-line attribution per market
- · Same canonical envelope as the NHL props page
import { BigBallSportsClient } from '@bigballsdata/sdk';
const client = new BigBallSportsClient(process.env.BBS_API_KEY!);
// Shape preview — launch date not yet set
const props = await client.wc2026.players.props(playerId);
for (const m of props.data.markets) {
if (m.line !== undefined) {
console.log(m.market, m.line, m.over_odds, '/', m.under_odds);
} else {
console.log(m.market, m.yes_odds, '/', m.no_odds);
}
console.log(' competition hit rate:', m.hit_rate_competition);
}What will it cost
Free tier matches the rest of the API: 1,000 req/day on the free plan, 2,000 with GitHub connected. No credit card. Paid tiers (Solo / Trio / Edge / Pro) carry forward with the rest of the API.
Frequently asked
- When does the WC2026 props endpoint go live?
- The original target was the WC2026 opener (June 11, 2026), which has passed without the endpoint shipping. There's no new launch date set. The planned shape below is stable, so the Bets Chat and any other agent can integrate against it ahead of time. We will update this page (and /whats-new) if and when it ships.
- When do the markets actually have prices?
- Sportsbooks typically post player props 24 to 48 hours before each fixture, so the feed lights up across each matchday window. Between matchdays the markets quiet. The endpoint returns an empty markets array for fixtures that are not yet open at the books.
- What does hit_rate_competition mean?
- The fraction of the player's WC2026 fixtures where they cleared the line on that market. We deliberately do NOT use a season-long club-football denominator: a national-team callup's recent club games are not the right reference for a World Cup prop. The competition-scoped hit rate is honest about the sample size and rolls forward each matchday.
- Will this expand beyond WC2026?
- Yes. Champions League and Premier League player props are planned next. They will surface under analogous paths (/v1/champions-league/players/{id}/props and so on) with hit_rate_competition scoped to each competition.
Related APIs
Other APIs you can build with:
How we compare
Also on this sport
Free calculators
Get an API key now
The endpoint goes live the moment the ingest ships. Sign up now so your key is ready when it does.