# Racing Hkjc — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive horse racing data from the Hong Kong Jockey Club. Retrieve race results, detailed horse profiles including pedigree and form records, jockey and trainer season rankings, upcoming race meeting fixtures, and horse search by name.

**Category:** Sports | **Website:** [racing.hkjc.com/](https://racing.hkjc.com/) | **Docs:** [parse.bot/marketplace/c63a11c0-d95f-4ec9-9cbf-04413acbd57d/racing-hkjc-com-api](https://parse.bot/marketplace/c63a11c0-d95f-4ec9-9cbf-04413acbd57d/racing-hkjc-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-racing-hkjc-com-api-c63a11c0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_horse_profile

Retrieve comprehensive horse profile by horse ID. Returns pedigree, trainer, owner, rating, and stakes data. Field availability varies by horse — retired horses may have fewer fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `horse_id` | string | Yes | Horse ID in format like HK_2020_E436. Obtainable from search_horses results or race result finishers. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-racing-hkjc-com-api-c63a11c0/get_horse_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"horse_id":"<string>"}'
```

### get_jockey_ranking

Retrieve the current season jockey rankings/standings. Returns all active jockeys sorted by wins with their stakes won. No input required — always returns the current season data.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-racing-hkjc-com-api-c63a11c0/get_jockey_ranking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_race_meeting_fixtures

Retrieve the schedule of upcoming race meetings for the current month. Returns local and overseas race day events with dates as Unix millisecond timestamps. Automatically uses the current season and month.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-racing-hkjc-com-api-c63a11c0/get_race_meeting_fixtures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_race_results

Retrieve full race results for a specific race meeting date and race number. Returns finishers with placings, times, odds, and dividends. Metadata fields (venue, class, distance, going, course) are extracted when available from the page structure.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Race date in YYYYMMDD format (e.g., 20250608). |
| `race_no` | integer | No | Race number within the meeting (1-11 typical). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-racing-hkjc-com-api-c63a11c0/get_race_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","race_no":"<integer>"}'
```

### get_trainer_ranking

Retrieve the current season trainer rankings/standings. Returns all trainers sorted by wins with their stakes won. No input required — always returns the current season data.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-racing-hkjc-com-api-c63a11c0/get_trainer_ranking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_horses

Search for horses by name. Supports partial name matching and returns both current and retired horses. Returns horse IDs usable with get_horse_profile.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Horse name to search for (e.g., 'GOLDEN', 'LUCKY'). Supports partial matching. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-racing-hkjc-com-api-c63a11c0/search_horses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```