Overview
Match and aggregate prediction markets across exchanges into canonical events with a single API.
PredictorSDK is an API that matches sports prediction markets across Kalshi, Polymarket, Predict, SX.Bet, AlphaArcade (moneylines), ProphetX (moneylines and verified NFL props), Pred (NFL game lines and NBA moneylines), Limitless (NFL moneylines), and Hyperliquid (NFL moneylines), and serves market and event detail from all nine platforms. It normalizes equivalent markets into canonical events where cross-platform matching is available, with a unified catalog for provider-native markets.
Public API scope
These docs and the OpenAPI reference cover the public consumer API only. Internal dashboard billing routes and provider webhook handlers are intentionally excluded from the public contract.
What it does
- Cross-platform market matching — merge equivalent markets across sources into one event with stable IDs and normalized sub-market keys
- Unified market catalog — list and inspect provider-native markets across supported platforms, including Hyperliquid HIP-4 outcome markets and AlphaArcade binary/multi-choice markets
- OpenAPI-first, SDK-generated — the public API surface is spec-driven, so SDKs regenerate cleanly with no manual override layer. Download the canonical OpenAPI YAML.
- Direct canonical and source lookup — look up matching markets by canonical event ID, or by any venue's market or event ID as
{provider}:{id}
How it works
- Ingest — fetch active market catalogs from connected platforms and normalize source-specific fields
- Match — group equivalent markets into game-level events and cross-source sub-markets
- Serve — query one API endpoint or generated SDK method to consume unified market data
Coverage
Leagues
Canonical event IDs are {league}-{away}-{home}-{date}, so the league is the first segment — nba-okc-sas-2026-10-20 is an NBA game.
| League | Platforms matched |
|---|---|
| NBA | Kalshi, Polymarket, Predict (moneyline, and spread and total when it lists them), SX.Bet, ProphetX (moneyline), Pred (moneyline) |
| WNBA | Kalshi, Polymarket, SX.Bet, AlphaArcade (moneyline, when it lists a game) |
| NHL | Kalshi, Polymarket, Predict, SX.Bet, AlphaArcade (moneyline and single-line spread), ProphetX (moneyline) |
| MLB | Kalshi, Polymarket, Predict, SX.Bet, ProphetX (moneyline), AlphaArcade (moneyline, when it lists a game) |
| NFL | Kalshi, Polymarket, Predict (moneyline), SX.Bet, ProphetX (moneyline and verified props), Pred (moneyline, spread, and total), Limitless (moneyline), Hyperliquid (moneyline, spread, and total), AlphaArcade (moneyline, when it lists a game) |
A game carries the venues that list it. "When it lists" marks a venue that is mapped for that league but listed no matchable games there on 2026-10-10, or lists them only near the game: Predict's team-match listing held no NBA or WNBA games (its NBA games sit under a variant of their own that matching reads: 39 of the 43 NBA events carried Predict's moneyline, and the games nearest their start also carried its spreads and totals) and, in the NFL, only moneylines (its NFL spreads and totals match when it lists them), AlphaArcade matched no WNBA, MLB or NFL game, and Pred lists no WNBA games. NFL is full-game moneyline, spread, and total, half and quarter spreads and totals on Kalshi, Polymarket, and SX.Bet (SX.Bet lists no second half or fourth quarter; Kalshi's and Polymarket's second halves count overtime and match each other), team totals (a team's own points, full game and first half) on Kalshi and Polymarket, plus verified player props with explicit rule comparisons. ProphetX lists only about a week of fixtures per league, so it carries a game once the venue opens it (verified live on NFL, MLB, NBA and NHL).
Market types
| Market Type | Platforms |
|---|---|
| Moneyline (full) | Kalshi, Polymarket, Predict, SX.Bet, AlphaArcade, ProphetX, Pred (NFL and NBA), Limitless (NFL), Hyperliquid (NFL) |
| Spread (full, halves, quarters) | Kalshi, Polymarket, SX.Bet, Pred (NFL full game), AlphaArcade (NHL single-line full game), Predict (NBA and NFL full game, when it lists them), Hyperliquid (NFL full game, when it lists them); a second half or fourth quarter matches only venues with the same overtime rule |
| Total (full, halves, quarters) | Kalshi, Polymarket, SX.Bet, Pred (NFL full game), Predict (NBA and NFL full game, when it lists them), Hyperliquid (NFL full game, when it lists them); a second half or fourth quarter matches only venues with the same overtime rule |
| Team total (NFL: full game, first half) | Kalshi, Polymarket; Polymarket also lists a second half, which counts overtime and has no second venue yet |
| NFL player props (same-prop policy) | Kalshi, Polymarket, ProphetX; availability varies by statistic and line |
| Player Points | Kalshi, Polymarket |
| Player Rebounds | Kalshi, Polymarket |
| Player Assists | Kalshi, Polymarket |
| HIP-4 outcome markets | Hyperliquid |
| Binary/multi-choice markets | AlphaArcade |
| Sports exchange game lines, halves, and player props | ProphetX |
Half and quarter lines are NBA, WNBA, and NFL only. Half and quarter moneylines
are not matched, because venues settle a tied period differently; Kalshi's
period winner legs are matched as the team's −0.5 spread instead. A
second-half or fourth-quarter line is matched under its own overtime rule, read
from the venue's market text: a line that counts overtime carries incl_ot in
its key and rules.settlement, and joins only other lines that count it, while
a line that excludes overtime keeps its plain key and joins only those.
Sources has the per-venue detail.
All player-prop rows require verified identity and the selected settlement policy. See the player-prop guide for current coverage.
Next steps
- Quickstart — make your first API call in under a minute
- Authentication — get and use your API key
- API Reference — full endpoint documentation with interactive playground