Settled race results

The placegetters: {position, number, name, win_price, place_price, sp, sp_note, horse_ref}. win_price and place_price are the SETTLING BOOKMAKER'S FIXED prices. horse_ref (added 2026-09-21) is the same pe:<name> horse identity the runners entries carry, derived at serve time from the name on the placing and present on every placing — null off thoroughbred. It is the key that joins this placing to the same horse on another meeting; runner_ref on the matching runners entry joins the rows about this race and will not, because Racing Australia issues a new code for the same horse each day. sp is the OFFICIAL STARTING PRICE as a decimal return on a $1 stake (4.6 means $4.60), null where it is unknown — never 0. It is the settling market's own price, not our consensus and not a bookmaker's fixed price: thoroughbred SP comes from the Racing Australia results table, greyhound SP from our own collection of published results (Victorian tracks via FastTrack, every other state via the national results pages, both from 2026-09-13), and HARNESS SP IS ALWAYS NULL — no source we hold publishes it. sp_note carries Racing Australia's favouritism marker on thoroughbred runners ('F' favourite, 'EF' equal favourite) and is null everywhere else. Coverage RE-MEASURED 2026-09-08 over the whole retained store, counting only rows whose status is ran (a barrier scratching is not a starter and its price is not in this denominator): 88.6% of thoroughbred starters carry sp (2,105 of 2,375); on the greyhound races collected since 2026-09-13, 2,054 of 2,077 Victorian starters do (98.9%) and 4233 of 4596 of the other states' starters do (92.1%), both measured 2026-09-20. The Racing Australia block that held thoroughbred SP at 0% when this was last measured on 2026-09-03 has lifted and the collector has been landing meetings since. A null sp is unknown, never zero — RA prints no SP at all on some rows. On placings, sp is copied from the matching runners entry when the response is built, so the two can never disagree. On a race with no runners payload the sp and sp_note KEYS ARE ABSENT from each placing — not present and null. The copy step is what creates them and it is skipped when there is nothing to copy from, so a schema-validating consumer sees a different object shape, not a null: read them with .get(). The keys are deliberately NOT normalised in, because adding them here would change the shipped payload of every COMPLETE race too, and nothing may move under a customer mid-integration. field_status tells you which case you are in before you look.

