# American Football Odds API
URL: https://sockodds.com/sports/football-odds-api/

> Access american football betting odds from every Australian bookmaker through the SockOdds API. American Football odds for NFL including head to head, lines, totals, player props and more.

Access american football betting odds from 25 bookmakers through the SockOdds API. Get american football odds for every game including head to head, lines, totals, player props and more — `sportID=FOOTBALL`.

## American Football Odds API Features

Our american football odds API is fully filterable, so you pull exactly the data you want — games, player props, teams or specific markets. Curate the feed to your needs with the same parameters SportsGameOdds developers already know.

36 distinct markets are priced across 1 league right now:

- Head to head / moneylines (2-way and 3-way markets)
- Lines, spreads and handicaps
- Totals (over/under)
- Alternative lines
- Player props and game props
- Period-specific markets (quarters and halves)

## American Football leagues

| League | leagueID | Events | Markets | Bookmakers |
| --- | --- | --- | --- | --- |
| [NFL](https://sockodds.com/leagues/nfl-odds-api/) | `NFL` | 130 | 36 | 18 |

## American Football Player Props

Player props for american football are keyed like every other sport (the `playerID` in the `statEntityID` slot); the Australian books price american football mainly at team and match level today. See the [player prop odds API](https://sockodds.com/player-props-odds-api/).

## American Football API Odds with Results

SockOdds delivers american football odds and event data in one configuration:

- Upcoming games with status flags
- Home and away teams with ids
- Players with production ids where the source carries them
- American Football odds including lines, totals, head to head, player props and more
- Results and grading flags where the source has them

## Quick start: your first American Football odds API call

```
https://api.sockodds.com/v2/events?apiKey=YOUR_API_KEY&oddsAvailable=true&sportID=FOOTBALL&limit=10
```

Or one league at a time, which is faster:

```
https://api.sockodds.com/v2/events?apiKey=YOUR_API_KEY&oddsAvailable=true&leagueID=NFL&limit=10
```

## Stats priced in american football

| statID | Name | Markets | Levels |
| --- | --- | --- | --- |
| `points` | Points / score | 1,066 | all, team |
| `firstToScore` | First to score | 8 | team |

## American Football Odds API Technical Specifications

### API Architecture

- **REST API** — Simple HTTP endpoints with JSON responses, identical to the SportsGameOdds v2 paths
- **Polling, not push** — the feed refreshes every ~2 minutes; `/v2/stream/events` is reserved and answers 501 rather than pretending
- **Rate limits** — per-key, per-minute meters that bind under concurrency; plans sized to your usage
- **Authentication** — secure API key access via the `x-api-key` header or `apiKey` query parameter

### Data Update Speed

- **Odds updates** — every ~2 minutes across every bookmaker lane
- **Event status** — `status` flags and `info.stale` tell you exactly how current a price is

### Developer Resources

- [Interactive documentation](https://sockodds.com/docs/) — live examples, copy-paste snippets and an [AI (vibe coding)](https://sockodds.com/docs/info/ai-vibe-coding/) context
- [SDKs & libraries](https://sockodds.com/docs/sdk/) — the SportsGameOdds SDKs for TypeScript, Python, Ruby, Go and Java work unchanged with the base URL pointed here
- [Postman collection](https://sockodds.com/postman-collection/) — pre-built requests ready to run
- [Support](https://sockodds.com/docs/help/) — email support on every plan, priority on paid plans

### American Football market coverage by category

| Market category | Example markets | Markets | Availability | Typical bookmakers |
| --- | --- | --- | --- | --- |
| **Full game lines** | Points / score O/U, Points / score line, Points / score | 10 oddIDs | Pre-match | [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/), [Picklebet](https://sockodds.com/bookmakers/picklebet-odds-api/), [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/) |
| **Period markets** | Points / score O/U, Points / score line, Points / score 1X2 | 18 oddIDs | Pre-match | [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [PointsBet](https://sockodds.com/bookmakers/pointsbet-odds-api/), [Sportsbet](https://sockodds.com/bookmakers/sportsbet-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/), [Neds](https://sockodds.com/bookmakers/neds-odds-api/), [TABtouch](https://sockodds.com/bookmakers/tabtouch-odds-api/) |
| **Score & margin specials** | First to score | 2 oddIDs | Pre-match | [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/), [betr (sportsbook)](https://sockodds.com/bookmakers/betrsportsbook-odds-api/), [CrownBet](https://sockodds.com/bookmakers/crownbet-odds-api/), [Ladbrokes](https://sockodds.com/bookmakers/ladbrokes-odds-api/) |
| **Team & game specials** | Points / score | 6 oddIDs | Pre-match | [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [PointsBet](https://sockodds.com/bookmakers/pointsbet-odds-api/), [Sportsbet](https://sockodds.com/bookmakers/sportsbet-odds-api/), [TAB](https://sockodds.com/bookmakers/tab-odds-api/) |

## Use Cases for American Football API Data

- [Arbitrage](https://sockodds.com/use-cases/arbitrage-betting-api/) & [+EV tools](https://sockodds.com/use-cases/positive-ev-betting-api/) — compare american football odds across every Australian bookmaker to uncover arbitrage opportunities and positive expected value angles.
- [Odds comparison platforms](https://sockodds.com/use-cases/odds-comparison-api/) — display american football odds from every book side by side for comprehensive line shopping.
- **Pricing models & trading** — use american football market data as inputs for proprietary pricing algorithms and betting strategies.
- [Sports analytics & research](https://sockodds.com/use-cases/sports-betting-machine-learning/) — examine american football line movements and betting-market patterns, and build predictive models on retained events.
- [Betting automation](https://sockodds.com/use-cases/odds-alert-bot-api/) — build systems that monitor american football lines across bookmakers and trigger actions when your target odds appear.
- [Sportsbook & fantasy apps](https://sockodds.com/use-cases/sports-betting-app-api/) — power your american football product with reliable odds, status and bet-slip deeplinks.

## American Football Odds API Documentation

Our interactive documentation covers everything you need to integrate American Football odds into your project:

- Full endpoint reference with parameters and response schemas
- Live request and response examples
- Code snippets in Python, JavaScript, Ruby, Go and Java
- Authentication setup and API key management
- Rate limiting and the `notice` field
- Error handling and troubleshooting

[View documentation](https://sockodds.com/docs/)

## Start building today

Free plan available. Set up in 5 minutes. Scale when you're ready.