FanDuel APIfanduel.com ↗
Access FanDuel Sportsbook odds, game lines, player props, live events, and full market boards via 6 structured JSON endpoints.
What is the FanDuel API?
The FanDuel Sportsbook API covers 6 endpoints that expose sports, competitions, event schedules, live markets, and full per-event market boards including player props. Starting with list_sports, you get every sport currently offered — complete with numeric sport_id values — which chain directly into list_competitions and then list_competition_events to retrieve spreads, moneylines, totals, and selection-level American and decimal odds across any league or tournament FanDuel lists.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/dbc572de-e88e-43d7-8f33-0f44c61ddff4/list_sports' \ -H 'X-API-Key: $PARSE_API_KEY'
Lists every sport FanDuel Sportsbook currently offers betting on, in the site's A-Z betting order. Each row carries the numeric sport_id used by list_competitions, list_competition_events and list_live_events. One round trip; no inputs; no pagination.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer count of sports returned",
"sports": "array of {sport_id (integer, site sport identifier), name}"
},
"sample": {
"data": {
"total": 3,
"sports": [
{
"name": "American Football",
"sport_id": 6423
},
{
"name": "Soccer",
"sport_id": 1
},
{
"name": "Basketball",
"sport_id": 7522
}
]
},
"status": "success"
}
}About the FanDuel API
Sports, Competitions, and Event Schedules
list_sports returns every sport FanDuel currently offers for betting, each with a sport_id integer. Pass that sport_id to list_competitions to get every league, tournament, or futures grouping available for that sport, each with its own competition_id. Feeding both IDs into list_competition_events returns the full schedule: upcoming and live fixtures plus outrights, each event carrying start_time (ISO-8601 UTC), in_play status, video_available flag, and an array of markets. For fixtures, those markets include spread (with handicap), moneyline, and totals, with each selection carrying American odds (american_odds) and decimal odds.
Full Event Market Boards and Player Props
get_event_markets returns the complete market board for a single event as it appears on the FanDuel event page. Pass event_id and an optional tab slug (sourced from available_tabs[*].slug on a prior call) to retrieve markets for a specific tab — such as player props for NFL passing yards, rushing yards, or receiving yards. Each market includes market_type (site code like PLAYER_X_PASSING_YARDS_HIGH), status (OPEN or SUSPENDED), in_play, and selections with handicap, side, and full odds. The available_tabs array in every response lists all tabs the site offers for that event.
Live Events and Search
list_live_events returns currently in-play events for a sport, including real-time market status — note that status may be SUSPENDED when prices are updating. It also returns live_counts_by_sport, a per-sport counter array useful for building a live lobby view. Omitting sport_id returns the site's default live view across all sports.
search accepts a free-text query (team, player, league, or event name) and returns matching events grouped into sport tabs, with the featured markets attached. It supports zero-based start_index pagination via next_start_index and exposes total_results across all tabs alongside found_in_tab for the selected tab.
The FanDuel API is a managed, monitored endpoint for fanduel.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fanduel.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official fanduel.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a real-time odds comparison dashboard tracking spread, moneyline, and total lines from list_competition_events.
- Monitor player prop lines and handicap values for a specific NFL or NBA game via get_event_markets with a props tab.
- Aggregate live in-play market statuses across all sports using list_live_events and the live_counts_by_sport counters.
- Construct a futures tracker by pulling outrights from list_competition_events for season-winner competitions.
- Power a search-driven betting tool that looks up teams or players and surfaces their upcoming event markets via the search endpoint.
- Track line movement over time by polling list_competition_events or get_event_markets and logging american_odds changes per selection.
- Build a sport lobby showing live event counts per sport using live_counts_by_sport from list_live_events.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FanDuel have an official public developer API?+
What does get_event_markets return beyond the basic game lines?+
handicap field and site market type codes like PLAYER_X_PASSING_YARDS_HIGH. Each selection carries American odds, decimal odds, side (HOME/AWAY/OVER/UNDER/DRAW or null), and an OPEN or SUSPENDED status. The available_tabs array tells you which tabs exist for that event so you can fetch each one separately.Does the search endpoint return results across all sports simultaneously?+
tabs (all sport tab titles found) plus total_results across all tabs. Only the selected_tab results are returned per call; there is no single-call way to retrieve all tabs at once. You can fork this API on Parse and revise it to add multi-tab iteration.Are historical odds or settled event results available?+
How does in_play status behave across endpoints, and what does SUSPENDED mean for selections?+
in_play is a boolean present on both events and individual markets; it is always true for events returned by list_live_events. A market or selection status of SUSPENDED indicates the price is temporarily unavailable, typically while FanDuel is recalculating odds mid-game. OPEN means the selection is currently available to bet.