LucasFox.dev Try the free API

Odds API reference

Three read-only GET routes over JSON. Eleven Australian bookmakers, seven sports, and every quote timestamped with its own age.

Quickstart

One curl, no key, no signup. The free tier answers straight away, live, on the main markets, and tells you the age of every price in the reply.

Base URL
https://lucasfox.dev/odds-api
Format
JSON over HTTPS. Every route is a read-only GET.
Schema
openapi.json, for generated clients and typed models.

Ask without a key

GET /v1/latest?limit=5free tier

curl -s "https://lucasfox.dev/odds-api/v1/latest?limit=5"

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.

200 OKtop level only

{
  "generated_at": "2026-11-04T12:16:38.503562+00:00",
  "tier": "free",
  "delayed": false,
  "delay_seconds": 0,
  "market_scope": "main",
  "count": 2,
  "freshness_seconds": 954,
  "quotes": [ … ]
}
One full quote is shown under Endpoints.

Then add your key

A paid key goes in one header and opens every market, player props included. Nothing else about the request changes.

X-API-Keypaid tier

curl -s "https://lucasfox.dev/odds-api/v1/latest?sport_key=basketball_nba&limit=50" \
  -H "X-API-Key: lfx_your_key"

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
LimitFreePaid
Price$0A$99 a month
SignupNoneStripe checkout, then a key on the success page
KeyNot neededlfx_… in X-API-Key
PricesLive, main markets onlyLive, every market
Marketsh2h, spreads, totalsEvery market, player props included
Requests100 a day per IP50,000 a day per key
latestlimit up to 100, since_hours up to 24limit up to 1000, since_hours up to 72
historylimit up to 500limit 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_keyBookmakerNote
sportsbetSportsbet
tabTAB
ladbrokes_auLadbrokesEntain group
nedsNedsEntain group
pointsbetauPointsBet
unibetUnibet
betr_auBetr
betrightBetRight
tabtouchTABtouch
dabble_auDabble
picklebetPicklebet
pinnaclePinnacleSharp reference, outside the Australian consensus
Sports and their keys
sport_keyLeague
basketball_nbaNBA
basketball_nblNBL
americanfootball_nflNFL
aussierules_aflAFL
soccer_eplEnglish Premier League
soccer_australia_aleagueA-League
mma_mixed_martial_artsUFC 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.

Parameters
ParameterRequiredRangePurpose
sport_keyNoSee CoverageOne sport
bookmaker_keyNoSee CoverageOne bookmaker
market_keyNoSee CoverageOne market; player props need a key
since_hoursNo1 to 24 free, 1 to 72 paid, default 24Only quotes captured in the last n hours
limitNo1 to 1000, default 200Quotes returned; the free tier is clamped to 100

curlNBA, 50 quotes

curl -s "https://lucasfox.dev/odds-api/v1/latest?sport_key=basketball_nba&limit=50"

200 OKtrimmed response

{
  "generated_at": "2026-11-04T12:16:38.503562+00:00",
  "tier": "free",
  "delayed": false,
  "delay_seconds": 0,
  "market_scope": "main",
  "count": 2,
  "freshness_seconds": 954,
  "quotes": [
    {
      "event_id": "live_af9f9bdc644c8fe338a324da",
      "bookmaker_key": "sportsbet",
      "bookmaker_name": "Sportsbet",
      "bookmaker_region": "au",
      "market_key": "h2h",
      "player_name": null,
      "selection": "Memphis Grizzlies",
      "line": null,
      "decimal_odds": 1.35,
      "opposite_side_decimal_odds": 3.33,
      "captured_at": "2026-11-04T12:00:43.621949+00:00",
      "timestamp_ms": 1793793643621,
      "freshness_seconds": 954,
      "devigged_p": 0.711538,
      "book": {
        "key": "sportsbet",
        "name": "Sportsbet",
        "region": "au",
        "is_sharp_reference": false,
        "entain_dedup_group": null
      },
      "event": {
        "event_id": "live_af9f9bdc644c8fe338a324da",
        "sport_key": "basketball_nba",
        "league_title": "NBA",
        "commence_time": "2026-11-05T01:10:00+00:00",
        "home_team": "Memphis Grizzlies",
        "away_team": "Indiana Pacers",
        "venue": null,
        "status": "scheduled"
      },
      "line_velocity": 0.0,
      "ev_vs_consensus": null
    }
  ]
}
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.

Parameters
ParameterRequiredRangePurpose
event_idYesFrom a quoteThe event
market_keyNoSee CoverageOne market
selectionNoAny selectionOne side of the market
bookmaker_keyNoSee CoverageOne bookmaker
player_nameNoAny playerOne player, on prop markets
lineNoAny lineOne handicap or total
limitNoDefault 2000; the free tier is clamped to 500Points returned

curlone event, one market

curl -s "https://lucasfox.dev/odds-api/v1/history?event_id=EVENT_ID&market_key=h2h"

200 OKtrimmed response

