Prediction Hunt

↑ ↓ move · Enter open · Esc close

API docs
REST API / Matching / Sports Matching

Sports Matching

Query matched game markets by league/title code and date across all available platforms. Returns game moneylines by default; use the types parameter to include spreads, totals, and player props. Every group is labeled with a market_class so you always know what you are looking at.

GET/v2/matching-markets/sports
Plans All plansPlan rate limits apply

Matches aren't always 100% accurate. Verify all data before executing a trade.

See how Elastics built their AI trading terminal on this endpoint →
Accepted sport codes

Pass exactly one of these values as the sport query parameter. Example: /v2/matching-markets/sports?sport=kbo&date=2026-08-13&platforms=kalshi,polymarket&types=moneyline. A valid code can return an empty games array when that league is off-season or the requested venues have no equivalent markets for the date.

Basketball

nbawnbacbbwcbbbsn

Football

nflcfbcflafl

Use nfl for the NFL. The legacy alias football also maps to nfl.

Baseball

mlbkbonpb

Hockey

nhl

Soccer

epluclefl_championshipj_leagueliga_portugaluelueclbrasileiraoargentina_primeraeredivisiesuper_ligbelgian_prolaliga2bundesliga2leagues_cupnwsllibertadoressudamericanascottish_premallsvenskaneliteseriendanish_superligalaligabundesligaligue1serieamlsligamxworld_cup

Pass the league code, never soccer. UEL and UECL include qualifying fixtures.

Tennis

atpwtaitf_menitf_women

ITF is the World Tennis Tour, the tier below ATP and WTA.

Golf

pga

Combat

ufc

Pass ufc, not mma.

Cricket

cpl_crickethundred_menhundred_women

Esports

lolcs2valorantdota2r6

Parameters

sportstringrequired

One lowercase league or esports-title code from the complete list below. Examples: sport=kbo, sport=npb, sport=efl_championship, or sport=lol. Do not pass a broad category such as soccer, baseball, basketball, cricket, esports, or mma. The legacy alias football maps to nfl.

datestring

Date in YYYY-MM-DD format. Defaults to today.

platformsstring

Comma-separated lowercase platform names, for example platforms=kalshi,polymarket. A group is returned only when it contains every platform you list. Omit this parameter to accept any available platform combination.

typesstring

Comma-separated market classes to include: moneyline, spread, total, player_prop, other - or all. Defaults to moneyline (game winners); request the rest explicitly, e.g. types=spread,total,player_prop or types=all.

Response

sportstring

The sport code that was queried.

datestring

The date that was queried (YYYY-MM-DD).

gamesobject[]

Matched groups for the given sport and date. By default only moneyline (game-winner) groups are returned; request spreads, totals, and player props with the types parameter. One game produces several groups (one per market_class) that share an event_id.

Show 13 fields
group_idinteger

Internal match group ID.

event_idinteger

ID of the game this group belongs to. Group by it to reassemble a game's moneyline, spreads, totals, and props.

event_namestring

Game name (e.g. "Los Angeles Lakers vs. Boston Celtics (7:30 PM ET)").

game_titlestring

Title of this specific group - the market_class-specific label (e.g. "Boston Celtics -5.5", "Over 213.5", "LeBron James Over 24.5 Points").

event_datestring

Date of the game (YYYY-MM-DD).

market_classstring

Type class of this group: moneyline, spread, total, player_prop, or other. Switch on this - do not parse titles. Esports fold in the same way: map handicap → spread, total maps → total (line counts maps); per-map winners and props → other.

market_typestring | null

Specific type (e.g. spread, 1h_total, player_points, method_of_victory). null for game moneylines. Open-ended; branch on market_class.

periodstring | null

full or 1H.

linenumber | null

Line for spread/total/player-prop groups (e.g. -5.5, 213.5, 24.5). Pair over/under groups on the same (event_id, line).

sidestring | null

home/away for spreads, over/under for totals and player props.

playerstring | null

Player name on player-prop groups; null otherwise.

teamstring | null

Full team name on team-line groups; null otherwise.

marketsobject[]

Markets from each platform for this group.

Show 6 fields
platformstring

Platform name (polymarket, kalshi, etc.).

market_idstring

Platform-native market ID.

source_urlstring

Direct link to the market on the platform.

yes_bidnumber

Current best bid price for YES.

yes_asknumber

Current best ask price for YES.

last_pricenumber

Last traded price.

Full API response