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.

Updated

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 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

DataFrom
Results and recorded starts (form, strike rates)1 August 2026
Price movement16 November 2026, 23:09 UTC
Field detail, tote pools and dividends read live18 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

RouteWhat it returnsPlans
GET /v1/racing/racesRaces 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}/oddsWin 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}/historyPrice changes for one race in a window of up to 24 hours (from and to).Paid plans
GET /v1/racing/meetingsMeetings 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/resultsResulted races with placings, prices paid, scratchings, tote pools and dividends. The last 24 hours by default.Paid plans
GET /v1/racing/races/{race_id}/resultOne race's full result, with Betfair Starting Price.Paid plans
GET /v1/racing/races/{race_id}/toteTAB tote pools and dividends for one race.Paid plans
GET /v1/racing/moversRunners whose price moved most since it opened, in races still to run.Pro, Business
GET /v1/racing/arbsBookmaker win prices against the Betfair Exchange win lay that return a profit either way.Pro, Business
GET /v1/racing/races/{race_id}/formEach runner's form figures and its last recorded starts before this race.Paid plans
GET /v1/racing/runners/formOne runner's recorded starts, by code and name.Paid plans
GET /v1/racing/races/{race_id}/connectionsJockey, trainer and jockey-trainer strike rates for every runner in a race.Paid plans
GET /v1/racing/connectionsStrike 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.

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):

{
  "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.

{
  "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 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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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). 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.

Need help?FAQ · Email support

Search across the SockOdds documentation and catalogue.