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

Every endpoint, in plain English

What each endpoint does

87 calls, grouped by the job you are trying to do. Each one says what it returns, when to reach for it, what a call costs and which plan has it. The costs and the plan gates are read from the API itself when this page is served, not typed here.

2–4 crcredits per call, as the API bills itFreebills nothing

Watch the live market

8 calls

The board as the bookmakers price it: races about to jump, every runner, every book, and only the changes when you want to poll lightly.

GET/v1/racing/next-to-go

Lists the next races to jump with every runner and every bookmaker's price.

One race object per race: start time, venue, race number, the runners, and under each runner the win and place price from every book that quotes it, each price carrying its own age. Thoroughbred runners also carry jockey, trainer, barrier, weight and form where Racing Australia publishes them, and scratched runners are returned separately with their deductions.

Use it when You are building a live board or polling the market. Pass country=AU for an Australian card; every country is served by default and a race outside Australia and New Zealand usually carries one bookmaker.

2–4 cr 2 credits for up to 20 races, 3 for 21–60, 4 for 61–200 — the default request of 10 races costs 2, and keys issued before 22 September 2026 pay 2 at any size Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/next-to-go' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/changes

Returns only the races and prices that changed since a timestamp.

A delta: the races whose prices moved since the moment you name, plus a server timestamp to send back on your next call. Everything that did not move is left out.

Use it when You want to watch the market without downloading the whole card on a timer. It is the cheapest way to stay current.

2 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/changes?since=2026-09-01T05' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/events

Lists the upcoming races in a forward window, without prices.

The card only: venue, race number, start time, category and country for every race scheduled inside the window you ask for. How far ahead you can look grows with your plan.

Use it when You need to know what is running and when, to schedule your own calls or fill a fixture list, and prices would be wasted credits.

1 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/events' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/best-odds

Gives the best win, place and tote price for every runner across the books.

Per runner: the best price available, which bookmaker is offering it, how many books quote the runner, and the market percentage, so you can see how tight or generous the market is.

Use it when You want a best-price comparison rather than every book's price, or you are building a shop-the-odds view.

3 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/best-odds' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/movers

Finds the runners whose price has moved most since the market opened.

Firmers and drifters across the upcoming races, with each book's opening line and the move. A minimum number of confirming books filters out a single bookmaker repricing.

Use it when You want steamers and drifters as a signal, or a market-mover alert.

3 cr Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/movers' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/track-conditions

Reports the track condition, weather and rail position for each meeting.

The current official state per meeting, the day's log of every change with the time it was announced, and the races each change applies to.

Use it when Your model or your punters care about the going, or you want to know the instant a track is downgraded.

1 cr Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/track-conditions' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/acceptances

Publishes the full-day Australian thoroughbred acceptance card.

Meeting by meeting, race by race, every acceptance as Racing Australia publishes it: saddlecloth, barrier, jockey, trainer, weight, form figures, emergencies and scratchings, with a check per race that says whether the runner set adds up.

Use it when You want the official card two days out, or you need to reconcile your own field against Racing Australia's.

2 cr Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/acceptances' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/venues

Lists every venue the API serves, with its canonical identity.

One entry per venue: the stable venue id, the display name, the physical site, the country and the racing codes that run there, plus the spellings the bookmakers use.

Use it when You are joining races across endpoints or bookmakers and need one name for a track that every feed spells differently.

1 cr Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/venues' \
  -H 'X-API-Key: YOUR_KEY'

Settle and score

3 calls

What happened once the race ran: the official result, the dividends, and the record of how every price moved on the way to the jump.

GET/v1/racing/results

Returns settled results: finishing order, official starting price and the dividends.

Per race: the placings with the official starting price and each runner's settled fixed price, the full finishing order with margins, jockey and trainer, the win, place and exotic dividends, the scratchings with their deductions, and on every thoroughbred runner a horse reference that joins the same horse across meetings.

Use it when You settle bets, publish results, or build a results archive. Settle only on a final status.

2 cr Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/results' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/results/coverage

Measures how complete the results store is, day by day.

The store's own count of full-field results per day, category and venue, so a missing result reads as either not yet collected or not covered rather than as a bug.

Use it when You want to know what you can rely on before you report a gap.

1 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/results/coverage' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/price-history

Replays every price move for one race, per runner and per bookmaker.

