Markets

SSTrader Markets Reference

This guide explains market_id and label_id mappings used in the SSTrader API.
Every bet selection is identified by a market_id (what type of market) and a label_id (which outcome within that market).

---

How Label IDs Work

Label IDs are NOT sequential outcome indices. Each market has its own fixed label_id mapping.
Common mistakes to avoid:

• In Under/Over markets: label_id 1 = Under, label_id 2 = Over (not the reverse)
• In 3-Way markets: label_id 0 = Draw (not label_id 3), label_id 1 = Home, label_id 2 = Away
• In Correct Score markets: label_id encodes the score itself (see below)

---

Quick Lookup Table

---

Golden Substitute Lookup Table

Golden Substitute markets are the player markets 300–313 with substitute
protection switched on. They use exactly the same logic and label_id mapping as their base
market — only the market_id differs: Golden Substitute market_id = base market_id + 50.
Example: Match Goalscorers 303 → Golden Substitute Match Goalscorers 353.
See Golden Substitute below for how these markets settle.

---

Golden Substitute

Golden Substitute keeps a player bet alive when the player is substituted: instead of the bet
being voided, it transfers to the substitute who comes on, and settles on what the two players
achieved together.

Overview

On an ordinary player market (300–313), a player who leaves the pitch takes the bet with them —
the bet is voided. On a Golden Substitute market (350–363) the bet stays in play: it is re-linked
to the substitute who replaces the player, and settles on the two players' combined performance.

• Applies to player markets only.
• Eligible markets arrive already marked as Golden Substitute, under their own market_id
  (base + 50). The set is not chosen per fixture or per market by hand.
• A Golden Substitute market is a separate market from its base market — the player, line and
  label_id are read exactly as on the base market; only the settlement rule on substitution differs.

How it works

1. Eligible player markets come through already marked as Golden Substitute, as market_id
   base + 50.
2. If no substitution happens, the bet settles normally on that player's own performance —
   Golden Substitute changes nothing, and the market behaves exactly like its base market.
3. If the player is substituted mid-match, the bet is re-linked to the designated substitute, and
   what both players do counts towards the outcome.
4. Combined outcome: the substitute picks up where the original player left off, and the
   market is judged on what the two of them did together rather than on either player alone. On
   a Player to Score market (353, label_id 0), the bet wins if either the original player
   or the substitute scores.
5. In a bet builder or combination bet, each leg is its own market, so a combination can mix
   Golden Substitute legs (35x) and ordinary legs (30x).

Worked example

A fixture carries a Match Goalscorers market on the starting striker, offered as Golden
Substitute: market_id 353, label_id 0 (Anytime) — the same label_id as Anytime on market 303.

1. The selection is placed on market 353, label_id 0 for the striker.
2. Mid-match the striker is substituted. The bet is not voided — it transfers to the
   substitute who comes on.
3. The bet wins if either the striker (before coming off) or the substitute (after coming on)
   scores.

Contrast — had the striker played the full match, the bet would settle on the striker's own
performance, exactly like market 303, label_id 0. The substitution rule only matters when a
substitution actually happens.

---

Market Definitions

Market 1 — 3Way Result (1x2)

Standard home/draw/away market for full-time result.

---

Market 2 — Asian Handicap

---

Market 3 — Goal Line (Asian Total Goals)

---

Market 4 — Match Goals (European Total Goals)

---

Market 5 — Corners Asian Handicap

---

Market 6 — Asian Total Corners

---

Market 7 — Correct Score

Label IDs encode the scoreline directly using the pattern: 1 + home goals digit + away goals digit.

Parsing rule: Remove the leading 1. The remaining digits are home_goals + away_goals.
Example: label_id 142 → remove 1 → 42 → Home 4, Away 2 → score 4:2

---

Market 11 — 1st Half 3Way Result

Same label mapping as Market 1, but for the first half only.

---

Market 12 — 1st Half Asian Handicap

---

Market 13 — 1st Half Goal Line (Asian Total Goals)

---

Market 14 — 1st Half Match Goals (European Total Goals)

---

Market 16 — 1st Half Asian Total Corners

---

