ODDS

ODDS Channel

The ODDS channel delivers complete odds snapshots periodically during live matches.

Availability

Plan	Available
BASIC	No
PRO	No
ULTRA	Yes
MEGA	Yes

Update Frequency

Update frequency depends on your subscription scope:

• match / league scope: odds are delivered immediately when data changes

• all scope: odds are accumulated and delivered as a batch every 30 seconds (batch_update)

Events

Event	Scope	Description
odds_update	match, league	Full odds snapshot (immediate)
batch_update	all	Batched odds for all matches (every 30s)

---

odds_update

Delivers a complete snapshot of all available betting odds.

Message

{
  "type": "event",
  "channel": "ODDS",
  "scope": "match",
  "id": "12345",
  "eventType": "odds_update",
  "eventId": "def456",
  "ts": 1705314600000,
  "data": {
    "kickoff1x2": "2.10;3.40;3.50",
    "live1x2": "1.85;3.60;4.20",
    "starting1x2": "2.15;3.30;3.40",
    "kickoffOU": "1.90;1.90|2.5",
    "liveOU": "2.10;1.70|2.5",
    "startingOU": "1.85;1.95|2.5",
    "kickoffAH": "1.95;1.85|-0.5",
    "liveAH": "1.80;2.00|-0.5",
    "startingAH": "1.90;1.90|-0.5",
    "kickoffAsianCorners": "1.85;1.95|9.5",
    "liveAsianCorners": "1.90;1.90|9.5",
    "kickoff1hAH": "1.90;1.90|-0.25",
    "live1hAH": "1.85;1.95|-0.25",
    "kickoff1hGoals": "2.00;1.80|0.5",
    "live1hGoals": "2.20;1.65|0.5",
    "kickoff1hAsianCorners": "1.90;1.90|4.5",
    "live1hAsianCorners": "1.85;1.95|4.5",
    "kickoff1hResult": "2.50;2.20;3.00",
    "live1hResult": "2.30;2.40;3.20",
    "dropping1x2": "-0.05;+0.10;+0.15"
  }
}

Data Fields

Full Time Markets

Field	Format	Description
kickoff1x2	"home;draw;away"	1X2 odds at kickoff
live1x2	"home;draw;away"	Current live 1X2 odds
starting1x2	"home;draw;away"	Opening 1X2 odds
kickoffOU	"over;under|line"	Over/Under at kickoff
liveOU	"over;under|line"	Current live Over/Under
startingOU	"over;under|line"	Opening Over/Under
kickoffAH	"home;away|handicap"	Asian Handicap at kickoff
liveAH	"home;away|handicap"	Current live Asian Handicap
startingAH	"home;away|handicap"	Opening Asian Handicap

Asian Corners

Field	Format	Description
kickoffAsianCorners	"over;under|line"	Asian Corners at kickoff
liveAsianCorners	"over;under|line"	Current live Asian Corners

First Half Markets

Field	Format	Description
kickoff1hAH	"home;away|handicap"	1H Asian Handicap at kickoff
live1hAH	"home;away|handicap"	Current 1H Asian Handicap
kickoff1hGoals	"over;under|line"	1H Over/Under goals at kickoff
live1hGoals	"over;under|line"	Current 1H Over/Under goals
kickoff1hAsianCorners	"over;under|line"	1H Asian Corners at kickoff
live1hAsianCorners	"over;under|line"	Current 1H Asian Corners
kickoff1hResult	"home;draw;away"	1H Result at kickoff
live1hResult	"home;draw;away"	Current 1H Result

Odds Movement

Field	Format	Description
dropping1x2	"home;draw;away"	1X2 odds change from opening

---

Odds Formats

1X2 Format

"home;draw;away"
Example: "2.10;3.40;3.50"
- Home win: 2.10
- Draw: 3.40
- Away win: 3.50

Over/Under Format

