llms.txt Content
# PuntersEdge
> An Australian-first odds API: Australian and New Zealand racing, and Australian sports.
> One REST/JSON endpoint returns live prices from 14 Australian bookmakers on horse, greyhound and harness racing — including a next-to-go endpoint — and 6 bookmakers across 20 sport keys (AFL, NRL, NBA, NFL, MLB, EPL, tennis, cricket, MMA and more), of which 19 carried a quote from a served bookmaker in the trailing 7 days when this file was served. Racing
> is where the depth is; on most individual sports only one book quotes a given match.
> Self-serve, free tier with no credit card, paid plans from AUD $9/mo.
PuntersEdge is built and run in Australia. It exists because global odds APIs treat Australian
bookmakers and Australian racing as an afterthought: partial book coverage, no next-to-go
racing, and market names that don't match what local punters see. Developers use it to build
odds-comparison sites, value and arbitrage scanners, model feeds, dashboards and internal
analytics.
Racing covers two countries: Australia — thoroughbred, harness and greyhound — and New
Zealand — thoroughbred and harness. Both run through the same endpoints, split with
`country=AU` or `country=NZ`. There are no New Zealand greyhounds in the feed. Sports are
Australian. No other country has a bookmaker panel behind it: overseas meetings appear
because an Australian book lists them, at a median of one price per race.
Base URL: https://api.puntersedge.online/v1
Auth: an `X-API-Key` header. Get a free key at https://puntersedge.online/api
Official TypeScript/JavaScript client: `npm install puntersedge`. No dependencies, ESM
and CommonJS, and every response type generated from the OpenAPI schema below rather than
hand-written, so the types cannot drift from the API. One error class per status code
(402 credits exhausted, 429 rate limited, 422 malformed — three different responses), the
credit balance parsed from the response headers, and webhook signature verification
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"PuntersEdge Odds API","description":"Australian sports odds, and Australian and New Zealand racing odds, from 14 Australian bookmakers in one API. Sports and racing are SEPARATE endpoint families: sports odds live under /v1/sports/{sport_key}/odds, and racing under /v1/racing/next-to-go and /v1/racing/events — there is no 'horse-racing' sport_key. \n\n**Two client settings worth more than any server tuning.** Send `Accept-Encoding: gzip` — responses are JS