puntersedge_racing_next_to_go
Retrieve upcoming horse, greyhound, and harness races with runners, all bookmaker win/place odds, scratchings, and per-book freshness; filter by country, venue, racing code, or bookmaker.
Instructions
The priced card: the next races with every runner and EVERY bookmaker's win and place price, plus scratchings and per-book freshness. Every country by default — pass country=AU with include_unresolved=true for an Australian card. Costs 2 credits up to 20 races, 3 for 21–60, 4 for 61–200; num_races=200 pulls every currently quoted race in one call.
Returns: [{race_id, venue, venue_id, venue_canonical, venue_site, race_number, category, start_time, country, race_name, distance_m, track_condition, race_class, scratchings:[{name, number, barrier, scratched_at}], runners:[{name, number, barrier, jockey, trainer, bookmakers:[{key, win_price, place_price, age_seconds, stale, refresh_tier, source_url}]}], data_age_seconds, freshest_age_seconds, refresh_tier, stale, stale_bookmakers}] (top-level ARRAY). Freshness is reported WORST-FIRST: data_age_seconds is the age of the OLDEST quote in the race, so read each bookmaker's own age_seconds before comparing two books.
NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name.
Example: Next 5 AU thoroughbred races with every book's price {"num_races": 5, "categories": "horse", "country": "AU", "include_unresolved": true}
Auth: needs your own key in PUNTERSEDGE_API_KEY.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| venue | No | Comma-separated venue names, case-insensitive, e.g. Randwick or Randwick,Flemington. Matched exactly after case folding, so read `venue` off an unfiltered call rather than guessing the spelling. | |
| country | No | Comma-separated ISO country codes, e.g. AU or AU,NZ. Omit for every country. Pair with include_unresolved=true or you silently lose most of an AU card. | |
| num_races | No | Races to return, up to 200. Pass 200 to bulk-pull every currently quoted race instead of paging. | |
| bookmakers | No | Comma-separated bookmaker keys to restrict to, case-insensitive. An unrecognised key returns a free 422 naming the valid keys. | |
| categories | No | Comma-separated racing codes: horse, greyhound, harness. Omit for all. NZ runs thoroughbred and harness only — there are no NZ greyhounds in the feed. | |
| include_unresolved | No | Include races whose country is not resolved yet (country is null). Most of an Australian card is unresolved until the meeting is confirmed — 58.8% of horse races in a measured window — so country=AU alone returns far fewer races than actually run. |