Race Status

Receive real-time race status updates via WebSocket.

Overview

The race status WebSocket notifies you when race states change — when a race jumps, finishes, or has a result posted.

Requires Ultimate plan.

Connect

WS/ws/live/status

Streams race status events for the current meeting.

const ws = new WebSocket(
  "wss://api.hkjc-api.com/ws/live/status?api_key=YOUR_KEY"
);

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log("Race " + data.race_number + ": " + data.status);
};

Message Format

{
  "event": "status_update",
  "race_number": 5,
  "status": "off",
  "timestamp": "2025-10-01T15:10:00+08:00"
}

Status Values

Status	Description
`scheduled`	Race is on the card but has not started
`open`	Betting is open
`closed`	Betting has closed, race is about to start
`off`	Race has jumped
`finished`	Race has finished, awaiting official result
`result`	Official result has been declared
`abandoned`	Race has been abandoned