# NCAAF Odds API
The Odds API covers NCAAF (College Football) odds for live and upcoming games in a simple JSON API.
Not a developer? Current NCAAF odds can also be accessed in Excel or Google Sheets. For website owners, the odds widget brings bookmaker odds into websites with a simple HTML tag.
# Features
NCAAF odds are covered for live and upcoming games.
Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the full list of bookmakers.
Additional markets including player props, half and quarter time markets, and more are covered for most US bookmakers. See the full list of betting markets.
Odds are refreshed at regular intervals. More information on update intervals can be found here.
NCAAF scores are covered, with final scores available for games completed up to 3 days ago.
Current odds data and scores are available on all usage plans, including the free usage plan.
Historical NCAAF odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from mid-2020. Historical odds for other markets are available from May 2023. More information on historical odds data can be found here.
The API response includes deep links to bookmaker websites.
Rotation numbers are included in the API response.
# Querying NCAAF Odds
# Query Featured NCAAF Markets
Featured markets (moneyline, spreads and totals) can be queried using the odds endpoint. For additional markets including player props, use the event-odds endpoint.
Parameters
To query current NCAAF odds for featured markets, the following parameters need to be provided:
- sport In this case
americanfootball_ncaaf - regions Regions of bookmakers to return, for example
us - markets For example,
h2hfor moneyline,spreadsandtotals - apiKey Get a free API key
See the documentation for more options
Example API Request
https://api.the-odds-api.com/v4/sports/americanfootball_ncaaf/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY
Example API Response
The API will return live and upcoming NCAAF games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets.
[{
"id": "680b1441ea6113b9cc8f723ee1616f39",
"sport_key": "americanfootball_ncaaf",
"sport_title": "NCAAF",
"commence_time": "2024-12-19T02:00:00Z",
"home_team": "UNLV Rebels",
"away_team": "California Golden Bears",
"bookmakers": [
{
"key": "fanduel",
"title": "FanDuel",
"last_update": "2024-12-18T23:55:22Z",
"markets": [
{
"key": "h2h",
"last_update": "2024-12-18T23:55:22Z",
"outcomes": [
{"name": "California Golden Bears", "price": 134},
{"name": "UNLV Rebels", "price": -162}
]
},
{
"key": "spreads",
"last_update": "2024-12-18T23:55:22Z",
"outcomes": [
{"name": "California Golden Bears", "price": -115,"point": 3.5},
{"name": "UNLV Rebels", "price": -105, "point": -3.5}
]
},
{
"key": "totals",
"last_update": "2024-12-18T23:55:22Z",
"outcomes": [
{"name": "Over", "price": -110, "point": 45.5},
{"name": "Under", "price": -110, "point": 45.5}
]
}
]
},
...The usage cost of the API call in this example is
usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits
See the API documentation for details.
# Query Any NCAAF Markets
Any supported NCAAF markets can be queried one game at a time using the event-odds endpoint.
Parameters
To query current NCAAF odds for any market, including player props, innings markets and more, the following parameters need to be provided:
- sport In this case
americanfootball_ncaaf - eventId This example uses the id of Bengals @ Cowboys (id 2fd3...). A list of current event ids can be queried using the events endpoint.
- regions Regions of bookmakers to return, for example
us - markets For example
h2h_q1(1st quarter moneyline),player_pass_tds,player_rush_yds - apiKey Get a free API key
See the documentation for more options.
Example API Request
https://api.the-odds-api.com/v4/sports/americanfootball_ncaaf/events/2fd335893dbb8ab9c0e1aea6c98a969c/odds?regions=us&markets=h2h_q1,player_pass_tds,player_rush_yds&oddsFormat=american&apiKey=YOUR_API_KEY
Example API Response
The response will contain the specified NCAAF game including odds from the specified bookmakers and markets.
{
"id": "680b1441ea6113b9cc8f723ee1616f39",
"sport_key": "americanfootball_ncaaf",
"sport_title": "NCAAF",
"commence_time": "2024-12-19T02:00:00Z",
"home_team": "UNLV Rebels",
"away_team": "California Golden Bears",
"bookmakers": [
{
"key": "fanduel",
"title": "FanDuel",
"last_update": "2024-12-18T23:55:22Z",
"markets": [
{
"key": "h2h_q1",
"last_update": "2024-12-18T23:54:47Z",
"outcomes": [
{"name": "California Golden Bears", "price": 112},
{"name": "UNLV Rebels", "price": -142}
]
},
{
"key": "player_pass_tds",
"last_update": "2024-12-18T23:54:38Z",
"outcomes": [
{"name": "Over", "description": "Hajj-Malik Williams", "price": 154, "point": 1.5},
{"name": "Under", "description": "Hajj-Malik Williams", "price": -196, "point": 1.5}
]
},
{
"key": "player_rush_yds",
"last_update": "2024-12-18T23:54:47Z",
"outcomes": [
{"name": "Over", "description": "Jai'Den Thomas", "price": -112, "point": 55.5},
{"name": "Under", "description": "Jai'Den Thomas", "price": -112, "point": 55.5},
{"name": "Over", "description": "Jaydn Ott", "price": -112, "point": 54.5},
{"name": "Under", "description": "Jaydn Ott", "price": -112, "point": 54.5},
{"name": "Over", "description": "Hajj-Malik Williams", "price": -112, "point": 64.5},
{"name": "Under", "description": "Hajj-Malik Williams", "price": -112, "point": 64.5}
]
}
]
},
...The usage cost of the API call in this example is
usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits
If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the odds endpoint since it will return multiple games.
See the API documentation for details.
# Other Sports
See the full list of sports covered by The Odds API.
# Stay Updated
Follow us on X.com or Bluesky to stay updated on new sports, bookmakers, markets and features.