Skip to main content

Odds360 Handball

Odds360 handball is consumed in the same sequence used by the handball bookmaker pages in sportmicro-frontend:

  1. discover the match from the SportMicro handball feed
  2. request bookmaker-specific Odds360 prices for that match_id
  3. subscribe to live refreshes

Service URLs​

SportMicro handball data: https://handball.sportmicro.com/
Odds360 handball feed:   https://odds360.sportmicro.com/

Two access patterns​

  • Public Odds360 API: https://odds360.sportmicro.com/handball
  • Dashboard and bookmaker flow used by sportmicro-frontend: /bookmaker/{bookmakerId}/handball/...

Supported handball odd groups​

  • half-time
  • full-time

Odd group mapping​

  • half-time -> odds.halfTime
  • full-time -> odds.fullTime

1. Discover the match in SportMicro​

Use the handball data endpoints to obtain the match_id and basic metadata:

  • https://handball.sportmicro.com/matches-live
  • https://handball.sportmicro.com/matches-by-date
  • https://handball.sportmicro.com/matches
  • https://handball.sportmicro.com/leagues
  • https://handball.sportmicro.com/classes

Important fields:

  • id or match_id
  • league_id
  • league_name
  • home_team_name
  • away_team_name
  • start_time
  • status_type

2. Confirm that the bookmaker can access handball​

GET /bookmaker/{bookmakerId}

The response contains the bookmaker sports list.

3. Load the handball match list with prices​

GET /bookmaker/{bookmakerId}/handball/matches?page=0
GET /bookmaker/{bookmakerId}/handball/matches?page=0&status=live
GET /bookmaker/{bookmakerId}/handball/matches?page=0&league=Champions

Available query parameters:

  • page
  • league
  • homeTeam
  • awayTeam
  • status with live or upcoming

Backend behavior:

  • page size is 100
  • postponed and finished matches are excluded
  • only matches with totalOdds > 0 are returned

4. Load the full handball odds payload​

GET /bookmaker/{bookmakerId}/handball/{matchId}

Important response shape:

{
  "matchId": 2450840,
  "sport": "handball",
  "odds": {
    "halfTime": {},
    "fullTime": {}
  },
  "override": []
}

The frontend also loads:

GET /bookmaker/{bookmakerId}/handball/{matchId}/verify

5. Use the raw Odds360 REST service​

GET https://odds360.sportmicro.com/handball
GET https://odds360.sportmicro.com/handball-history
GET https://odds360.sportmicro.com/handball-classes
GET https://odds360.sportmicro.com/handball-leagues

6. Subscribe to live updates​

Updates

wss://odds360.sportmicro.com/live/{bookmaker_id}/handball/{match_id}/updates
https://odds360.sportmicro.com/live/{bookmaker_id}/handball/{match_id}/updates

Overrides

wss://odds360.sportmicro.com/live/{bookmaker_id}/handball/{match_id}/overrides
https://odds360.sportmicro.com/live/{bookmaker_id}/handball/{match_id}/overrides

Dashboard subscriptions:

GET /bookmaker/{bookmakerId}/handball/{matchId}/updates
GET /bookmaker/{bookmakerId}/handball/{matchId}/overrides

7. Optional manual overrides​

PATCH /bookmaker/{bookmakerId}/handball/{matchId}/{oddType}

Typical body:

{
  "oddKey": "market_name#outcome_key",
  "oddValue": 1.85,
  "durationSeconds": 3600,
  "suspended": false
}

WebSocket example​

const ws = new WebSocket(
  "wss://odds360.sportmicro.com/live/<bookmaker_id>/handball/<match_id>/updates"
);
ws.addEventListener("message", (ev) => console.log(JSON.parse(ev.data)));

SSE example​

const es = new EventSource(
  "https://odds360.sportmicro.com/live/<bookmaker_id>/handball/<match_id>/updates"
);
es.addEventListener("message", (ev) => console.log(JSON.parse(ev.data)));

Notes​

  • match_id should come from the handball SportMicro match feed.
  • bookmaker_id is the UUID assigned to your Odds360 bookmaker.
  • /bookmaker/... routes are the authenticated dashboard routes used by sportmicro-frontend.
  • https://odds360.sportmicro.com/... routes are the public Odds360 API routes.
  • The frontend only shows odd groups that are present and non-empty for the match.