Description

What is Our HK Horse Racing Dataset API?

Our HK Dataset API gives developers, analysts and businesses direct access to one of the deepest structured archives of Hong Kong horse racing available anywhere, races, runners, results, racecards, horses, jockeys, trainers, courses and veterinary records, served as clean JSON over a documented REST API.

Hong Kong racing is uniquely well suited to quantitative work: a closed, tightly regulated circuit run at just two courses, with consistent classification and remarkably complete records going back decades. That makes it the ideal dataset for modelling, backtesting and research.

📘 Full API reference: api.horseracedatabase.com/redoc

Dataset at a glance (HK)

• ~30,000 races with history reaching back to 1979
• ~364,000 runner records (one row per horse per race)
• Happy Valley and Sha Tin, complete coverage of both HKJC venues
• ~36,600 racecard summary rows for pre-race analysis
• Deep sectional data, per-section place, distance beaten, section time and first/second-half splits across up to 6 sections, covering ~178,600 runner records from 2008 onwards
• Veterinary records, an HK-exclusive dataset not available in our other regions
• Daily updates aligned to the HKJC fixture calendar: racecards ahead of each meeting, results after racing

Key features

• Historical window by plan: Essential = 2 years, Plus = 5 years, Premium = up to 10 years. Need the complete archive with no year limit? See Full Historical Unlock (HK + UK).
• Records & results with sectional data: /hk/records returns per-section place, distance beaten, section time and half-splits, the level of granularity real pace modelling needs.
• Veterinary records endpoints: query vet findings by race, by date or by horse, a genuine edge for form analysis and fitness modelling.
• Predictable REST design: consistent resource paths, JSON responses, pagination metadata (total_results, page, total_pages).
• JWT authentication: exchange your API key for a bearer token via POST /auth/token, refresh with POST /auth/refresh.
• Self-service usage visibility: track your own consumption and entitlements with /user/usage, /user/access and /user/activity.
• Per-plan throughput: higher tiers get a higher requests-per-second ceiling, so bulk jobs finish faster.
• Top-up on demand: add extra calls mid-cycle with HK add-on packs instead of upgrading tier.

Endpoints included

Authentication & account

• POST /auth/token · POST /auth/refresh
• GET /user/usage · GET /user/access · GET /user/activity

Races

• GET /hk/races · GET /hk/races/{raceID}
• GET /hk/races/date/{race_date} · GET /hk/races/course/{courseID} · GET /hk/races/racecards

Racecards

• GET /hk/racecards · GET /hk/racecards/{raceID} · GET /hk/racecards/date/{race_date}

Records & results (incl. sectional times, 2008+)

• GET /hk/records · GET /hk/records/race/{raceID}

Veterinary records (HK only)

• GET /hk/vet · GET /hk/vet/race/{raceID} · GET /hk/vet/date/{race_date} · GET /hk/vet/horse/{horseID}

Horses

• GET /hk/horses/{horseID} · GET /hk/horses/race/{raceID} · GET /hk/horses/results · GET /hk/horses/racecard
• GET /hk/horses/jockey/{jockeyID} · GET /hk/horses/trainer/{trainerID}

Jockeys

• GET /hk/jockeys/{jockeyID} · GET /hk/jockeys/race/{raceID} · GET /hk/jockeys/results · GET /hk/jockeys/racecard

Trainers

• GET /hk/trainers/{trainerID} · GET /hk/trainers/race/{raceID} · GET /hk/trainers/results · GET /hk/trainers/racecard

Courses

• GET /hk/courses · GET /hk/courses/{courseID}

Subscription plans

Free trial

• 100 calls over 7 days, €0
• Throughput: 2 req/s (burst 5)
• Explore the endpoints and response shapes before committing to a paid tier.

1. Essential

• Historical window: 2 years
• Calls: 1,500/month, annual plan: 18,000 calls/year
• Price: €19.90/month or €190/year
• Throughput: 5 req/s (burst 10)
• Ideal for: daily operational feeds, recent-form analysis and lightweight integrations. HK runs a compact fixture list, so a focused allowance goes a long way.
• Includes: racecards, results, records with sectional times, horses, races, jockey & trainer data, courses, veterinary records, daily updates and essential technical support.

2. Plus

• Historical window: 5 years
• Calls: 2,400/month, annual plan: 28,800 calls/year
• Price: €79.90/month or €790/year
• Throughput: 10 req/s (burst 20)
• Ideal for: multi-season research, feature engineering and machine-learning datasets.
• Includes: everything in Essential, a 5-year historical window, higher throughput and standard technical support.

3. Premium

• Historical window: up to 10 years
• Calls: 3,200/month, annual plan: 38,400 calls/year
• Price: €149.90/month or €1,490/year
• Throughput: 20 req/s (burst 50)
• Ideal for: long-horizon backtesting, trading tools and data-intensive products.
• Includes: everything in Plus, a 10-year historical window, top throughput, premium technical support and 1 onboarding session for setup and integration.

Monthly or annual?

• Monthly renews your call allowance every billing cycle, best for steady, ongoing consumption.
• Annual gives you 12× the monthly allowance available from day one, so you can front-load a historical backfill in the first weeks and then coast on daily updates. It also saves up to ~20% versus paying monthly (roughly two months free).

How usage works

• Every successful API request counts as 1 call against your allowance.
• List endpoints are paginated up to 50 records per page, so you control exactly how much you pull per call.
• Requests outside your plan’s historical window are rejected. Upgrade the tier or use Full Historical Unlock for deeper history.
• Exceeding your per-second throughput returns HTTP 429; simply pace or retry.
• Your live counters are always visible via GET /user/usage and in your account dashboard.

Enterprise (custom)

• Historical window: full, unrestricted, or tailored to your use case
• Volume: custom call allowances and throughput
• Ideal for: betting and trading operators, statistics platforms, media, universities and research institutions with intensive, direct integrations
• Includes: priority support with agreed response times, endpoint customisation, onboarding sessions and detailed documentation
• 👉 Talk to us about an Enterprise plan

Why choose HorseRaceDatabase.com?

• ✅ Depth: HK racing history reaching back to 1979, with sectional splits from 2008, in a consistent, query-ready structure.
• ✅ Exclusive data: veterinary records endpoints you will not find in a generic racing feed.
• ✅ Reliability: updates aligned to the real HKJC fixture calendar, with no scraping and no broken selectors.
• ✅ Developer-first: predictable JSON, real documentation, JWT auth, transparent usage endpoints.
• ✅ Flexibility: pick the historical depth you actually need, and top up calls when a project spikes.

How to get started

1. Choose your plan above, based on the historical depth and volume you need.
2. Sign up: your API key is provisioned automatically and emailed to you.
3. Get a token with POST /auth/token using your API key.
4. Integrate using the API reference.
5. Monitor your consumption from your account dashboard or GET /user/usage.

Need more API calls?

Ran short before your cycle renews? Add extra volume without changing tier with our HK Add-on Extra API Calls packs, 350 (€19.90), 1,100 (€59.90) or 3,000 (€159.90) extra calls. Add-on calls are consumed only after your base allowance is exhausted, stay valid for at least 30 days, and there is no limit on how many packs you can buy.

👉 Explore HK Add-ons

Start building with accurate, up-to-date Hong Kong horse racing data today. 🏇