Getoddsapi

GetOdds data gateway

The Odds API v4-compatible routes at every GetOdds book (DraftKings, FanDuel, BetRivers, Pinnacle, Novig) with per-event player props and scores; DraftKings…

Data & analytics#sports--fitness

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The Odds API v4-compatible routes at every GetOdds book (DraftKings, FanDuel, BetRivers, Pinnacle, Novig) with per-event player props and scores; DraftKings and FanDuel DFS slates and salaries; Player props at every book (FanDuel, DraftKings, BetRivers, Pinnacle, Novig, PrizePicks, Underdog, DK Pick6) with line history, Novig exchange prices, scoped player thresholds from four sources, DraftKings-via-ESPN prices, native FanDuel and BetRivers US-PA prices, and explicitly bounded analysis and evidence APIs. Price analysis is conditional; computed assessments are not official sportsbook settlements.

Endpoints 58

  • GETPlayer props at every book, merged per player, stat and game day/api/v1/props?sport=nbaOpen to every valid key; one credit per page. Pregame lines for games in the next 48 hours from FanDuel, DraftKings, BetRivers, Pinnacle and Novig (two-sided…
  • GETLine and price history of one prop quote, with its open and close/api/v1/props/history?book=fanduel&id=stringOpen to every valid key; one credit. Pass the book and a quote id from /api/v1/props (quotes with history=true). Points are oldest first. close is the last…
  • GETNovig exchange pregame prices: game lines and player props/api/v1/novig/marketsOpen to every valid key; one credit per page. Novig is a no-vig exchange: price_american and price_decimal convert the ask (the price a taker gets, 1 minus…
  • GETDraftKings and FanDuel DFS slates with salaries/api/v1/dfs/slatesOpen to every valid key; one credit per call. Upcoming DraftKings draft groups and FanDuel slates (next 60 days) from GetOdds’ stored collectors. Only slates…
  • GETPlayer salaries for one DraftKings or FanDuel DFS slate/api/v1/dfs/salaries?site=draftkings&slate_id=stringOpen to every valid key; one credit per page. Every player in the slate with the site’s posted salary, position, team, game and status; FanDuel adds its FPPG.…
  • GETRead BetRivers US-PA native pregame priced markets/api/v1/betrivers/marketsRequires an explicit betrivers source grant AND selected bookmaker before upstream I/O. Existing keys gain no automatic grant. One shared credit per…
  • GETRead Pinnacle pregame prices (moneyline, spread, total, team total, specials incl. NFL player props)/api/v1/pinnacle/marketsOpen to every valid key; one credit per successful page. Read through from Pinnacle's public guest API at request time and reused for at most 20 seconds per…
  • GETKalshi and Polymarket player-prop contracts normalized next to sportsbook prices/api/v1/prediction-marketsAvailable to every GetOdds key, one credit per successful page. Best ask per side in dollars per $1 contract, converted to implied probability, American and…
  • GETStored price changes for one Kalshi or Polymarket contract/api/v1/prediction-markets/history?id=stringNewest first, last 14 days, one credit per page. One row per stored change; gaps mean no stored change.
  • GETRead durable imported source price evidence for one event/api/v1/history/archive?event_id=string&from=2024-01-01T00:00:00Z&to=2024-01-01T00:00:00ZRequires the selected source grant and bookmaker selection. One credit per successful page. Data exists only after archive activation/import. Native…
  • GETRead source capture activation, coverage gaps and storage budget state/api/v1/history/coverageRequires source grant, not price selection. One credit per successful read. Reports at most100 recent execution receipts and policy-derived missing-run…
  • GETRead observed provider-result revisions, not official settlements/api/v1/settlements?event_id=stringRequires DraftKings scope. Returns result evidence captured by successful grading requests, newest revision first. No native bookmaker settlement records are…
  • POSTProvisionally assess retained contracts against verified final scores/api/v1/settlements/gradeDraftKings source grant and selected bookmaker required before contract retrieval. Policy completed-game-score-v1 supports NFL/NBA/NCAAF/NCAAB full-game…
  • GETAnalyze conditional recent stored-price arbitrage/api/v1/arbitrage-betsRequires BOTH draftkings and fanduel key grants AND both selected bookmakers under locked admission before source I/O. One shared credit per successful page.…
  • GETCompare prices with another book’s no-vig reference/api/v1/value-betsRequires BOTH draftkings and fanduel key grants AND both selected bookmakers under locked admission before source I/O. One shared credit per successful page.…
  • GETRead conservative DraftKings-to-FanDuel event metadata associations/api/v1/mappingsRequires BOTH draftkings and fanduel key grants before either source read, but no bookmaker price selection. One credit per successful page. Includes…
  • GETRead last retained offer snapshots before the stored scheduled start/api/v1/historical/closing-lines?event_id=stringDraftKings grant and selected bookmaker required. One credit per successful page. Selects the last retained price per market, period and side observed…
  • GETRead a verified ESPN participant PNG logo/api/v1/participants/:id/logo?event_id=stringRequires DraftKings bearer scope and event_id. Verifies retained event and provider participant before following a provider-supplied default PNG URL on the…
  • GETRead current verified ESPN final-result evidence for a retained event/api/v1/events/:id/resultRequires DraftKings bearer source grant. First verifies persisted event identity, then makes one allowlisted bounded ESPN summary request (5s,2MiB). One…
  • GETRead recently observed FanDuel in-play game events/api/v1/events/liveRequires FanDuel bearer scope, not price selection. One credit per successful page. Only non-future open/suspended markets observed in play within the past15…
  • GETRead stored FanDuel game markets/api/v1/sportsbook/marketsStored FanDuel current records with native identities and literal clocks. Requires FanDuel key scope and selected bookmaker. One successful page costs one…
  • GETDiscover stored FanDuel futures markets/api/v1/outrightsStored FanDuel current records with native identities and literal clocks. Requires FanDuel key scope and selected bookmaker. One successful page costs one…
  • GETRead stored FanDuel futures selection prices/api/v1/outrights/oddsStored FanDuel current records with native identities and literal clocks. Requires FanDuel key scope and selected bookmaker. One successful page costs one…
  • GETStream bounded retained-change pages over authenticated WebSocket/api/v1/odds/streamActual WebSocket upgrade on the Node/Fluid runtime. Server-side clients must send Authorization: Bearer; credentials in URLs and cookie-only authentication…
  • GETResume bounded retained offer changes by sequence/api/v1/odds/replayOne source-scoped SQL snapshot per request. First request uses after=0 and omits through to capture the current upper source sequence. Continue with…
  • GETRead permitted account sportsbook selections/api/v1/bookmakers/selectedBearer key must grant at least one of draftkings, fanduel or betrivers. GET exposes only the granted subset. Select replaces that entire editable subset and…
  • PUTReplace the sportsbook selection subset editable by this key/api/v1/bookmakers/selected/select?bookmakers=draftkingsBearer key must grant at least one of draftkings, fanduel or betrivers. GET exposes only the granted subset. Select replaces that entire editable subset and…
  • PUTClear only sportsbook selections editable by this key/api/v1/bookmakers/selected/clearBearer key must grant at least one of draftkings, fanduel or betrivers. GET exposes only the granted subset. Select replaces that entire editable subset and…
  • GETget Event Source State/api/v1/events/:id/stateOne source-reported ESPN state for a known stored DraftKings-via-ESPN event. State and completed are observed directly from ESPN; no cached state fallback,…
  • GETget Event Participants/api/v1/participants?event_id=stringThe home and away teams for one known stored event. IDs are ESPN-native and namespaced by league; this is not a global participant directory or cross-book…
  • GETget Event Participant/api/v1/participants/:id?event_id=stringResolve an ESPN-native participant within a required verified event. Returns one row or 404 if the team is not in the event. No logos or cross-provider…
  • GETget Leagues/api/v1/leaguesLeagues present in retained DraftKings-via-ESPN events. Counts describe retained rows, not guaranteed current coverage.
  • GETget Historical Events/api/v1/historical/events?league=NBA&from=2024-01-01T00:00:00Z&to=2024-01-01T00:00:00ZRetained events whose scheduled starts fall in [from,to). Required UTC Z timestamps, at most 31 days per request, to no later than now. State is unknown:…
  • GETsearch Historical Events/api/v1/historical/events/search?league=NBA&from=2024-01-01T00:00:00Z&to=2024-01-01T00:00:00Z&q=stringLiteral case-insensitive team-name search over a bounded retained event window. Same historical constraints; completion is not verified.
  • GETget Odds Summary/api/v1/odds/summary?event_id=stringMatching market-line summaries from one independent bookmaker. Captures must be within 15 minutes. Best, average, median and worst currently reflect the same…
  • GETget Multiple Odds Summaries/api/v1/odds/summary/multi?event_ids=stringSame single-book summary contract across up to 20 events. At most 2,000 input offers; narrow selection if 422. Missing events produce no synthetic rows.
  • GETRead stored DraftKings events/api/v1/eventsStored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.
  • GETRead stored DraftKings odds/api/v1/oddsStored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.
  • GETRead stored DraftKings history/api/v1/historySupply event_id or offer_id. Every retained change since collection began, newest first. Missing observations are not reconstructed.
  • GETRead stored DraftKings sports/api/v1/sportsStored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.
  • GETRead stored DraftKings bookmakers/api/v1/bookmakersStored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.
  • GETRead stored DraftKings market-types/api/v1/market-typesStored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.
  • GETSearch retained event team names/api/v1/events/search?q=stringCase-insensitive literal substring search over home and away names. One retained source; results may include past events.
  • GETGet one retained event by source ID/api/v1/events/:idReturns a one-row data array or 404. The ID is source-specific, not a canonical cross-book identity.
  • GETRead stored odds for up to 20 event IDs/api/v1/odds/multi?event_ids=stringOne bounded combined page across the requested IDs. Missing events are not invented. Offset pages are not a frozen snapshot.
  • GETRead current offers with retained changes since a timestamp/api/v1/odds/updated?since=2024-01-01T00:00:00ZRequires an ISO timestamp within the last seven days. Matches retained history changes strictly after since, then returns the current stored offer. This is…
  • GETRead same-line decimal-price decreases/api/v1/dropping-oddsCompares the latest two retained changes within 24 hours for identical event, market, period, side and line. Requires a fresh capture (15 minutes), an…
  • GETDescribe the agent signup request/api/v1/agent/signup
  • POSTCreate a free GetOdds key without a browser (shown once)/api/v1/agent/signupFree tier only: 2,000 requests per UTC day and 60 per minute, every source granted, DraftKings, FanDuel and BetRivers selected. One key per email (+tags and…
  • GETKeyless sandbox: endpoints and limits/api/v1/sandbox
  • GETKeyless sandbox: sports with a board/api/v1/sandbox/sports
  • GETKeyless sandbox: cached DraftKings game lines for one sport/api/v1/sandbox/odds?sport=nflReal stored DraftKings (via ESPN) moneyline, spread and total rows from a cache up to 300 seconds old, at most 50 rows. 10 requests a minute and 100 a day per…
  • GETThe Odds API v4 shape: sports GetOdds maps (0 credits)/v4/sportsSame request and response shape as The Odds API GET /v4/sports. Lists sports with upcoming DraftKings or FanDuel games; all=true lists every mapped sport.
  • GETThe Odds API v4 shape: game odds at every GetOdds book for one sport (1 credit)/v4/sports/:sport/oddsSame request and response shape as The Odds API GET /v4/sports/{sport}/odds: events[].bookmakers[] with key, title, last_update and markets[] (h2h, spreads,…
  • GETThe Odds API v4 shape: one event, game lines and player props at every book (1 credit)/v4/sports/:sport/events/:eventId/oddsSame shape as The Odds API GET /v4/sports/{sport}/events/{eventId}/odds: one event object. markets takes h2h, spreads, totals and, for NBA, NCAAB, NFL, NCAAF…
  • GETThe Odds API v4 shape: upcoming, live and recent scores (1 credit)/v4/sports/:sport/scoresSame shape as The Odds API GET /v4/sports/{sport}/scores, from the ESPN scoreboard: today and tomorrow (US Eastern) for upcoming and live games; daysFrom=1..3…
  • GETThe Odds API v4 shape: upcoming events without odds (0 credits)/v4/sports/:sport/events
  • GETRead an incomplete source-specific player threshold sample/api/v1/markets

API details

Base URL
https://getoddsapi.com
Authentication
A bearer token in the Authorization header
An API key in the apiKey query parameter
Operations
58 operations on 57 pathsGET 54PUT 2POST 2
Response formats
application/json image/png
Description format
OpenAPI 3.1.0, API version 0.8.0

How to test the GetOdds data gateway in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the GetOdds data gateway collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Player props at every book, merged per player, stat and game day” (GET /api/v1/props?sport=nba), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the GetOdds data gateway?

The Odds API v4-compatible routes at every GetOdds book (DraftKings, FanDuel, BetRivers, Pinnacle, Novig) with per-event player props and scores; DraftKings… It is listed under Data & analytics and has 58 endpoints.

Who publishes the GetOdds data gateway?

It is listed from Getoddsapi's public API description (an OpenAPI document), not published by Getoddsapi on Swastik Codes. Anyone who controls getoddsapi.com can claim the profile by adding a DNS TXT record.

What is the base URL of the GetOdds data gateway?

Requests go to https://getoddsapi.com. Endpoint paths are added to this base URL.

How do I authenticate with the GetOdds data gateway?

It accepts 2 methods: A bearer token in the Authorization header; an API key in the apiKey query parameter.

How many endpoints does the GetOdds data gateway have?

58 operations on 57 paths (54 GET, 2 PUT, 2 POST).

Is forking the GetOdds data gateway free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.