GET /v1/racing/markets

One race, every market the panel quotes on it, book by book: the win price, the place price, the Same Race Multi legs (**Top 2, Top 3 and Top 4**), each book's market percentage, the best price per runner in each market, and — once the race has been run — the exotic dividends it paid. **Naming the race.** `race_id` is exact. Failing that, `venue` + `meeting_date` (the AET meeting date) + `race_number`; two races sharing those three answer 409 `race_ambiguous` and cost nothing, because picking one of a venue split silently would be worse than refusing. **Who quotes what.** Every book in the panel prices win, and all but the exchange price place. Top 2/3/4 come from **sportsbet, ladbrokes_au, neds and pointsbetau** — no other book in the feed publishes Same Race Multi legs, so an empty `top3` is a fact about the market and not a gap in the feed. Each leg is validated against the chain win >= top2 >= top3 >= top4 > 1.0 before it is stored, so a leg that would break it is absent rather than wrong. **overround_pct** is Σ (1/price) × 100 over the runners that book quoted in that market — 100% is a book taking no margin. It is null where a book quoted fewer than two runners, which is not a market. Place and Top-N percentages are naturally far above 100 because several runners can win the bet. **Live or stored.** A race whose market is still open is read live (`source: "live"`). Once it has been run the live rows are purged, and the answer comes from the minute-by-minute capture of the last price each book showed before the jump (`source: "closes"`). Races that jumped before that capture began carry no market rows and say so in `note`. **exotics** are SETTLED DIVIDENDS — what the tote paid — not prices. Nothing in this feed quotes fixed-odds quinella, exacta, trifecta or first four before a race, so `exotics` is null until the race is resulted, and then carries the result's own `status`: `interim` dividends can still move, `final` cannot. **quote_detail** (since 2026-09-29) lists, per book and runner, what the book publishes beside its prices: `open_price` (the book's own opening price — not the archive's first captured price), `flucs` (its recent prices, most recent first), `tote_win` / `tote_place` (its tote dividends keyed by product code; `PROV` is an indicative pre-race dividend that moves until the pool closes), `boost_price` / `boost_type`, and the exchange fields. Each entry names `bookmaker`, `number`, `name`, `runner_ref` and `seen_at` — when the book was last read — and only the fields that book carries. Who carries them, measured on the AU board of 2026-09-29 before its first race (20 races, 2,219 book-runner rows): flucs at betdeluxe, betgold, boostbet and betright on every row, open_price at betright on every row, tote_win at tabtouch on 89 of 194 rows and tote_place on 26 (a provisional dividend appears as the pool forms), no boost that morning. The exchange fields are Betfair's, and Betfair is withheld from customer answers. For a race that has been run the values are the last read before the jump. **scratchings** (since 2026-09-29) are the race's scratched runners — `name`, `number`, `barrier`, `scratched_at` (the scratching book's own time, UTC) and `vacant` for an empty box — from the open race while it is live, and once it has been purged from the capture taken at the jump. A race run before 2026-09-29 answers an empty list after its purge. A scratching no Australian bookmaker has reported, while two or more of them still price the runner, is held back: the runner stays in the markets until a bookmaker reports it. **tote_series** (since 2026-10-06) is each book's tote approximate as the pools formed: one entry per book and runner, with points at fixed marks before the jump — 3600, 1800, 900, 600, 300, 180, 120 and 60 seconds — each the first read the minute-by-minute capture saw at or inside its mark, carrying `mark_seconds`, `read_at`, `secs_to_jump` and `tote_win` / `tote_place` by product code. TABtouch publishes a provisional dividend (`PROV`) for every runner hours out; BetRight its products in the final quarter hour. A race first seen inside a mark has no earlier points: nothing is filled in. The last read before the jump stays in `quote_detail`. **book_scratchings** (since 2026-10-06) says, book by book, when a scratching reached each feed: `reported_at` is the first time that book's own feed listed it, `book_scratched_at` the scratch time the book itself states (Ladbrokes, Neds, BetRight and the BetMakers books carry one), and `first_quoted_at` / `last_quoted_at` with `last_quoted_win` the polls, to the minute, at which that book's feed still carried a win price for the runner after the race's scratchings named it. Ladbrokes and Neds keep a scratched runner's last price on the card beside their own flag, so for a book that flags it the price is recorded once, at the flag: its price at the scratching. A book that carries a price with no flag is recorded each minute until it clears the runner. None of these prices is served as a price: a scratched runner is dropped from every price endpoint. **Your own links** (`source_link` beside each runner's `source_url`, since 2026-10-14, Plus and above): store your bookmaker link templates once with `PUT /v1/link-templates` and each price also carries a ready-made link built through them. Absent where there is nothing to link, and for an account with no stored templates. Plus and above, and Standard keys issued before 20 September 2026. Every other key below Plus receives a 403 and is not charged; the 403 carries a `sample`: the winner of one recent race, its best price in each market and the book that offered it.

Request

curl 'https://api.puntersedge.online/v1/racing/markets' \
  -H 'X-API-Key: YOUR_KEY'

Parameters

Responses

Status codes: 200, 401, 402, 403, 404, 409, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json — this call costs 2 credits. Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

{
  "race": {
    "race_id": "81db7342-2e44-482a-bf62-5d5166d764f5",
    "venue": "Tatura",
    "race_number": 1,
    "category": "horse",
    "country": "AU",
    "start_time": "2026-09-29T03:30:00Z",
    "places_paid": 3,
    "status": "resulted",
    "source": "closes"
  },
  "markets": [
    {
      "market": "win",
      "places": 1,
      "bookmakers": [
        {
          "key": "betright",
          "runners_quoted": 9,
          "overround_pct": 120.34,
          "observed_at": "2026-09-29T03:29:36.794038Z",
          "runners": [
            {
              "number": 1,
              "name": "Alpha Mensae",
              "runner_ref": "ra:NDIzMzYyNjA2MjQ",
              "horse_ref": "pe:alphamensae",
              "price": 17.0,
              "source_url": null
            },
            {
              "number": 8,
              "name": "The Shyster",
              "runner_ref": "ra:NDIzMjAzNDI2NDA",
              "horse_ref": "pe:theshyster",
              "price": 2.35,
              "source_url": null
            }
          ]
        },
        {
          "key": "pointsbetau",
          "runners_quoted": 9,
          "overround_pct": 120.49,
          "observed_at": "2026-09-29T03:29:58.949035Z",
          "runners": [
            {
              "number": 1,
              "name": "Alpha Mensae",
              "runner_ref": "ra:NDIzMzYyNjA2MjQ",
              "horse_ref": "pe:alphamensae",
              "price": 17.0,
              "source_url": null
            },
            {
              "number": 8,
              "name": "The Shyster",
              "runner_ref": "ra:NDIzMjAzNDI2NDA",
              "horse_ref": "pe:theshyster",
              "price": 2.3,
              "source_url": null
            }
          ]
        }
      ],
      "best": [
        {
          "number": 1,
          "name": "Alpha Mensae",
          "runner_ref": "ra:NDIzMzYyNjA2MjQ",
          "price": 17.0,
          "bookmaker": "betright"
        },
        {
          "number": 8,
          "name": "The Shyster",
          "runner_ref": "ra:NDIzMjAzNDI2NDA",
          "price": 2.35,
          "bookmaker": "sportsbet"
        }
      ]
    },
    {
      "market": "place",
      "places": 3,
      "bookmakers": [
        {
          "key": "betright",
          "runners_quoted": 9,
          "overround_pct": 363.62,
          "observed_at": "2026-09-29T03:29:36.794038Z",
          "runners": [
            {
              "number": 1,
              "name": "Alpha Mensae",
              "runner_ref": "ra:NDIzMzYyNjA2MjQ",
              "horse_ref": "pe:alphamensae",
              "price": 3.8,
              "source_url": null
            },
            {
              "number": 8,
              "name": "The Shyster",
              "runner_ref": "ra:NDIzMjAzNDI2NDA",
              "horse_ref": "pe:theshyster",
              "price": 1.25,
              "source_url": null
            }
          ]
        },
        {
          "key": "pointsbetau",
          "runners_quoted": 9,
          "overround_pct": 376.36,
          "observed_at": "2026-09-29T03:29:58.949035Z",
          "runners": [
            {
              "number": 1,
              "name": "Alpha Mensae",
              "runner_ref": "ra:NDIzMzYyNjA2MjQ",
              "horse_ref": "pe:alphamensae",
              "price": 3.6,
              "source_url": null
            },
            {
              "number": 8,
              "name": "The Shyster",
              "runner_ref": "ra:NDIzMjAzNDI2NDA",
              "horse_ref": "pe:theshyster",
              "price": 1.17,
              "source_url": null
            }
          ]
        }
      ],
      "best": [
        {
          "number": 1,
          "name": "Alpha Mensae",
          "runner_ref": "ra:NDIzMzYyNjA2MjQ",
          "price": 3.8,
          "bookmaker": "betright"
        },
        {
          "number": 8,
          "name": "The Shyster",
          "runner_ref": "ra:NDIzMjAzNDI2NDA",
          "price": 1.26,
          "bookmaker": "tab"
        }
      ]
    },
    {
      "market": "top2",
      "places": 2,
      "bookmakers": [
        {
          "key": "pointsbetau",
          "runners_quoted": 9,
          "overround_pct": 251.86,
          "observed_at": "2026-09-29T03:29:58.949035Z",
          "runners": [
            {
              "number": 1,
              "name": "Alpha Mensae",
              "runner_ref": "ra:NDIzMzYyNjA2MjQ",
              "horse_ref": "pe:alphamensae",
              "price": 6.33,
              "source_url": null
            },
            {
              "number": 8,
              "name": "The Shyster",
              "runner_ref": "ra:NDIzMjAzNDI2NDA",
              "horse_ref": "pe:theshyster",
              "price": 1.43,
              "source_url": null
            }
          ]
        }
      ],
      "best": [
        {
          "number": 1,
          "name": "Alpha Mensae",
          "runner_ref": "ra:NDIzMzYyNjA2MjQ",
          "price": 6.33,
          "bookmaker": "pointsbetau"
        },
        {
          "number": 8,
          "name": "The Shyster",
          "runner_ref": "ra:NDIzMjAzNDI2NDA",
          "price": 1.5,
          "bookmaker": "ladbrokes_au"
        }
      ]
    }
  ],
  "exotics": {
    "source": "results",
    "status": "final",
    "dividends": [
      {
        "code": "QN",
        "type": "Quinella",
        "product": "VIC",
        "selection": "8,13",
        "amount": 25.5
      },
      {
        "code": "TF",
        "type": "Trifecta",
        "product": "VIC",
        "selection": "8,13,7",
        "amount": 178.1
      }
    ]
  },
  "note": null,
  "quote_detail": [
    {
      "bookmaker": "betright",
      "number": 2,
      "name": "Around The Marx",
      "runner_ref": "ra:NDIzMDk5ODU2OTY",
      "seen_at": "2026-09-29T03:29:58.463340Z",
      "open_price": 19.0,
      "flucs": [
        23.0,
        26.0,
        21.0
      ],
      "tote_win": {
        "RD+": 21.909
      },
      "tote_place": {
        "MIDDIV": 4.0
      }
    },
    {
      "bookmaker": "tabtouch",
      "number": 1,
      "name": "Alpha Mensae",
      "runner_ref": "ra:NDIzMzYyNjA2MjQ",
      "seen_at": "2026-09-29T03:29:59.993599Z",
      "tote_win": {
        "PROV": 16.2
      },
      "tote_place": {
        "PROV": 3.6
      }
    },
    {
      "bookmaker": "betgold",
      "number": 8,
      "name": "The Shyster",
      "runner_ref": "ra:NDIzMjAzNDI2NDA",
      "seen_at": "2026-09-29T03:30:00.918826Z",
      "flucs": [
        2.3,
        2.35,
        2.4,
        2.45,
        2.4,
        2.45,
        2.4,
        2.45,
        2.4,
        2.45,
        2.4,
        2.45,
        2.4
      ]
    },
    {
      "bookmaker": "betdeluxe",
      "number": null,
      "name": "Alpha Mensae",
      "runner_ref": "ra:NDIzMzYyNjA2MjQ",
      "seen_at": "2026-09-29T03:30:00.351934Z",
      "flucs": [
        8.5,
        15.0,
        16.0,
        18.0
      ]
    }
  ],
  "scratchings": [
    {
      "name": "Inside Word",
      "number": 5,
      "barrier": 11,
      "scratched_at": "2026-09-28T21:30:08Z"
    },
    {
      "name": "Japanese Moka",
      "number": 6,
      "barrier": 13,
      "scratched_at": "2026-09-27T22:56:17Z"
    },
    {
      "name": "Tyrant Rex",
      "number": 9,
      "barrier": 9,
      "scratched_at": "2026-09-28T10:18:19Z"
    },
    {
      "name": "Chapel Belle",
      "number": 10,
      "barrier": 12,
      "scratched_at": "2026-09-28T04:09:14Z"
    }
  ]
}

Related endpoints

• GET /v1/racing/acceptances — Full-day AU thoroughbred acceptance card: every meeting, race and runner
• GET /v1/racing/best-odds — Best racing price per runner across books
• GET /v1/racing/changes — Races and prices that changed since a timestamp
• POST /v1/racing/clv — Score bets against the closing line (CLV)
• GET /v1/racing/consensus — The market consensus on one race: margin-free probability per runner
• GET /v1/racing/events — Upcoming race list
• GET /v1/racing/form — Every runner in one race with its recent runs, from our own results
• GET /v1/racing/greyhounds/field — Every dog in one greyhound race with its recent runs, from our own results