The recorded ticks for a race from the moment it was priced to the jump, with the opening and closing line per runner per book.

Use it when You are studying how a market moved on one race, or checking what price was available at a given time. For the whole history across races, use the archive.

5 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/price-history?race_id=YOUR_RACE_ID' \
  -H 'X-API-Key: YOUR_KEY'

Form, horses and dogs

11 calls

The record behind a runner: thoroughbred form and career pages, our own settled runs, greyhound form, and the premiership tables.

GET/v1/racing/horses/form

Returns a thoroughbred's recent form, career record and profile.

Parsed from Racing Australia's form page: recent starts with position, margin, track and distance, the career summary, and the horse's profile. Look up by name, by the horse reference, or by a meeting's entry code.

Use it when You want the form behind a runner. When Racing Australia is walling fresh reads, stored copies still serve and the response points you at the runs endpoint.

3 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/horses/form?horse=YOUR_HORSE' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/horses/runs

Lists every run we hold for one thoroughbred from our own settled results.

Newest first: date, venue, race, distance, track condition, barrier, position, margin, starting price, trainer and jockey for each run, with a starts, wins and places summary. Always available, because it is built from results we collected ourselves.

Use it when You want a horse's recent record without depending on a third-party page.

3 cr Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/horses/runs?horse=YOUR_HORSE' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/form

Gives every runner in one race its recent runs from our own settled results, in one call.

Name a race and get the whole field: each runner's saddlecloth, barrier, jockey, trainer and weight from the card, then its last runs (date, venue, distance, class, track condition, barrier, weight, position, margin, starting price, jockey, trainer) and a starts, wins and places summary. Only runs before that race's start are included, so the answer for a race already run is what was knowable at the jump.

Use it when You are scoring a whole card and want the field's form without a call per horse or a dependency on a third-party page.

3 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/form' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/racing/horses/backfill

Queues a batch of horses for paced form collection.

Hand over a list of horses and the API collects their form pages at a polite pace, billing per horse only when a horse is delivered. You get a job id to poll.

Use it when You have a stable of horses to load at once and do not want to fetch them one call at a time.

3 cr / horse Free to submit; 3 credits per horse when it is delivered Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/racing/horses/backfill' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"horses": ["HORSES"], "label": "LABEL"}'
GET/v1/racing/horses/backfill/{job_id}

Shows a backfill job's progress.

How many horses are queued, delivered and blocked, whether the upstream is currently walled, and what has been billed so far.

Use it when You are waiting on a backfill and want to know when to collect.

Free Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/horses/backfill/YOUR_JOB_ID' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/horses/backfill/{job_id}/results

Collects the form of the horses a job has delivered.

The form records the job has gathered so far, re-readable without paying again.

Use it when Your job shows delivered horses and you want them.

Free Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/horses/backfill/YOUR_JOB_ID/results' \
  -H 'X-API-Key: YOUR_KEY'
DELETE/v1/racing/horses/backfill/{job_id}

Cancels the horses a job has not collected yet.

Drops the queued rows. Anything already delivered stays collectable and nothing already billed is refunded.

Use it when You queued more than you needed.

Free Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl -X DELETE 'https://api.puntersedge.online/v1/racing/horses/backfill/YOUR_JOB_ID' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/greyhounds/form

Lists every run we hold for one greyhound from our own results.

Newest first, by name or registry reference: track, distance, box, position, margin, time, splits and weight where the results page printed them.

Use it when You want a dog's recent form from a source you can check against the results endpoint.

3 cr Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/greyhounds/form?dog=YOUR_DOG' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/greyhounds/stats

Splits one greyhound's record by track, distance or box.

Starts, wins and places for each combination you ask for, with average first-split times where recorded.

Use it when You want to know whether a dog handles a track, a trip or a box.

3 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/greyhounds/stats?dog=YOUR_DOG' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/jockeys/stats

Gives jockey premiership tables, or one jockey's record.

Leaderboards by state and season with wins, placings, prize money, strike rate and starts, or the same line for a single jockey by name.

Use it when You want a jockey's season at a glance.

2 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/jockeys/stats' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/trainers/stats

Gives trainer premiership tables, or one trainer's record.

The same shape as the jockey tables, for trainers.

Use it when You want a trainer's season at a glance.