One entry per runner: {number, box, name, position, status, abnormal, margin, time_s, dead_heat}. Presence in this list is NOT proof the runner started. status is what says so, and status is what you settle on. ⚠️ COVERAGE. Read field_status on the row FIRST — it is the per-race answer, and it is what separates a field that has not been filled yet from one that never will be. Two different facts live here. (1) WHETHER THERE IS A FIELD AT ALL. Measured 2026-09-10 across the whole retained store — 5,577 results, 2,902 of them serving runners: null: AU greyhound carried a field on 2,360 of 3,219 races, AU thoroughbred on 315 of 1,104, and AU harness, NZ thoroughbred and NZ harness on none, as no collector covered those three codes then. Since 2026-10-04 TAB New Zealand fills them (field_source: tabnz, hourly, seven-day window) and has replaced the board copies described next wherever it could match the race; /v1/racing/results/coverage gives the current share per day, code and venue. FROM 2026-09-29 harness and NZ fields come from the pre-race board (origin: board): driver, trainer, barrier, form; positions only for placegetters; no times, SP or margins. Such a field is copied from the live board when the result is first written, before the board is purged 10 minutes after the jump, so a race whose result landed after the purge still has none. On these entries "origin": "board" is set on every entry, box holds the barrier (as on thoroughbred entries), jockey is the harness DRIVER, weight_kg and form are what the board showed, status is scratched for a runner the race's scratchings or deductions name and ran otherwise, and position is set for placegetters ONLY — a null position on an origin: board entry means 'not a placegetter, or not known', never 'did not finish'. Inside the two supported codes it is not a clean ramp either: each is filled by a scheduled pass, and where that pass cannot match a race with certainty it writes nothing rather than another race's field, so past the fill window 104 of 2,201 AU greyhound races (4.7%) and 44 of 288 AU thoroughbred races (15.3%) keep runners: null for good — field_status: unavailable, and polling them will not help. runners is JSON null in every one of these cases and has never once been an empty array (0 empty arrays in the whole store, measured the same day), so runners is None is a safe test and an empty field is not a shape you have to handle. (2) THE SHAPE OF A FIELD THAT IS PRESENT, which is where the 2026-09-08 date belongs. An AU thoroughbred field WRITTEN from 2026-09-08 carries every starter plus every runner Racing Australia printed as scratched; one written before that date carries STARTERS ONLY, because the collector dropped RA's scratched rows and a stored field is never rewritten. Measured 2026-09-08, all 244 thoroughbred fields stored at that point were the old shape and 198 of them publish a deductions row for a horse absent from runners. So on an older race deductions is the list of scratchings and runners is the starters; do not read a short runners array as a small field. Greyhound fields have carried the whole field since greyhound collection began on the 2026-08-21 Sydney card — but 859 AU greyhound races carry no field at all, which is question (1) and not this one. position is the finishing position for every runner that completed the race — not just the placegetters — and is null whenever there is none: the runner did not start, or it started and did not finish (except on an origin: board entry, which carries placegetters' positions only — see above). status is ran | scratched | late_scratching | reserve (an emergency that never got a start). abnormal is the official reason cell, passed through VERBATIM from the source — on AU thoroughbred it is Racing Australia's own Finish cell whenever that cell is not a number. THERE IS NO CLOSED LIST OF CODES and you should not write a match statement that assumes one: the source invents them, and a code nobody here has seen before will reach you unchanged rather than be dropped or renamed. Everything stored to date, with counts as at 2026-09-14: Fell (101), TailedOff (32), SB (25), PulledUp (8), FF (1, Rosehill R4 on 2026-09-12), LP (1). Treat abnormal as the authoritative explanation for a missing position, and treat an unfamiliar value as a did-not-finish unless status says otherwise — which is exactly what this API does: only codes PROVEN to mean the runner never left the barrier flip status to scratched, and that list currently holds one entry, 'SB'. Anything else stays ran, deliberately, because misreading a starter as a non-starter turns a losing bet into a refund. It carries TWO families that settle in OPPOSITE directions, so read it with status and never alone. (1) A DID-NOT-FINISH reason on a row whose status is ran — Fell, PulledUp, Disqualified, TailedOff, StayedInBox, FF and LP are the ones seen so far: the runner started and simply has no finishing position, and a bet on it lost. (2) A DID-NOT-START reason on a row whose status is scratched — 'SB', Racing Australia's code for scratched at the barrier: the runner was taken out of the market before the jump, so position is null, it is in no placings entry, and bets on it were refunded while the rest of the race was deducted. An 'SB' row may still carry sp — the last price Racing Australia printed for it, kept rather than blanked because it is a real market fact about the withdrawn runner. It is NOT the basis of the deduction, and you must never derive one from the other: sp comes from RA's results table while a deduction is struck by the settling bookmaker, and they do not agree. Measured 2026-09-08 across all five stored 'SB' rows that carry a price, 1/sp equals the published win deduction on NONE of them — Varejao, Sunshine Coast R4 2026-09-06, saddlecloth 5, withdrawn about 2 minutes 20 before the jump: sp 3.70, so 1/3.70 is 0.27 in the dollar, against a published deductions row of 0.18 win and 0.15 place; Dubai Dancer, Warrnambool R5: 1/5.50 is 0.18 against a published 0.10. Settle from deductions, which is authoritative. None of the five carries a position or a margin. Telling a barrier scratching from one made days earlier is CODE-SPECIFIC, and the two collectors do not spell it the same way — do not write one rule across categories. On AU thoroughbred (Racing Australia) both are status: scratched, and abnormal is the discriminator ONLY in one direction: a barrier scratching carries 'SB'; every other scratching carries abnormal null. Both carry their saddlecloth number, both carry box null (the runner has no barrier it jumped from — RA prints 0 there and we do not pass that sentinel on), and an ordinary scratching carries sp null while an 'SB' may carry one. So abnormal == 'SB' identifies a barrier scratching; abnormal null tells you only that it was not one, not how early it happened — use deductions[].scratched_at for that. On greyhound (our own collection since 2026-09-13: FastTrack for Victorian tracks, the national results pages for every other state) abnormal is null on every scratching and status carries three values: ran, scratched (merged in from our own deductions, so it never says how late), and reserve for a rug 9/10 reserve that never got a box. late_scratching was the retired interim feed's greyhound-only value — a thoroughbred barrier scratching does NOT use it — and it is no longer emitted; scratched does not carry identical meaning in the two codes. deductions carries scratched_at for either, and is the one cross-code way to see how close to the jump a runner came out. dead_heat is true on each runner sharing a position. IDENTITY. runner_ref (ra:<code>) is the code Racing Australia published for this runner on race day. It is the same value on the closing-line, price-path and markets archives, on the live board on race day, and on /v1/racing/acceptances once that day's field has been read, so it joins this runner across every endpoint for this race. Racing Australia issues a new code for the same horse each day, so it is not a horse identity: the same horse carries a different ra: code at each meeting. horse_ref (pe:<name>) is: the registered name folded to letters and digits (trailing country parenthetical off), the same value on results, the live board, the closing-line and price-path archives, /v1/racing/horses/form, /v1/racing/horses/runs and the backfill, and it is the key to join a horse across meetings. It is derived at serve time from the name on the row, never stored, so every historical row carries it. On every racing code since 2026-10-16 — greyhound and harness runners carried a null before that and now carry the same pe:<name> fold, which for them is the only identity that joins a runner to itself across meetings. On GREYHOUNDS runner_ref IS the dog: grv:<id> for Victorian tracks as FastTrack numbers the dog and grsa:<id> elsewhere as the national results pages number it — per-dog registry ids that DO persist across meetings, in two namespaces, so a dog racing in both is two refs until mapped. runner_ref is null while a code's registry source is not yet wired. trainer and jockey come from the same official results source and may be null where that source is not yet live for the code. GREYHOUND-ONLY, ADDITIVE FROM 2026-09-21, five measured columns the results pages print. first_split_s is the first sectional in seconds exactly as the source page printed it, null where the page printed none. second_split_s is the second sectional, and is null on EVERY Victorian run because FastTrack publishes one split and not two. weight_kg is the greyhound's race-day weight in kilograms, null where the page carries no weight column at all — Western Australian meetings carry none (0 of 36 runner rows sampled 2026-09-21). pir is position-in-running text passed through as a STRING and never a number ("21" means 2nd at the first mark then 1st at the second): FastTrack's own column on Victorian runs and, since 2026-09-29, the national page's In Race Positions card elsewhere, which only some tracks print (see /v1/racing/greyhounds/form pir for the per-state rates) — the marks are each site's own, so compare PIR within one source; null where the page printed none. weather (added 2026-09-29) is the meeting's weather in the national page's OWN words ("Fine", "Light showers", "Overcast"), stamped on every entry of the field exactly as grade is; null on Victorian (FastTrack) fields, which print none, and ABSENT on fields written before it existed — measured 2026-09-29, 170 of the 2,012 stored greyhound fields carry it, from the 2026-09-27 card on. It is not on /v1/racing/greyhounds/form. grade is the race's grade in the SOURCE'S OWN WORDS — "M", "4/5" or "FFA" on the national pages, a race type such as "Tier 3 - Maiden" on FastTrack — and the two vocabularies are NOT mapped onto each other, so do not compare a Victorian grade with an interstate one. ⚠️ A STORED FIELD IS NEVER REWRITTEN, so a greyhound field written before 2026-09-21 carries none of these five keys AT ALL — absent, not null — and no thoroughbred field carries them in any era: read them with .get(). Measured on 46 freshly read race pages on 2026-09-21, a grade appeared on 46/46 races and 362/362 runner rows, a first split on 288/362 and a weight on 295/362; the rows without them are overwhelmingly rug 9/10 reserves, which never started and for which the page prints nothing. sp is the OFFICIAL STARTING PRICE as a decimal return on a $1 stake (4.6 means $4.60), null where it is unknown — never 0. It is the settling market's own price, not our consensus and not a bookmaker's fixed price: thoroughbred SP comes from the Racing Australia results table, greyhound SP from our own collection of published results (Victorian tracks via FastTrack, every other state via the national results pages, both from 2026-09-13), and HARNESS SP IS ALWAYS NULL — no source we hold publishes it. sp_note carries Racing Australia's favouritism marker on thoroughbred runners ('F' favourite, 'EF' equal favourite) and is null everywhere else. Coverage RE-MEASURED 2026-09-08 over the whole retained store, counting only rows whose status is ran (a barrier scratching is not a starter and its price is not in this denominator): 88.6% of thoroughbred starters carry sp (2,105 of 2,375); on the greyhound races collected since 2026-09-13, 2,054 of 2,077 Victorian starters do (98.9%) and 4233 of 4596 of the other states' starters do (92.1%), both measured 2026-09-20. The Racing Australia block that held thoroughbred SP at 0% when this was last measured on 2026-09-03 has lifted and the collector has been landing meetings since. A null sp is unknown, never zero — RA prints no SP at all on some rows. Null runners means the full field is not available for this race — never an empty field; every AU and NZ code carries one (AU thoroughbred, AU greyhound, AU harness, NZ harness, NZ thoroughbred). placings remains the source for the settling bookmaker's own fixed prices, and now also carries sp copied from here.

Scratched runners and the deduction applied to bets already struck. win and place are fractions of the dollar in the range 0-1 (0.34 = 34 cents in the dollar), as published by the settling bookmaker.