# Racing odds API

Thoroughbred, harness and greyhound races in Australia and New Zealand: the field, win and place prices from every bookmaker we record, results with dividends, tote pools, form and strike rates.

> Racing needs a paid plan (Starter, Pro or Business) or the Pro trial; Developer keys get `403 Plan restriction`. Opening and closing prices, market movers and racing arbs need Pro or Business. We may add fields, and we say so in the [changelog](https://sockodds.com/docs/changelog/) before anything changes shape.

## What is covered

- **Codes.** Thoroughbred (`thoroughbred`), harness (`harness`) and greyhound (`greyhound`) racing.
- **Meetings.** Australian (`AUS`) and New Zealand (`NZL`) meetings, from the day before until race time, grouped by track and day.
- **Bookmakers.** Fixed-odds win and place prices from the 11 racing bookmakers we record: Sportsbet, TAB, PointsBet, Unibet, Dabble, BetDeluxe, BetRight, SwiftBet, Mintbet and PlayUp, and Betfair Exchange back and lay prices with the size available and the amount matched. Every paid plan sees them all.
- **The field.** Each runner's number, name, barrier, jockey (the driver in harness), trainer, weight, apprentice claim, form figures, silk colours, and whether it is scratched or an emergency. For the race: class and conditions, prize money, track condition, weather, rail position and places paid.
- **Results.** Placings with the prices the placegetters paid, scratchings with deductions, tote pool totals and tote dividends, and Betfair Starting Price for every runner.
- **Tote pools.** Pool totals and each runner's approximate tote dividend while betting is open, then the declared dividends.
- **Opening and closing prices** (Pro and Business): the first price we recorded for each runner and the last one before the jump.
- **Price movement** (paid plans): every change of a win or place price, by runner and bookmaker, from 16 November 2026.
- **Market movers and racing arbs** (Pro and Business): the runners whose price moved most since it opened, and bookmaker win prices that beat the Betfair lay.
- **Form and strike rates.** Each runner's recent starts, and jockey and trainer win and place rates, counted from the races we recorded.

Racing has its own routes under `/v1/racing/`, separate from the sport routes. A race id names the code, date, country, meeting and race number, such as `thoroughbred_2026-11-17_AUS_sampleton_r1`. Race ids are permanent: a race keeps its id from the first time we list it, and an id never names a different race. Store it as returned and do not build one yourself; it is not an `ev_` event id. A meeting id is its races' id without the race number, such as `thoroughbred_2026-11-17_AUS_sampleton`.

## Where the data comes from

- **The field detail, tote pools, dividends and deductions** are read from TAB's race pages: about every 20 minutes in the three hours before a race, every minute in the last 15, and again once the race is resulted.
- **Betfair Starting Price** comes from the daily BSP files Betfair publishes for Australian races. They arrive the day after the race, so `betfair_sp` is empty until then.
- **Fixed-odds and exchange prices** are the ones we record from the 11 racing bookmakers above.
- **Form and strike rates** are computed only from the races we recorded, from 1 August 2026. They are figures over that record, not a runner's, jockey's or trainer's full career.

## Coverage dates

| Data | From |
| --- | --- |
| Results and recorded starts (form, strike rates) | 1 August 2026 |
| Price movement | 16 November 2026, 23:09 UTC |
| Field detail, tote pools and dividends read live | 18 November 2026 |

Races before a date carry `null` (or an empty list) for that data rather than a guess. Dividends and the prices paid come with a result where the TAB result page was recorded.

## What we do not offer

- **Sectional times and speed maps.** We know of no lawful free source for them.
- **Race replays** or any video.
- **Ratings from paid form providers.** Form here is the starts we recorded ourselves.
- **An archive before August 2026.** We serve only what we recorded, so a runner's earlier career is not listed.

## The routes

| Route | What it returns | Plans |
| --- | --- | --- |
| `GET /v1/racing/races` | Races in start order, 25 a page (up to 100). Filter with `code`, `country`, `starts_after` and `starts_before`. | Paid plans |
| `GET /v1/racing/races/{race_id}` | One race with its field, the race detail and, once it is resulted, the placings. | Paid plans |
| `GET /v1/racing/races/{race_id}/odds` | Win and place prices for every runner, one entry per bookmaker. Add `snapshots=opening,closing` on Pro and Business. | Paid plans |
| `GET /v1/racing/races/{race_id}/history` | Price changes for one race in a window of up to 24 hours (`from` and `to`). | Paid plans |
| `GET /v1/racing/meetings` | Meetings with their races in start order, and the track condition, weather and rail position last stated. Same filters and window as the races list. | Paid plans |
| `GET /v1/racing/results` | Resulted races with placings, prices paid, scratchings, tote pools and dividends. The last 24 hours by default. | Paid plans |
| `GET /v1/racing/races/{race_id}/result` | One race's full result, with Betfair Starting Price. | Paid plans |
| `GET /v1/racing/races/{race_id}/tote` | TAB tote pools and dividends for one race. | Paid plans |
| `GET /v1/racing/movers` | Runners whose price moved most since it opened, in races still to run. | Pro, Business |
| `GET /v1/racing/arbs` | Bookmaker win prices against the Betfair Exchange win lay that return a profit either way. | Pro, Business |
| `GET /v1/racing/races/{race_id}/form` | Each runner's form figures and its last recorded starts before this race. | Paid plans |
| `GET /v1/racing/runners/form` | One runner's recorded starts, by `code` and `name`. | Paid plans |
| `GET /v1/racing/races/{race_id}/connections` | Jockey, trainer and jockey-trainer strike rates for every runner in a race. | Paid plans |
| `GET /v1/racing/connections` | Strike rate for one jockey (or driver), one trainer or the two together, by `code`. | Paid plans |

With no window, `GET /v1/racing/races` and `GET /v1/racing/meetings` list races from 6 hours ago to 48 hours ahead. A window you give may span at most 8 days. For example, `GET /v1/racing/races?code=thoroughbred&country=AUS&limit=10` lists the next Australian thoroughbred races, and each race's `id` is what the other routes take.

Race lists, race cards and meetings cost no credits. A race's odds cost 1 credit per region (5 with `snapshots=`), and its price movement costs 10. Results cost 2 credits a call; one race's result, tote, form or connections, a runner's form and a strike rate cost 1. Market movers and racing arbs cost 10 a call. A call that returns no data costs nothing. See [Plans and limits](https://sockodds.com/docs/plans-and-limits/#how-credits-are-counted).

## Reading a race's prices

Each runner carries a `prices` list with one entry per bookmaker. `win` and `place` are decimal prices. On Betfair Exchange, `win` and `place` are the best back prices, and the entry adds `win_lay`, `place_lay`, the size available at each price in AUD (`win_back_size`, `win_lay_size`, `place_back_size`, `place_lay_size`), the amount matched (`win_matched`, `place_matched`) and how many places the place market pays (`place_winners`).

Illustrative response for one runner (invented track, runner and prices, not real bookmaker odds):

```json
{
  "data": {
    "race": {
      "id": "thoroughbred_2026-11-17_AUS_sampleton_r1",
      "code": "thoroughbred",
      "meeting": { "name": "Sampleton", "state": "NSW", "country": "AUS" },
      "race_number": 1,
      "name": "Maiden Plate",
      "distance_m": 900,
      "scheduled_start": "2026-11-17T01:40:00.000Z",
      "jumped_at": null,
      "status": "open",
      "runner_count": 5,
      "bookmaker_count": 10,
      "updated_at": "2026-11-17T00:02:07.000Z"
    },
    "runners": [
      {
        "number": 4,
        "name": "Sample Star",
        "barrier": 2,
        "scratched": false,
        "prices": [
          { "bookmaker": "betfair_exchange", "bookmaker_name": "Betfair Exchange", "win": 4.8, "win_lay": 5.0, "win_back_size": 120.5, "win_lay_size": 64.0, "win_matched": 2310.4, "place": 1.9, "place_lay": 2.1, "observed_at": "2026-11-17T00:01:58.000Z", "available": true },
          { "bookmaker": "sportsbet", "bookmaker_name": "Sportsbet", "win": 4.5, "place": 1.8, "observed_at": "2026-11-17T00:01:40.000Z", "available": true },
          { "bookmaker": "tab", "bookmaker_name": "TAB", "win": 4.6, "place": 1.85, "observed_at": "2026-11-17T00:01:45.000Z", "available": true }
        ]
      }
    ]
  },
  "meta": { "count": 1, "cursor": null },
  "links": { "next": null }
}
```

- **`available`** is true while the race has not jumped and the price was seen in the last 600 seconds. A price that is older, or any price once the race has jumped, is still shown with `available: false` and its `observed_at`, so you can tell a quiet market from a stale one.
- **Scratched runners** stay in the list with `scratched: true` and no prices.
- **`jumped_at`** is set when we first see the race off. `status` is `open`, `resulted` or `abandoned`.

## The race card

`GET /v1/racing/races/{race_id}` returns the race with `class_conditions` (such as `BM64` or `3YO+ MDN`), `prize_money` (AUD), `track_condition` (such as `GOOD4` or `SOFT6`), `weather`, `rail_position` and `places_paid` (the places the tote pays), as TAB's race page states them. Each runner adds `weight_kg` (thoroughbreds), `claim_kg` (the apprentice claim), `form_figures` (last starts, newest last; `x` is a spell), `silk` (the colours in words) and `emergency`. Each is `null` until we have read the race page; `class_conditions`, `prize_money` and `track_condition` are on every race in the races list too.

```json
{
  "data": {
    "id": "thoroughbred_2026-11-17_AUS_sampleton_r1",
    "code": "thoroughbred",
    "meeting": { "name": "Sampleton", "state": "NSW", "country": "AUS" },
    "race_number": 1,
    "distance_m": 1200,
    "status": "open",
    "class_conditions": "BM64",
    "prize_money": 40000,
    "track_condition": "GOOD4",
    "weather": "FINE",
    "rail_position": "True",
    "places_paid": 3,
    "runners": [
      { "number": 1, "name": "Sample Star", "barrier": 4, "jockey": "J Rider", "trainer": "T Trainer", "scratched": false, "silk": "Red, white cap", "weight_kg": 58.5, "claim_kg": 1.5, "form_figures": "1x234", "emergency": false }
    ],
    "result": null
  },
  "meta": { "count": 1, "cursor": null },
  "links": { "next": null }
}
```

`GET /v1/racing/meetings` groups the same races by meeting: `id`, `code`, `date`, `name`, `state`, `country`, the latest `track_condition`, `weather` and `rail_position`, `race_count`, `first_start`, `last_start` and `races`, each with its id, number, class, prize money, start, status and `has_result`.

## Opening and closing prices

On Pro and Business, add `snapshots=opening`, `snapshots=closing` or both to the odds route. Each runner then carries `opening` and `closing`, each with a `win` and a `place` entry: the price, the bookmaker that offered it and when we saw it. `closing` is the last price we recorded before the jump, with the Betfair Exchange back and lay at the jump; it is `null` until the race has jumped.

## Price movement

On a paid plan, `GET /v1/racing/races/{race_id}/history?from=...&to=...` returns every change of a win or place price for the race, in the order we saw them: `runner_number`, `bookmaker`, `market` (`win` or `place`), `decimal_odds` and `observed_at`. A window may span at most 24 hours, and movement is recorded from 16 November 2026 23:09 UTC. `limit` is 1,000 by default and at most 5,000; when `meta.truncated` is true, ask again from the last `observed_at`.

## Results, dividends and Betfair SP

`GET /v1/racing/races/{race_id}` carries a short `result` once a race is resulted: `placings` by runner number and position for the placed runners (usually the first four; two runners on the same position is a dead heat), and the `scratched` numbers. Until then it is `null`. A result can take a few hours after the race to appear, and a race that no source has resulted within 24 hours keeps a `null` result rather than a guess. Racing results are not graded into verdicts the way sport [results](https://sockodds.com/docs/results/) are.

`GET /v1/racing/races/{race_id}/result` returns the full result:

- **`placings`**: runner number, position and name, with the prices the placegetters paid: TAB fixed (`fixed_win`, `fixed_place`), tote (`tote_win`, `tote_place`) and Betfair Starting Price (`bsp_win`, `bsp_place`).
- **`scratched`**: each scratched runner with its `win_deduction` and `place_deduction` as TAB states them.
- **`pools`** and **`dividends`**: each tote pool's total (AUD) and the declared dividends by pool (`win`, `place`, `quinella`, `exacta`, `trifecta`, `first_four` and the multi-race pools TAB declared), with the runner numbers each dividend is for.
- **`betfair_sp`**: every runner's Betfair Starting Price for win and place, with the pre-play and in-play traded range and volume (AUD).

TAB's figures appear on plans that include TAB, and Betfair's on plans that include Betfair Exchange; otherwise those fields are `null` or empty. `GET /v1/racing/results` lists resulted races with the same placings, scratchings, pools and dividends (without `betfair_sp`), the last 24 hours by default; a window may span at most 8 days, back to 1 August 2026.

```json
{
  "data": {
    "race": { "id": "thoroughbred_2026-11-17_AUS_sampleton_r1", "status": "resulted" },
    "result": {
      "placings": [
        { "runner_number": 1, "position": 1, "name": "Sample Star", "fixed_win": 4.4, "fixed_place": 1.7, "tote_win": 4.6, "tote_place": 1.8, "bsp_win": 4.9, "bsp_place": 1.85 },
        { "runner_number": 2, "position": 2, "name": "Demo Dancer", "fixed_win": 3.2, "fixed_place": 1.5, "tote_win": 3.1, "tote_place": 1.45, "bsp_win": 3.3, "bsp_place": 1.52 }
      ],
      "scratched": [ { "runner_number": 4, "win_deduction": 0.12, "place_deduction": null } ],
      "pools": [ { "pool": "win", "total": 12043.46, "status": "closed" } ],
      "dividends": [
        { "pool": "win", "selections": [1], "dividend": 4.6 },
        { "pool": "quinella", "selections": [1, 2], "dividend": 7.7 }
      ],
      "recorded_at": "2026-11-17T02:05:00.000Z"
    },
    "betfair_sp": [
      { "runner_number": 1, "market": "win", "bsp": 4.9, "pre_play_wap": 4.7, "morning_wap": 5.2, "pre_play_max": 5.6, "pre_play_min": 4.4, "in_play_max": 6.0, "in_play_min": 1.01, "morning_volume": 820.5, "pre_play_volume": 15400.0, "in_play_volume": 3100.0 }
    ]
  },
  "meta": { "count": 1, "cursor": null },
  "links": { "next": null }
}
```

## Tote pools

`GET /v1/racing/races/{race_id}/tote` returns TAB's tote pools for one race: `pools` (each pool's total in AUD), `runners` (each runner's `tote_win` and `tote_place` dividend) and, once the race is resulted, `dividends`. `stage` is `approximate` while betting is open, since the dividends move with the pool until it closes, and `final` after the result; it is `null` when we have not read the pools yet. A plan without TAB gets `403 Plan restriction`.

```json
{
  "data": {
    "race": { "id": "thoroughbred_2026-11-17_AUS_sampleton_r1", "status": "open" },
    "source": "tab",
    "stage": "approximate",
    "observed_at": "2026-11-17T01:31:00.000Z",
    "pools": [ { "pool": "win", "total": 12043.46, "status": "open" }, { "pool": "first_four", "total": 900.5, "status": "open" } ],
    "runners": [ { "number": 1, "name": "Sample Star", "scratched": false, "tote_win": 4.6, "tote_place": 1.8 } ],
    "dividends": []
  },
  "meta": { "count": 1, "cursor": null },
  "links": { "next": null }
}
```

## Market movers

On Pro, `GET /v1/racing/movers` lists runners in races still to run with their opening win price (the first price any bookmaker showed, and which one) against the median and the best current fixed-odds win price, largest move first. `change` is (median now - opening) / opening: negative is firming, positive is drifting. Only prices seen in the last 600 seconds count, and Betfair Exchange is not part of the median. Filter with `code`, `country`, `bookmakers`, `min_change` (0.1 by default) and `direction` (`firming`, `drifting` or `any`). It looks at races from now to `starts_before`: 3 hours ahead by default, 24 at most.

```json
{
  "race": { "id": "thoroughbred_2026-11-17_AUS_sampleton_r1", "code": "thoroughbred", "meeting": { "name": "Sampleton", "state": "NSW", "country": "AUS" }, "race_number": 1, "scheduled_start": "2026-11-17T01:40:00.000Z" },
  "runner_number": 1,
  "runner_name": "Sample Star",
  "opening": { "decimal_odds": 8.0, "bookmaker": "sportsbet", "observed_at": "2026-11-16T22:10:00.000Z" },
  "current": { "median": 5.5, "best": 5.8, "best_bookmaker": "tab", "bookmaker_count": 9, "observed_at": "2026-11-17T01:20:00.000Z" },
  "change": -0.3125,
  "direction": "firming"
}
```

## Racing arbs

On Pro, `GET /v1/racing/arbs` lists the win market in races still to run where the best fixed-odds win price at a bookmaker beats the Betfair Exchange win lay price, so backing at the bookmaker and laying on the exchange returns a profit whichever way the race goes. `commission` is the exchange commission you pay (0.05 unless you pass yours; `meta.commission` echoes it).

- **`margin`** = back × (1 - commission) / (lay - commission) - 1: the profit per unit staked on the back bet.
- **`lay_stake_per_unit`** = back / (lay - commission): lay that many units for each unit you back.
- **`lay.size`** is the AUD available at the lay price; check it covers your lay stake.

Both prices were seen in the last 600 seconds. Place markets are not compared, because place terms differ between a bookmaker and the exchange. Filter with `code`, `country`, `bookmakers`, `min_margin` and `starts_before` (3 hours ahead by default, 24 at most). Prices move: check both before betting.

```json
{
  "race": { "id": "thoroughbred_2026-11-17_AUS_sampleton_r1", "code": "thoroughbred", "meeting": { "name": "Sampleton", "state": "NSW", "country": "AUS" }, "race_number": 1, "scheduled_start": "2026-11-17T01:40:00.000Z" },
  "runner_number": 1,
  "runner_name": "Sample Star",
  "market": "win",
  "back": { "bookmaker": "tab", "decimal_odds": 5.5, "observed_at": "2026-11-17T01:20:00.000Z" },
  "lay": { "bookmaker": "betfair_exchange", "decimal_odds": 5.0, "size": 85.0, "observed_at": "2026-11-17T01:20:10.000Z" },
  "lay_stake_per_unit": 1.1111,
  "margin": 0.0556
}
```

Movers and arbs answers are reused for 20 seconds, so asking more often than that returns the same list.

## Form

`GET /v1/racing/races/{race_id}/form` returns every runner in the race with its `form_figures` (as on TAB's race page) and `starts`: its last starts before this race that we recorded, newest first (5 by default, up to 10 with `limit`). Each start has the race id, `start` time, meeting, distance, class, track condition, jockey, trainer, barrier, weight, `position`, `placed` (first three), `field_size` and the prices it started at (`fixed_win`, `tote_win`, `bsp`). `position` is 1 to 4 for a placegetter and `null` for a runner that finished further back. `meta.recorded_from` is `2026-08-01`.

`GET /v1/racing/runners/form?code=thoroughbred&name=Sample%20Star` returns one runner's recorded starts with the same fields (up to 20). Case, punctuation and a country suffix such as `(NZ)` are ignored. Runners are matched by name within a racing code, so two runners sharing a name in one code share a record.

```json
{
  "number": 1,
  "name": "Sample Star",
  "form_figures": "1x234",
  "starts": [
    { "race_id": "thoroughbred_2026-10-31_AUS_sampleton_r4", "start": "2026-10-31T04:15:00.000Z", "meeting": { "name": "Sampleton", "state": "NSW", "country": "AUS" }, "race_number": 4, "distance_m": 1400, "class_conditions": "MDN", "track_condition": "SOFT5", "jockey": "J Rider", "trainer": "T Trainer", "barrier": 3, "weight_kg": 57.0, "position": 2, "placed": true, "field_size": 11, "fixed_win": 6.5, "tote_win": 7.1, "bsp": 7.4 }
  ]
}
```

## Jockey and trainer strike rates

`GET /v1/racing/races/{race_id}/connections` returns each runner's `jockey` (the driver in harness), `trainer` and `combination` (the two together), each with `starts`, `wins`, `seconds`, `thirds`, `win_rate` (wins / starts) and `place_rate` (first three / starts), over the `days` before the race (365 by default, up to 730). Greyhounds have a trainer only.

`GET /v1/racing/connections?code=thoroughbred&jockey=J%20Rider` returns the same figures for one jockey, one trainer (`trainer=`) or both together, over the last `days` days, with the `first_start` and `last_start` we recorded.

```json
{
  "number": 1,
  "name": "Sample Star",
  "jockey": { "name": "J Rider", "starts": 40, "wins": 8, "seconds": 6, "thirds": 5, "win_rate": 0.2, "place_rate": 0.475 },
  "trainer": { "name": "T Trainer", "starts": 25, "wins": 3, "seconds": 4, "thirds": 2, "win_rate": 0.12, "place_rate": 0.36 },
  "combination": { "starts": 6, "wins": 2, "seconds": 1, "thirds": 0, "win_rate": 0.3333, "place_rate": 0.5 }
}
```

Strike rates count only races we recorded in the same racing code, from 1 August 2026, so they are rates over that record, not career figures.

## Limits and errors

Racing uses the same keys, rate limits and error format as the rest of the API ([errors](https://sockodds.com/docs/errors/)). A race id that is not in the expected format gets `400`, as does an unknown `code` or `country`, or a window longer than the route allows. An unknown race gets `404`. On Starter, opening and closing prices, movers and arbs get `403 Plan restriction`, and on a Developer key every racing route does. Every route and field is in the [API reference](https://sockodds.com/docs/#listRaces).