2 cr Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/trainers/stats' \
  -H 'X-API-Key: YOUR_KEY'

The permanent archive

5 calls

For building and testing a model: every closing line and every observed price point, kept forever, and a scorer that measures your bets against the close.

GET/v1/racing/markets

Shows every market on one race, book by book.

For a single race: the win price, the place price and the Same Race Multi Top 2, Top 3 and Top 4 prices from each bookmaker, each book's market percentage, the best price per runner, and once the race has been run, the settled exotic dividends.

Use it when You are pricing multis or exotics, comparing overrounds between books, or settling exotic bets.

2 cr Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Standard keys issued before 20 September 2026 keep it. Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/markets' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/closing-lines

Serves the permanent closing-line and result archive.

One row per race, runner and bookmaker: the opening and closing price, whether the row is a true closing line, and the finishing position where known, over any date range, as JSON or a flat CSV. Never purged.

Use it when You are measuring closing line value, building a model, or backtesting. How far back you can read depends on your plan.

5 / 20 cr 5 credits (JSON) / 20 credits (CSV) Standard: rolling 90-day window. Plus, Business, Platform and Scale: full archive. 403 on Free and Hobby. Standard keys issued before 20 September 2026 keep the full archive. ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/racing/closing-lines?from=2026-08-10&to=2026-08-17&category=horse&format=csv' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/closing-lines/coverage

Reports what the archive actually holds.

Its floor date, row and race counts, and how much of it is a genuine closing line and how much is resulted, computed from the table when you ask.

Use it when You want to know the depth of the archive before you build on it.

1 cr Same plan gate as the archive — 403 on Free and Hobby. The figures describe the whole archive, not your clamped window. Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/closing-lines/coverage' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/racing/price-paths

Exports every observed price point in the movement archive, in bulk.

One row per observation, per runner and bookmaker, as JSON, CSV or Parquet, so you can rebuild the whole path of a market rather than just its ends.

Use it when You are modelling how markets move, not just where they close.

5 / 20 cr 5 credits (JSON) / 20 credits (CSV) Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Standard keys issued before 20 September 2026 keep it. Reference
Example request
curl 'https://api.puntersedge.online/v1/racing/price-paths?date=2026-08-15&category=horse&format=csv' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/racing/clv

Scores a list of your bets against the closing line.

Per bet: the price the race closed at, your closing line value in percent, whether you beat the close, the result and flat-stake profit. Across the list: average and median CLV, beat rate, win rate and return.

Use it when You want to know whether you are beating the market, which is the fact about a punter that a strike rate cannot tell you.

5 cr Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/racing/clv' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"bets": [{"bookmaker": "sportsbet", "price": 4.2, "race_id": "au-flemington-2026-09-19-r5", "ref": "bet-1", "runner_name": "Example Horse", "stake": 50}, {"meeting_date": "2026-09-19", "price": 6.0, "race_number": 7, "ref": "bet-2", "runner_number": 3, "venue": "Randwick"}], "reference": "best"}'

Sports odds

9 calls

Head-to-head, spreads and totals per bookmaker for the football codes, basketball, tennis and cricket, with the best price and the arbitrage checks built on top.

GET/v1/sports

Lists the sports you can query.

Every sport key with its display name and group. Racing is not a sport here; it has its own endpoints.

Use it when You need the key to pass to the odds endpoints.

1 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/sports' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/sports/{sport_key}/odds

Returns head-to-head, spread and total prices per bookmaker for a sport's fixtures.

Upcoming fixtures with each requested market from each book, and a quality object on every market saying how fresh the price is.

Use it when You are building a sports odds board or comparing books on a match.

1 cr / market 1 credit per requested market Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/sports/afl/odds' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/sports/{sport_key}/odds/history

Returns historical odds snapshots for a sport.

Prices as they stood at earlier times, so you can see where a market has been.

Use it when You are studying sports price movement over days rather than minutes.

5 cr Standard, Plus, Business, Platform and Scale only — 403 on Free and Hobby. Reference
Example request
curl 'https://api.puntersedge.online/v1/sports/afl/odds/history' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/sports/{sport_key}/odds/movements

Lists detected price movements in a sport's markets.

Home, draw and away moves found in the historical snapshots, with the size and direction of each.

Use it when You want sports steamers and drifters.