Market 17 — 1st Half Correct Score

Same encoding as Market 7, but for first-half scores only.

---

Market 22 — Next Goal (n-Goal)

Which team scores the Nth goal. The specific goal number (1st, 2nd, etc.) is in the line property of the Odd object.

---

Market 50 — Draw No Bet

---

Market 51 — Half-Time / Full-Time (HT/FT)

Label IDs encode the HT result and FT result combined: HT_result + FT_result, where 1 = Home, 2 = Away, 0 = Draw (represented as 0/X).

---

Market 52 — Odd/Even (Total Goals)

---

Market 53 — Both Teams To Score (BTTS)

---

Market 54 — 1st Half BTTS

---

Market 55 — 2nd Half BTTS

---

Market 56 — Team Corners

Compound label_id: first digit = team (1 = Home, 2 = Away), second digit = outcome (1 = Under, 2 = Over).

---

Market 57 — Team Total Goals

Same compound structure as Market 56.

---

Market 58 — Double Chance

---

Market 59 — Clean Sheet

Compound label_id: first digit = team (1 = Home, 2 = Away), second digit = outcome (1 = Yes, 2 = No).

---

Market 60 - To Qualify

---

Market 203 — Asian Total Cards

---

Market 300 - Player to be booked

Which named player receives a booking in the match. The specific player is identified elsewhere in the Odd object; label_id encodes when they are booked.

---

Market 301 - 1st Player Booked

Which named player is the first to receive a booking in the match. The specific player is identified elsewhere in the Odd object; label_id encodes when they are booked.

---

Market 302 - Player to be Sent Off

Which named player is sent off in the match. The specific player is identified elsewhere in the Odd object; label_id encodes when they are sent off.

---

Market 303 — Match Goalscorers

Which named player scores in the match. The specific player is identified elsewhere in the Odd
object; label_id encodes when they score.

---

Market 304 - Team Goalscorers

Which named player scores for a specific team. The specific player is identified elsewhere in the Odd object; label_id encodes when they score.

---

Market 305 - Multi Scorers

Which named player scores multiple goals in the match. The specific player is identified elsewhere in the Odd object; label_id encodes when they score. Odd line property indicates the number of goals.

---

Market 306 - Player to Assist

Which named player provides an assist in the match. The specific player is identified elsewhere in the Odd object; label_id encodes when they assist.

---

Market 307 - Player Shots On Target

Which named player has a shot on target in the match. The specific player is identified elsewhere in the Odd object; label_id encodes when they have a shot on target. Odd line property indicates the number of shots on target.

---

Market 308 - Player Shots

Which named player has a shot in the match. The specific player is identified elsewhere in the Odd object; label_id encodes when they have a shot. Odd line property indicates the number of shots.

---

Market 309 - Player Fouls Committed

Which named player commits fouls in the match. The specific player is identified elsewhere in the Odd object; label_id encodes when they commit fouls. Odd line property indicates the number of fouls.

---

Market 312 - Goalkeeper Saves

How many saves a named goalkeeper makes in the match. The specific player is identified elsewhere in the Odd object; the Odd line property indicates the number of saves.

---

Market 313 - Score or Assist

Which named player scores or provides an assist in the match. The specific player is identified elsewhere in the Odd object; label_id encodes when they score or assist.

---

Key Rules for LLMs

1. Under = label_id 1, Over = label_id 2 — in all total/line markets (3, 4, 6, 13, 16, 203).
2. Draw = label_id 0 — in all 3-way markets (1, 11). It is NOT label_id 3.
3. Correct Score encoding — label_id always starts with 1. Strip it, then read remaining digits as home+away goals (e.g., 142 → 4:2).
4. Compound label_ids — in markets 56, 57, 59: first digit is team (1=Home, 2=Away), second digit is outcome.
5. Next Goal line property — for market 22, the goal number (1st, 2nd, etc.) is in the line field of the Odd object, not the label_id.
6. Golden Substitute = base market_id + 50 — markets 350–363 reuse the label_id mapping of 300–313 (subtract 50 to find the definition). If the player is substituted, the bet settles on the original player and the substitute combined instead of being voided.