American football odds API

American football leagues, markets and prices through one REST API.

American football has the sport key american_football. Its events are between two teams, home and away.

Leagues

League	Key	Bookmakers delivering
NFL	`nfl`	29
College football	`ncaaf`	12

Request the leagues

curl -sS "https://api.sockodds.com/v1/leagues?sport=american_football" \
  -H "Authorization: Bearer $SOCKODDS_API_KEY"

const response = await fetch("https://api.sockodds.com/v1/leagues?sport=american_football", {
  headers: { Authorization: `Bearer ${process.env.SOCKODDS_API_KEY}` },
});
console.log(JSON.stringify(await response.json(), null, 2));

import json, os, urllib.request

request = urllib.request.Request(
    "https://api.sockodds.com/v1/leagues?sport=american_football",
    headers={"Authorization": "Bearer " + os.environ["SOCKODDS_API_KEY"]},
)
with urllib.request.urlopen(request) as response:
    print(json.dumps(json.load(response), indent=2))

Response from a local copy of the API with invented test prices

{
  "data": [
    {
      "key": "nfl",
      "name": "NFL",
      "sport": "american_football",
      "region": "us",
      "periods": [
        "full",
        "regulation",
        "half_1",
        "half_2",
        "quarter_1",
        "quarter_2",
        "quarter_3",
        "quarter_4"
      ]
    },
    {
      "key": "ncaaf",
      "name": "College football",
      "sport": "american_football",
      "region": "us",
      "periods": [
        "full",
        "regulation",
        "half_1",
        "half_2",
        "quarter_1",
        "quarter_2",
        "quarter_3",
        "quarter_4"
      ]
    }
  ],
  "meta": {
    "count": 2,
    "cursor": null
  },
  "links": {
    "next": null
  }
}

Markets

19 market types are defined for american football: total_points_odd_even, team_points_odd_even, winner, result, handicap, total_points, team_points_over_under, player_passing_yards_over_under, player_rushing_yards_over_under, player_receiving_yards_over_under, player_receptions_over_under and player_passing_touchdowns_over_under and more. Each league page lists the markets and periods that apply to it, and Markets lists them all.