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.
X-API-Key
3 credits per connected minute, charged on connect, every 10 minutes and at close; nothing per event
curl 'https://api.puntersedge.online/v1/stream' \
-H 'X-API-Key: YOUR_KEY'
| Name | In | Type | Required | 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. |
Status codes: 200, 401, 402, 403, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.
The free tier needs no credit card, and the sandbox endpoints need no key at all.
Get a free API key Quickstart