5 cr Standard, Plus, Business, Platform and Scale only — 403 on Free and Hobby. Reference
Example request
curl 'https://api.puntersedge.online/v1/sports/afl/odds/movements' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/sports/{sport_key}/closing-lines

Returns each bookmaker's closing price and line on every match in a date range, with the consensus across books.

One row per match: per bookmaker, the last head-to-head price, handicap line and total recorded before the start; then the median closing price across books, the most common closing line and the median price at it. AFL and AFLW closes are kept permanently; other sports cover the last 90 days.

Use it when You are grading a model against the closing market or measuring closing-line value on sports.

5 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/sports/afl/closing-lines' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/best-odds/{sport_key}

Gives the best price per selection across bookmakers for one sport.

The best available price for each outcome and which book has it, with an arbitrage flag and margin when the best prices sum to a guaranteed return.

Use it when You want one number per outcome, or you are scanning for arbs.

3 cr Every plan, including Free ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/best-odds/afl' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/arb/best-prices

Compares every bookmaker's price per selection against the best.

The best price, the worst, the full comparison and the spread between books, per selection.

Use it when You want the whole picture of a market's pricing, not just the winner.

2 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/arb/best-prices' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/arb/sports

Scans upcoming sports markets for arbitrage and overlay opportunities.

Markets where backing every outcome across books returns more than staked, and best-odds overlays against the market consensus, ranked.

Use it when You run an arb scanner or a value screen.

3 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/arb/sports' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/arb/lines

Finds line-matched arbitrage on spreads and totals.

Opposing sides of a spread or total at complementary lines across two books, with the return.

Use it when You arb handicaps and totals rather than head-to-head.

3 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/arb/lines' \
  -H 'X-API-Key: YOUR_KEY'

Your key and your account

29 calls

Everything about the key itself: what it has spent, what it may do, rotating it, more keys on one account, billing and referrals.

GET/v1/usage

Shows your plan, allowance, credits used and reset date.

Everything you need to decide about your plan before the API refuses you: spend by endpoint, projected monthly need, and the tier that would cover it.

Use it when You want to watch your balance, or you are about to build a budget check.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/usage' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/usage/analytics

Breaks your credit usage down by endpoint.

Calls and credits per endpoint over a rolling window or the current billing period.

Use it when You want to see which of your calls cost the most.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/usage/analytics' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/keys/info

Returns the metadata of the key you are calling with.

Plan, credits, organisation and last-used time.

Use it when You want to confirm which key a process is using.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/keys/info' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/keys/rotate

Issues a new key and retires the old one after a grace window.

The new key, returned once. The old key keeps working briefly so several processes can roll over without a gap.

Use it when A key may have leaked, or you rotate on a schedule.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/keys/rotate' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/keys/resend

Rotates your key and emails the new one to your verified address.

A confirmation. The key itself goes to the address on the account, never into the response.

Use it when You have lost the key and cannot read it back, because keys are stored hashed.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/keys/resend' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com"}'
POST/v1/keys/ip-whitelist

Restricts your key to a list of IP addresses or ranges.

The stored whitelist. Calls from anywhere else are refused. Send an empty list to remove it.

Use it when You want a stolen key to be useless off your servers.

Free Business, Platform and Scale only — 403 on Free, Hobby, Standard and Plus. Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/keys/ip-whitelist' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '["203.0.113.7/32", "198.51.100.0/24"]'
POST/v1/keys/team

Mints another key on the same account and credit pool.

A new key with its own rate limit, IP whitelist and usage line, drawing on the account's monthly credits. The key string is returned once.

Use it when You want one key per client, worker or environment without splitting the plan.

Free Business, Platform and Scale only (keys per account, primary included: Business 3, Platform 5, Scale 10) — 403 on Free, Hobby, Standard and Plus. Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/keys/team' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"label": "LABEL", "monthly_cap": 1}'
GET/v1/keys/team

Lists the primary key and every team key on the account.

Each key's calls and credits this period, and the pool balance.

Use it when You want to see who is spending what.

Free Business, Platform and Scale only (keys per account, primary included: Business 3, Platform 5, Scale 10) — 403 on Free, Hobby, Standard and Plus. Reference
Example request
curl 'https://api.puntersedge.online/v1/keys/team' \
  -H 'X-API-Key: YOUR_KEY'
PATCH/v1/keys/team/{key_id}