"over;under|line"
Example: "1.90;1.90|2.5"
- Over 2.5: 1.90
- Under 2.5: 1.90
- Line: 2.5 goals

Asian Handicap Format

"home;away|handicap"
Example: "1.95;1.85|-0.5"
- Home -0.5: 1.95
- Away +0.5: 1.85
- Handicap: -0.5 for home team

Dropping Odds Format

"home;draw;away"
Example: "-0.05;+0.10;+0.15"
- Home: decreased by 0.05
- Draw: increased by 0.10
- Away: increased by 0.15

---

batch_update

Delivers a batch of odds snapshots for all live matches. Sent every 30 seconds to all scope subscribers only.

Message

{
  "type": "batch_update",
  "channel": "ODDS",
  "scope": "all",
  "timestamp": 1705314600000,
  "matches": [
    {
      "matchId": "12345",
      "leagueId": "67890",
      "data": {
        "kickoff1x2": "2.10;3.40;3.50",
        "live1x2": "1.85;3.60;4.20",
        "liveOU": "2.10;1.70|2.5",
        "..."
      }
    },
    {
      "matchId": "12346",
      "leagueId": "67890",
      "data": {
        "kickoff1x2": "1.75;3.80;4.50",
        "live1x2": "1.60;4.00;5.00",
        "liveOU": "1.95;1.85|2.5",
        "..."
      }
    }
  ]
}

Fields

Field	Type	Description
type	string	Always "batch_update"
channel	string	Always "ODDS"
scope	string	Always "all"
timestamp	integer	Batch creation timestamp in milliseconds
matches	array	Array of match updates accumulated since last batch
matches[].matchId	string	Match public ID
matches[].leagueId	string	League/Championship public ID
matches[].data	object	Odds snapshot (same fields as odds_update data)

Note: If a match has multiple updates within a 30-second window, only the latest data for that matchId is included in the batch.

---

Subscription Examples

Subscribe to all odds updates

{"action": "subscribe", "channel": "ODDS", "scope": "all"}

Subscribe to a specific match

{"action": "subscribe", "channel": "ODDS", "scope": "match:12345"}

Subscribe to a league

{"action": "subscribe", "channel": "ODDS", "scope": "league:67890"}

---

Example: Processing Odds

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);

  if (msg.type !== 'odds_update') return;

  const odds = msg.data;

  // Parse 1X2 odds
  if (odds.live1x2) {
    const [home, draw, away] = odds.live1x2.split(';').map(parseFloat);
    console.log(`1X2: Home ${home} | Draw ${draw} | Away ${away}`);
  }

  // Parse Over/Under
  if (odds.liveOU) {
    const [values, line] = odds.liveOU.split('|');
    const [over, under] = values.split(';').map(parseFloat);
    console.log(`O/U ${line}: Over ${over} | Under ${under}`);
  }

  // Parse Asian Handicap
  if (odds.liveAH) {
    const [values, handicap] = odds.liveAH.split('|');
    const [home, away] = values.split(';').map(parseFloat);
    console.log(`AH ${handicap}: Home ${home} | Away ${away}`);
  }
};

Example: Detecting Odds Movement

function parseDropping(dropping1x2) {
  if (!dropping1x2) return null;

  const [home, draw, away] = dropping1x2.split(';').map(parseFloat);

  return {
    home: { value: home, direction: home < 0 ? 'down' : 'up' },
    draw: { value: draw, direction: draw < 0 ? 'down' : 'up' },
    away: { value: away, direction: away < 0 ? 'down' : 'up' }
  };
}

// Usage
const movement = parseDropping(odds.dropping1x2);
if (movement.home.direction === 'down') {
  console.log(`Home odds dropping by ${Math.abs(movement.home.value)}`);
}

---

Notes

• Odds are only sent while the match is live

• Null values indicate the market is not available

• The snapshot includes ALL available markets, not just changed values

• For real-time delta updates, use the ODDS_REALTIME channel (MEGA plan only)

• Odds are in decimal (European) format