{
  "generated_at": "2026-11-04T12:18:38.057420+00:00",
  "tier": "free",
  "delayed": false,
  "delay_seconds": 0,
  "market_scope": "main",
  "event": { … },
  "count": 496,
  "points": [
    {
      "event_id": "live_af9f9bdc644c8fe338a324da",
      "bookmaker_key": "sportsbet",
      "bookmaker_name": "Sportsbet",
      "bookmaker_region": "au",
      "market_key": "h2h",
      "player_name": null,
      "selection": "Indiana Pacers",
      "line": null,
      "decimal_odds": 3.33,
      "opposite_side_decimal_odds": 1.35,
      "captured_at": "2026-11-04T11:51:21.375679+00:00",
      "timestamp_ms": 1793793081375,
      "freshness_seconds": 1636,
      "devigged_p": 0.288462,
      "book": { … },
      "line_velocity": 0.785044,
      "line_movement": 0.13
    }
  ]
}
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.

Parameters
ParameterRequiredRangePurpose
event_idYesFrom a quoteThe event
market_keyNoDefault h2hOne market
player_nameNoAny playerOne player, on prop markets
lineNoAny lineOne handicap or total
since_hoursNo1 to 24 free, 1 to 72 paid, default 24Only snapshots inside the window

curlconsensus for one event

curl -s "https://lucasfox.dev/odds-api/v1/consensus?event_id=EVENT_ID&market_key=h2h"

200 OKtrimmed response

{
  "generated_at": "2026-11-04T12:16:40.298983+00:00",
  "tier": "free",
  "delayed": false,
  "delay_seconds": 0,
  "market_scope": "main",
  "event": { … },
  "market_key": "h2h",
  "book_count": 12,
  "independent_group_count": 11,
  "freshness_seconds": 956,
  "selections": [
    {
      "selection": "Indiana Pacers",
      "line": null,
      "player_name": null,
      "devigged_p": 0.304878,
      "independent_group_count": 10,
      "sharp_devigged_p": 0.302013,
      "best_au_bookmaker": "sportsbet",
      "best_au_odds": 3.33,
      "ev_vs_consensus": 0.015244,
      "ev_percentage": 1.5244
    }
  ],
  "books": [
    {
      "bookmaker_key": "pinnacle",
      "bookmaker_name": "Pinnacle",
      "region": "au",
      "is_sharp_reference": true,
      "entain_dedup_group": null,
      "group": "pinnacle",
      "overround": 1.034722,
      "captured_at": "2026-11-04T11:56:10.591037+00:00",
      "timestamp_ms": 1793793370591,
      "selections": [ … ]
    }
  ]
}
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
FieldTypeMeaning
generated_atstringWhen the response was built.
tierstringfree or paid, matching X-Odds-Tier.
delayedbooleanAlways false: every tier is served live.
delay_secondsnumberAlways 0.
market_scopestringmain 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
FieldTypeMeaning
event_idstringThe event. Send it back to /v1/history and /v1/consensus.
bookmaker_keystringThe bookmaker, as keyed in Coverage.
bookmaker_namestringThe display name, for example Sportsbet.
bookmaker_regionstringThe region the price was captured from: au.
market_keystringThe market, for example h2h or total_corners.
player_namestring or nullSet on player prop markets; null on team markets.
selectionstringThe side of the market this price is for.
linenumber or nullThe handicap or total; null where the market has no line.
decimal_oddsnumberThe price this bookmaker is offering.
opposite_side_decimal_oddsnumberThe price on the other side of the same market.
deep_linkstringThe bookmaker's own link to this market, captured with the quote.
captured_atstringWhen the bookmaker's price was captured.
timestamp_msnumberThe same moment in Unix milliseconds.
freshness_secondsnumberThe age of this quote, in seconds, when the response was built.
devigged_pnumberThis bookmaker's two-way no-vig probability for the selection, after normalising 1/odds.
bookobjectkey, name, region, is_sharp_reference, entain_dedup_group.
eventobjectevent_id, sport_key, league_title, commence_time, home_team, away_team, venue, status.
line_velocitynumberOdds change per hour against the previous snapshot.
ev_vs_consensusnumber or nullEV 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
FieldTypeMeaning
selectionstringThe side of the market.
linenumber or nullThe handicap or total, where the market has one.
player_namestring or nullSet on player prop markets.
devigged_pnumberThe mean no-vig probability across independent Australian groups.
independent_group_countnumberHow many independent groups went into that mean.
sharp_devigged_pnumberPinnacle's no-vig probability for the same selection.
best_au_bookmakerstringThe Australian bookmaker offering the best price.
best_au_oddsnumberThat price.
ev_vs_consensusnumberEV of the best Australian price against the consensus.
ev_percentagenumberThe 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
StatusWhenWhat to do
401The key is not recognised.The request still costs one free call. Check the value; if the key is lost, email support@lucasfox.dev.
403The 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.
404Unknown event_id, or no snapshots inside the consensus window.Take the id straight from a /v1/latest quote.
422A parameter is out of range or the wrong type.Check the parameter tables above.
503The 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.
429The 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
Subscribe for A$99 a month

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+.