Changes a team key's monthly cap or label.

The updated key. A cap makes that key refuse at its own limit instead of spending the account's month.

Use it when You want a trial or a client capped.

Free Business, Platform and Scale only (keys per account, primary included: Business 3, Platform 5, Scale 10) — 403 on Free, Hobby, Standard and Plus. Reference
Example request
curl -X PATCH 'https://api.puntersedge.online/v1/keys/team/YOUR_KEY_ID' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"label": "LABEL", "monthly_cap": 1}'
DELETE/v1/keys/team/{key_id}

Revokes a team key immediately.

Confirmation. Its usage history stays in the account's breakdown.

Use it when A client leaves or a key is no longer needed.

Free Business, Platform and Scale only (keys per account, primary included: Business 3, Platform 5, Scale 10) — 403 on Free, Hobby, Standard and Plus. Reference
Example request
curl -X DELETE 'https://api.puntersedge.online/v1/keys/team/YOUR_KEY_ID' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/billing/portal

Gives you a short-lived link to your billing portal.

A Stripe portal URL where you can change the card, download invoices, or cancel.

Use it when You need to manage the subscription behind the key.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/billing/portal' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/billing/overage

Shows whether your account may run past its allowance, and on what terms.

The state, the rate per thousand credits, the ceiling the API enforces, and what this period would be invoiced if it ended now.

Use it when You are on a commercial tier and want to know what happens at the cap.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/billing/overage' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/billing/overage

Switches overage on or off.

The new state. With it on, calls continue past the allowance up to the ceiling; with it off, the cap is a hard stop.

Use it when You would rather pay for the overflow than be refused, or the reverse.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/billing/overage' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"enabled": true}'
GET/v1/referral

Shows your referral link and what it has earned.

Your code, the link to share, and the commission accrued.

Use it when You want to refer someone.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/referral' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/referral

Chooses how your referral reward is paid.

Cash or credits, and a payout address.

Use it when You have referrals accruing and want to pick how they land.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/referral' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"reward_type": "REWARD_TYPE", "payout_email": "you@example.com", "code": "CODE"}'
POST/v1/login/request

Emails you a one-time link to the key console.

Always the same acknowledgement, whether or not the address is known.

Use it when You use the web console rather than the API to manage your key.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/login/request' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com"}'
POST/v1/login/exchange

Redeems a login link for a console session.

A session for the key console.

Use it when The console calls this for you when you click the link.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/login/exchange' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"token": "TOKEN"}'
POST/v1/logout

Ends a console session.

Confirmation.

Use it when You are done in the console on a shared machine.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/logout' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/login

Signs you in with your email and password.

A 30-day console session, presented in X-API-Key exactly like a key.

Use it when You log in at puntersedge.online/login, or a tool of yours signs in for you.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/login' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com", "password": "PASSWORD"}'
POST/v1/password/forgot

Emails you a one-time password reset link.

Always the same acknowledgement, whether or not the address is known.

Use it when You have forgotten your password, or have never set one.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/password/forgot' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com"}'
POST/v1/password/reset

Sets a new password from a reset link and signs your other devices out.

A fresh console session.

Use it when The reset page calls this for you when you save the new password.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/password/reset' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"token": "TOKEN", "new_password": "NEW_PASSWORD"}'
POST/v1/account/password

Sets or changes your account password.

Confirmation, and how many other sessions were signed out.

Use it when You want to log in without an emailed link, or to change your password.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/account/password' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"new_password": "NEW_PASSWORD", "current_password": "CURRENT_PASSWORD"}'
GET/v1/account

Your account in one call: email, plan, whether a password is set, whether billing is attached.

The account summary.

Use it when Your account page, or a tool that needs to know what this key can do.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/account' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/logout/all

Signs you out of every device at once.

Confirmation.

Use it when You left a browser signed in somewhere you no longer control.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/logout/all' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/billing/portal

Billing portal link for a signed-in console, after confirming your password.

The same portal URL as the GET form.

Use it when The account page calls this for you; with a key in hand use the GET form.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/billing/portal' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"password": "PASSWORD"}'
POST/v1/billing/upgrade-link

Prorated upgrade link for a signed-in console, after confirming your password.

The same URL as the GET form.

