No key means the free tier. The reply opens with "tier": "free", "delayed": false, "delay_seconds": 0 and "market_scope": "main", so the tier and the market scope travel with the data instead of sitting in a footnote.
Keys look like lfx_…. Keep it out of client code and out of anything public.
Authentication and tiers
Anonymous on the free tier, one header on the paid tier. No OAuth, no tokens to refresh.
The header
Send X-API-Key: <key> on any request. Leave it off and the request is served on the free tier. A key that is not recognised returns 401, and that attempt still counts against the free daily quota.
Getting and keeping a key
Keys are issued once, on the Stripe success page after you subscribe. Store it then. The same page carries a Manage your subscription link into the Stripe portal, where you manage or cancel; a cancelled key stops working within about a minute.
To rotate a key, send the current one to POST https://lucasfox.dev/odds-api/billing/rotate, either in the X-API-Key header or as a current_key form field. The reply is a page showing the new key once, with the portal link. The old key stops working straight away.
Lost a key and cannot rotate it? A key is never shown twice, so email support@lucasfox.dev.
Free and paid, side by side
Limit
Free
Paid
Price
$0
A$99 a month
Signup
None
Stripe checkout, then a key on the success page
Key
Not needed
lfx_… in X-API-Key
Prices
Live, main markets only
Live, every market
Markets
h2h, spreads, totals
Every market, player props included
Requests
100 a day per IP
50,000 a day per key
latest
limit up to 100, since_hours up to 24
limit up to 1000, since_hours up to 72
history
limit up to 500
limit up to 10,000
Free responses are cached for up to 60 seconds. The free tier serves live prices on the main markets only: requesting any other market, player props included, without a key returns 403. A free-tier value above a cap is clamped to the cap, not rejected: limit=1000 on /v1/latest returns 100 quotes, and since_hours=72 returns 24 hours.
Coverage
Eleven Australian bookmakers polled directly, plus Pinnacle as a sharp reference, across seven leagues.
Bookmakers and their keys
bookmaker_key
Bookmaker
Note
sportsbet
Sportsbet
tab
TAB
ladbrokes_au
Ladbrokes
Entain group
neds
Neds
Entain group
pointsbetau
PointsBet
unibet
Unibet
betr_au
Betr
betright
BetRight
tabtouch
TABtouch
dabble_au
Dabble
picklebet
Picklebet
pinnacle
Pinnacle
Sharp reference, outside the Australian consensus
Sports and their keys
sport_key
League
basketball_nba
NBA
basketball_nbl
NBL
americanfootball_nfl
NFL
aussierules_afl
AFL
soccer_epl
English Premier League
soccer_australia_aleague
A-League
mma_mixed_martial_arts
UFC and MMA
Independent groups
Ladbrokes and Neds share Entain pricing, so they count once in the consensus. The group is reported as entain_dedup_group.
Sharp reference
Pinnacle is flagged is_sharp_reference: true, left out of the Australian consensus, and reported separately as sharp_devigged_p.
Markets
h2h, spreads and totals on every tier, plus player props on the paid tier: player_points, player_rebounds, player_assists, player_threes, player_points_rebounds_assists and other combinations, player_steals, player_blocks; NFL player_pass_yds, player_rush_yds, player_reception_yds, player_receptions, player_anytime_td; soccer player_shots, player_shots_on_target, player_goals, total_corners, total_cards; MMA total_rounds.
Market scope
Every response carries market_scope: main on the free tier, all on the paid tier. A market outside the free scope, player props for example, returns 403 without a key.
Volume
Roughly 100,000 quotes per capture cycle, across about 70 events.
Capture cycle
Scan timing varies. Every quote carries captured_at, timestamp_ms and freshness_seconds, so the age of a price is a number you read and act on, not a promise.
Endpoints
Three GET routes. Parameters are optional unless the table says required, and a value outside the range below returns 422.
GET /v1/latest
The newest quote for each event, market, player, line, selection and bookmaker, newest first.
Trimmed to one of two quotes; deep_link is left out.
GET /v1/history
Every captured point for one event, oldest first, for line movement. Narrow it by book, market, selection, player and line. An unknown event_id returns 404.
Trimmed: one point of 496, and the nested event and book objects.
GET /v1/consensus
One devigged price per selection: every bookmaker normalised, then averaged across independent groups. Australian books only. No snapshots in the window returns 404.
Trimmed: one of two selections, one of 12 books, and the nested event object. Twelve books make 11 independent groups because Ladbrokes and Neds share Entain pricing; the mean itself is taken over the ten Australian groups.
Response fields
Every field the API returns, in the shape it returns it. Times are ISO 8601 in UTC, and every object is stable across tiers.
Envelope
All three routes open with the same five fields, then add their own payload. latest adds count, freshness_seconds and quotes. history adds event, count and points. consensus adds event, market_key, book_count, independent_group_count, freshness_seconds, selections and books.
Envelope, every response
Field
Type
Meaning
generated_at
string
When the response was built.
tier
string
free or paid, matching X-Odds-Tier.
delayed
boolean
Always false: every tier is served live.
delay_seconds
number
Always 0.
market_scope
string
main on the free tier, which covers h2h, spreads and totals; all on the paid tier.
Quote
One row of quotes in /v1/latest, and one row of points in /v1/history.
Each quote
Field
Type
Meaning
event_id
string
The event. Send it back to /v1/history and /v1/consensus.
bookmaker_key
string
The bookmaker, as keyed in Coverage.
bookmaker_name
string
The display name, for example Sportsbet.
bookmaker_region
string
The region the price was captured from: au.
market_key
string
The market, for example h2h or total_corners.
player_name
string or null
Set on player prop markets; null on team markets.
selection
string
The side of the market this price is for.
line
number or null
The handicap or total; null where the market has no line.
decimal_odds
number
The price this bookmaker is offering.
opposite_side_decimal_odds
number
The price on the other side of the same market.
deep_link
string
The bookmaker's own link to this market, captured with the quote.
captured_at
string
When the bookmaker's price was captured.
timestamp_ms
number
The same moment in Unix milliseconds.
freshness_seconds
number
The age of this quote, in seconds, when the response was built.
devigged_p
number
This bookmaker's two-way no-vig probability for the selection, after normalising 1/odds.
Odds change per hour against the previous snapshot.
ev_vs_consensus
number or null
EV of this price against the consensus, where a candidate exists; otherwise null.
History point
A history point carries the same fields as a quote, plus line_movement: the odds change against the previous point in that series. Points come back oldest first, so walking the array walks forward in time.
Consensus
Each entry in selections is one side of the market, priced across every group.
Each consensus selection
Field
Type
Meaning
selection
string
The side of the market.
line
number or null
The handicap or total, where the market has one.
player_name
string or null
Set on player prop markets.
devigged_p
number
The mean no-vig probability across independent Australian groups.
independent_group_count
number
How many independent groups went into that mean.
sharp_devigged_p
number
Pinnacle's no-vig probability for the same selection.
best_au_bookmaker
string
The Australian bookmaker offering the best price.
best_au_odds
number
That price.
ev_vs_consensus
number
EV of the best Australian price against the consensus.
ev_percentage
number
The same figure as a percentage.
Each entry in books carries bookmaker_key, bookmaker_name, region, is_sharp_reference, entain_dedup_group, group, overround, captured_at, timestamp_ms and its own selections with decimal_odds and devigged_p.
Headers and errors
The rate limit and the market scope are on the response, not buried in the body. Errors are plain status codes with a message.
200 OKfree tier headers
content-type: application/json
x-odds-tier: free
x-odds-delay: 0
x-odds-delay-note: free tier: live main markets (h2h, spreads, totals), 100 requests/day; send X-API-Key for player props
x-ratelimit-limit: 100
x-ratelimit-remaining: 82
x-ratelimit-window: 1d
X-Odds-Tier
free or paid, matching the body.
X-Odds-Delay
The delay applied to this response, in seconds. 0 on every tier: responses are live.
X-Odds-Delay-Note
Free tier only: a plain note about the market scope and the daily limit.
X-RateLimit-Limit
Requests allowed in the window.
X-RateLimit-Remaining
Requests left before the quota resets.
X-RateLimit-Window
1d. Quotas reset at 00:00 UTC.
Error responses
Status
When
What to do
401
The key is not recognised.
The request still costs one free call. Check the value; if the key is lost, email support@lucasfox.dev.
403
The request asks for a market outside the free scope, player props for example, and carries no key.
Send X-API-Key, or ask for h2h, spreads or totals.
404
Unknown event_id, or no snapshots inside the consensus window.
Take the id straight from a /v1/latest quote.
422
A parameter is out of range or the wrong type.
Check the parameter tables above.
503
The odds database is unavailable or two data queries are already running.
Retry after the Retry-After interval when supplied. Keep requests sequential and back off on repeated failures.
429
The daily quota is used up.
Wait Retry-After seconds, which is the time to 00:00 UTC.
Pricing
Build the whole thing on the free tier. Move to the paid tier when you need player props.
Free, live
$0
No key, no signup
100 requests a day per IP
Live h2h, spreads and totals from all eleven books
latest to 100 quotes and 24 hours, history to 500 points
No key. Live main markets from all eleven books.
Paid
A$99 a month
Every market, player props included
50,000 requests a day per key
latest to 1000 quotes and 72 hours, history to 10,000 points
Your key appears once, on the page after checkout. Save it.
The key appears once, on the page that follows checkout, and that page links to the Stripe portal for managing or cancelling. To rotate a key, POST your current key to /odds-api/billing/rotate in the X-API-Key header or a current_key form field; the new key is shown once and the old one stops working. Lost it? Email support@lucasfox.dev. The machine-readable schema is at lucasfox.dev/odds-api/openapi.json. Read the terms of use and the privacy policy. Research and analytics only. 18+.