Getting Started with the PuntersEdge API

1. Get a free API key

Sign up at the API Platform page to request your free API key. We email a verification link — click it and your key is active immediately and emailed to you. The free tier provides 1,500 credits per month, capped at 30 requests per minute — enough for exploration and lightweight integrations.

2. Your first odds request

Pass your API key in the X-API-Key header. All responses are JSON.

# NRL odds — all bookmakers
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.puntersedge.online/v1/sports/nrl/odds?markets=h2h"

# AFL — best price only
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.puntersedge.online/v1/best-odds/afl"

# Next-to-go racing
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.puntersedge.online/v1/racing/next-to-go?num_races=10&categories=horse"

3. Supported workflows

• Live odds polling — Racing polling is per book and it is not uniform. Measured over the trailing 7 days to 2026-09-20 through the 10:00–21:00 AEST card, the median age of a connector's last successful read is 9–16s for fourteen of the fourteen served books. There is no single racing poll interval to quote: the slowest served book is 2x the fastest, so any blanket figure is wrong for a named book. Every quote carries its own age_seconds — that is the number to gate on.
• Sports polling — sports markets move far more slowly than racing, and every market carries a quality object with its own age_seconds. Gate a refetch on that age rather than on a fixed interval, or you spend credits on an unchanged payload.
• Best-price detection — use /best-odds/{sport} to get the top price per outcome across all covered bookmakers, plus an arb flag.
• Racing next-to-go — horses, greyhounds and harness across the 14 Australian fixed-odds books. Betfair Exchange and Pinnacle are ingested for internal reference and withheld from customer responses, so a customer key never receives those keys.
• Historical data — see Historical Odds API for past prices and results. The two sports history endpoints are on Standard and above; Free and Hobby get a 403.

4. Coverage summary

Measured 2026-09-20 over a trailing 7-day window, 14 Australian bookmakers quoted racing prices a customer key can read. 15 connectors quoted at all: the difference is Betfair Exchange and Pinnacle, ingested for internal reference and withheld from customer responses. Quote the served figure unless you mean the other one.

Full matrix at Australian Bookmakers Coverage.

• Racing — 14 books: BetDeluxe, Betr, BetRight, PointsBet, TABtouch, TAB, NextBet (formerly PlayUp), Unibet, Palmerbet, Neds, Ladbrokes, Sportsbet, BetGold and BoostBet. Horses, greyhounds, harness.
• Sports — 6 books across 20 queryable sport keys. Measured 2026-09-20 over the trailing 7 days, Rugby Union, NBA, NRL, AFL, Tennis ATP, Tennis WTA, WNBA, AFLW, Super League and NRLW carry more than one customer-served bookmaker on the majority of fixtures; on NFL, College Football, MLB, Soccer (Other Competitions), Basketball (Other Competitions), EPL, NHL, Cricket (Other Competitions) and MMA/UFC you are usually looking at a single price. The rule is one line — a sport is multi_book when at least 50% of its quoted fixtures in the window carried two or more customer-served bookmakers, single_book when it is below that, seasonal when no served book quoted any fixture, and not_queryable when the API 404s the key — so a sport is in exactly one of those lists. Check the live coverage map before you build on a single sport.

5. Pricing plans

• Free: 1,500 credits/month — no card required
• Hobby: 7,500 credits/month — $9 AUD/month
• Standard: 75,000 credits/month — $29 AUD/month
• Plus: 140,000 credits/month — $49 AUD/month
• Business: 300,000 credits/month — $99 AUD/month
• Platform: 1.5M credits/month — $199 AUD/month
• Unlimited: 5M credits/month — $249 AUD/month

Calls cost 0–100 credits depending on the endpoint — /v1/usage and /v1/health are free, /v1/sports/{key}/odds costs 1 per market type, the history and price-history endpoints cost 5 credits, and the ceiling is a bulk CSV export of /v1/racing/closing-lines. See the full credit table. Upgrade at any time on the platform page.