Use it when The account page calls this for you; with a key in hand use the GET form.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/billing/upgrade-link' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"password": "PASSWORD"}'
POST/v1/account/marketing

Turns promotional emails on or off for your account.

Your consent state, and confirmation.

Use it when You ticked (or did not tick) the offers box at signup and want to change it.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/account/marketing' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"opt_in": true}'
POST/v1/keys/reveal

Issues a fresh key from a signed-in console session and returns it.

A new key string, shown once.

Use it when You are in the console and need the key in your clipboard.

Free Every plan, including Free Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/keys/reveal' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"password": "PASSWORD"}'

Files, widgets and webhooks

12 calls

The other ways the data leaves: pre-built dataset files, a white-label odds widget, and webhooks that call you when a market opens.

GET/v1/bulk/datasets

Lists the pre-built dataset files you can download.

Every dataset published as files, with the daily files and monthly bundles available, their rows, size and digest.

Use it when You would rather load a file into a database than page through an endpoint.

Free Daily files: Business, Platform and Scale. Monthly bundles: Platform and Scale. 403 on Free, Hobby, Standard and Plus. Reference
Example request
curl 'https://api.puntersedge.online/v1/bulk/datasets' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/bulk/{dataset}/{period}

Downloads one dataset file for a day or a month.

Closing lines, price paths, results, acceptances, track conditions, race markets or exotic dividends, as Parquet or gzip CSV, with an ETag so a file you already hold costs nothing to check.

Use it when You are backfilling a warehouse or a model.

20 / 100 cr 20 credits for a daily file, 100 for a monthly bundle, charged when the file is served; a 304 costs nothing Daily files: Business, Platform and Scale. Monthly bundles: Platform and Scale. 403 on Free, Hobby, Standard and Plus. Reference
Example request
curl 'https://api.puntersedge.online/v1/bulk/closing_lines/2026-09-19' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/widgets

Creates an embeddable odds widget in your own branding.

A widget id and the embed snippet. It renders from the same feed as the API, in your colours, with your bookmaker links, and no PuntersEdge credit on the frame.

Use it when You show odds on your own site and want them live without building a board.

Free Platform only — the redistribution licence — 403 on Free, Hobby, Standard, Plus, Business and Scale. Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/widgets' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"label": "LABEL", "config": {}}'
GET/v1/widgets

Lists your widgets and how often each has been filled.

Every widget on the account with its fill counters.

Use it when You want to see which embeds are being viewed.

Free Platform only — the redistribution licence — 403 on Free, Hobby, Standard, Plus, Business and Scale. Reference
Example request
curl 'https://api.puntersedge.online/v1/widgets' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/widgets/{widget_id}

Shows one widget's stored config and embed snippets.

The normalised config, the snippets and the counters.

Use it when You are re-embedding or debugging a widget.

Free Platform only — the redistribution licence — 403 on Free, Hobby, Standard, Plus, Business and Scale. Reference
Example request
curl 'https://api.puntersedge.online/v1/widgets/YOUR_WIDGET_ID' \
  -H 'X-API-Key: YOUR_KEY'
PATCH/v1/widgets/{widget_id}

Replaces a widget's config or label.

The updated widget. The config is a full replacement, validated the same way as on create.

Use it when You are changing colours, links or the races a widget shows.

Free Platform only — the redistribution licence — 403 on Free, Hobby, Standard, Plus, Business and Scale. Reference
Example request
curl -X PATCH 'https://api.puntersedge.online/v1/widgets/YOUR_WIDGET_ID' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"label": "LABEL", "config": {}}'
DELETE/v1/widgets/{widget_id}

Stops serving a widget.

Confirmation. An iframe still embedding it renders a neutral unavailable state.

Use it when You are removing an embed.

Free Platform only — the redistribution licence — 403 on Free, Hobby, Standard, Plus, Business and Scale. Reference
Example request
curl -X DELETE 'https://api.puntersedge.online/v1/widgets/YOUR_WIDGET_ID' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/webhooks

Registers a URL for the API to call when a racing market opens.

A webhook id and the signing secret for verifying deliveries.

Use it when You would rather be told a market is live than poll for it.

Free Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/webhooks' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com/hooks/puntersedge", "events": ["arb.opportunity"], "min_edge_pct": 1.5, "sports": ["nrl", "afl"]}'
GET/v1/webhooks

