18+ Only  |  Gambling can be addictive — please gamble responsibly  |  Gambling Help: 1800 858 858  |  GambleAware

API reference / Stream

GET /v1/stream

Live event stream (server-sent events)

Real-time push of racing price changes, market moves, first prices, results and arbitrage opportunities over one long-lived HTTP connection, as [server-sent events](https://html.spec.whatwg.org/multipage/server-sent-events.html): the HTTP alternative to a WebSocket. Any SSE client that can send the `X-API-Key` header works (a browser `EventSource` cannot, so connect from your server); with curl, use `curl -N`. Guide with Python and JavaScript clients: https://puntersedge.online/developers/stream **Events** (`events=`, comma list; omit it for all five): - `race.prices`: the runners on a race whose win or lay price changed, latest price per bookmaker and runner, sent every few seconds for each race with changes. - `race.move`: a runner's consensus price has moved 10%, 20%, 30% or 50% (3 or more bookmakers). Once per runner, direction and band. - `race.odds_open`: a race's first prices. Same body as the webhook. - `race.result`: a result when it first appears and again when it is final. Same body as the webhook. - `arb.opportunity`: same body as the webhook. **Filters**: `category` (horse, greyhound, harness), `country` (e.g. AU,NZ) and `venue`, each a comma list. A filter that is set drops events that do not carry that field. **Resume**: every message has an `id:`. Reconnect with the `Last-Event-ID` header (most SSE clients send it for you) or `last_event_id=` and everything after it is replayed from a buffer of recent events (at least the last hour on a busy racing day). An id older than the buffer, a client that falls 500 events behind, or a server restart gets `event: reset` with a `reason`: re-fetch the board (`/v1/racing/next-to-go`, or `/v1/racing/changes`) and reconnect without an id. A `: ping` comment arrives every 15 seconds, so a quiet stream reads differently from a dead one. **Plans and credits**: Business, Platform and Scale (legacy Pro and Growth keys too). Each response carries `X-Credits-Cost: 3`. A key that runs out of credits gets `event: error` and the stream ends. Open connections per key: 5 on Business, 10 on Platform and Scale.

Requires X-API-Key 3 credits per connected minute, charged on connect, every 10 minutes and at close; nothing per event

Request

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

Parameters

NameIn TypeRequired Description
events query string no Comma list of event names; omit for all five.
category query string no horse, greyhound, harness (comma list).
country query string no ISO country codes, comma list (e.g. AU,NZ).
venue query string no Venue names, comma list, exact match ignoring case.
last_event_id query string no Resume point when the client cannot send the Last-Event-ID header.

Responses

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

Try it against live data

The free tier needs no credit card, and the sandbox endpoints need no key at all.

Get a free API key Quickstart
This site contains wagering-related analysis and is intended for Australian users aged 18+. Gambling involves risk. Please gamble responsibly.