Getting Started

Get up and running with the HKJC Racing API in minutes.

Quick Start

The HKJC Racing API provides programmatic access to Hong Kong horse racing data including historical results, race cards, horse profiles, and live odds.

1. Get your API key

Sign up for a free account to receive your API key. Free tier includes 100 requests per day with access to historical results.

2. Make your first request

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.hkjc-api.com/api/v1/results/2025-03-01

3. Explore the response

{
  "date": "2025-03-01",
  "venue": "Sha Tin",
  "races": [
    {
      "race_number": 1,
      "race_name": "Class 4 Handicap",
      "distance": 1200,
      "going": "Good",
      "runners": [
        {
          "position": 1,
          "horse_no": "A118",
          "horse_name": "Golden Star",
          "jockey": "Z. Purton",
          "trainer": "J. Size",
          "finish_time": "1:09.45",
          "win_odds": 3.5
        }
      ]
    }
  ]
}

Base URL

All API requests use the following base URL:

https://api.hkjc-api.com/api/v1

WebSocket connections use:

wss://api.hkjc-api.com/ws/live

Next steps