Lists your webhooks.

Every registered URL with its status.

Use it when You are auditing what will be called.

Free Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl 'https://api.puntersedge.online/v1/webhooks' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/webhooks/{webhook_id}/test

Sends a test delivery to a webhook.

The delivery attempt and the response your endpoint gave.

Use it when You are wiring up a receiver.

Free Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/webhooks/YOUR_WEBHOOK_ID/test' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/webhooks/{webhook_id}/deliveries

Lists recent deliveries to a webhook.

Each attempt with its timestamp, status and response.

Use it when You think you missed an event.

Free Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl 'https://api.puntersedge.online/v1/webhooks/YOUR_WEBHOOK_ID/deliveries' \
  -H 'X-API-Key: YOUR_KEY'
DELETE/v1/webhooks/{webhook_id}

Deletes a webhook.

Confirmation.

Use it when You no longer want the calls.

Free Plus, Business, Platform and Scale only — 403 on Free, Hobby and Standard. Reference
Example request
curl -X DELETE 'https://api.puntersedge.online/v1/webhooks/YOUR_WEBHOOK_ID' \
  -H 'X-API-Key: YOUR_KEY'

Health and data quality

7 calls

How to tell a quiet market from a stalled feed: connector freshness, uptime and the bookmaker audits.

GET/v1/health

Reports each bookmaker connector's health.

Last successful read, status and records written, per connector.

Use it when You need to tell a quiet market from a stalled scraper, which keeps serving its last value rather than erroring.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/health' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/health/connectors

Gives each connector's freshness with a stale flag.

How long since each feed last succeeded and whether that is past its threshold.

Use it when You want an alert when a feed goes quiet.

1 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/health/connectors' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/uptime

Publishes the API's uptime statistics.

Availability over the recent window, public and free.

Use it when You are checking us before you build, or showing your own users a status line.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/uptime' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/data-quality/summary

Summarises connector freshness, canonical mappings and recent audits.

One document on the state of the data pipeline.

Use it when You want a single health read rather than per-connector detail.

1 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/data-quality/summary' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/data-quality/audit/latest

Lists the latest bookmaker audits.

The most recent source-versus-API comparison per bookmaker.

Use it when You want evidence the prices match the bookmaker's own site.

1 cr Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/data-quality/audit/latest' \
  -H 'X-API-Key: YOUR_KEY'
GET/v1/data-quality/audit/{run_id}/results

Shows the detail of one audit run.

Every comparison the run made and its verdict.

Use it when You are looking into a specific audit.

Free Every plan, including Free Reference
Example request
curl 'https://api.puntersedge.online/v1/data-quality/audit/YOUR_RUN_ID/results' \
  -H 'X-API-Key: YOUR_KEY'
POST/v1/data-quality/audit/run

Runs a bookmaker audit now.

A fresh source-versus-API comparison. Admin and enterprise only.

Use it when You hold an enterprise key and want an audit on demand.

Free Admin and enterprise keys only Reference
Example request
curl -X POST 'https://api.puntersedge.online/v1/data-quality/audit/run' \
  -H 'X-API-Key: YOUR_KEY'

Try it without a key

3 calls

Live data, no key, no card: the sample endpoints the whole site verifies itself against.

GET/v1/demo/racing/next-to-go

Shows a live sample of the next races with the best bookmaker prices.

The next few races with a handful of runners each and the best few prices per runner, live, cached briefly, rate limited by address.

Use it when You want to see the shape of the racing data before you take a key.

Free No key needed ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/demo/racing/next-to-go'
GET/v1/demo/best-odds

Shows a live sample of best odds with arbitrage detection.

Best price per selection for a few upcoming events, with the arb flag.

Use it when You want to see the sports shape, or verify a claim about it on the spot.

Free No key needed ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/demo/best-odds'
GET/v1/demo/book-sport

Shows one bookmaker's live odds for one sport.

A truncated live snapshot for the bookmaker and sport you name.

Use it when You want to check a single book's prices without a key.

Free No key needed ReferenceTry it
Example request
curl 'https://api.puntersedge.online/v1/demo/book-sport?book=sportsbet&sport=afl'

Start with the sandbox, then take a key

The sandbox calls above need no key. A free key gets you every endpoint on this page at the free allowance; the reference has the full parameter tables and response shapes.

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