propzapi
Props-first sports odds API: live odds and player props across NBA/NFL/MLB/NHL as MCP tools.
Documentation
Live · props-first odds API
Real-time odds.
Props included.
One REST call returns moneyline, spreads, totals and player props for a game. Every book lined up and normalized into typed JSON. No scraping, no reconciling a dozen schemas.
Just clean odds data.
Get a free key → See it in action
Live · early access 500 free credits No credit card
**6+**leagues
4markets
Propsfirst-class
500free / mo
GET api.propzapi.com/v1/odds?league=NBA 200 OK
RequestResponseHeadersJSON
{
"event_id": "401766",
"league": "NBA",
"home_team": "Boston Celtics",
"away_team": "New York Knicks",
"commence_time": "2026-07-09T23:00:00Z",
"books": [
{ "book": "DraftKings", "markets": [
{ "market": "spreads", "outcome": "Celtics", "price": -110, "point": -4.5 }
]}
]
}
200 OKapplication/json · 1.4 KB
Plain REST and OpenAPI 3.1. Drops straight into Claude, Cursor, n8n, LangChain, Zapier and anything else that speaks HTTP.
ClaudeCursorChatGPTLangChainn8nZapierMakeClinePythonNode.jsPostmanMCP
Architecture
From request to live odds in a single round trip.
Your call gets authed and metered, hits the odds engine, and comes back with every book's line normalized into typed JSON. No middleware, no scraping.
▤
Your app
HTTP call with your API key
◆
Auth & meter
Key check, plan metering
⚡
Odds engine
Books lined up & normalized
✓
200 OK
Typed JSON, cost in a header
RuntimeFastAPI
SpecOpenAPI 3.1
OutputJSON
AgentsMCP + llms.txt
What you get
Every book's line, plus the props they skip.
No scraping a dozen sportsbook sites, no reconciling a dozen schemas. One call returns the whole board, or ask for a single market and get just that slice.
Event, books, markets and selections, typed and consistent. Moneyline, spreads, totals and player props side by side, so your tool can see exactly where the books disagree.
Event
event_idleaguehome_teamaway_teamcommence_timestatus
Markets
h2hspreadstotalsplayer_props
Selection
bookoutcomepricepointparticipant
Props
pointsreboundsassistspassing_ydsstrikeoutsshots
NFL, NBA, MLB, NHL, EPL and MLS today, more as people ask. Moneyline, spreads and totals live now; player props rolling out book by book.
NFLNBAMLBNHLEPLMLS
Points, rebounds, assists, passing yards, strikeouts, shots on goal. The markets most odds APIs skimp on, on their own endpoint and normalized across books.
/v1/propssame-gameper book
Point Claude, Cursor, Cline, n8n or LangChain at the hosted MCP server. OpenAPI 3.1 and llms.txt in the box, function-call ready, one key everywhere.
MCP serverOpenAPI 3.1llms.txtStable URLs
FAQ
Common questions about the odds API.
Straight answers about the data, props, pricing and agents, for developers and the LLMs that read this page on their behalf.
Where does the odds data come from?▾
We pull public odds from the major sportsbooks, line up the books and markets, and hand it back as clean JSON. Odds and scores are facts (that's settled law, NBA v. Motorola), so we're a data provider, not a sportsbook. We never take a bet.
What makes propzapi different?▾
The three things the big odds APIs are weakest on: player props as a first-class endpoint, pricing you can actually predict, and an integration an AI agent can use without a wrapper.
Is there an official odds API in 2026?▾
The books don't publish a public API for their lines. Developers who need moneyline, spreads, totals and player props today use a normalized wrapper like propzapi. One base URL, one key, every book lined up.
Is there a free tier?▾
Yes. 500 credits a month, no card. One POST to /v1/register and you have a key.
Can AI agents use it?▾
That's half the point. There's a hosted MCP server, an llms.txt and an OpenAPI spec, so an agent can pull odds in one line from Claude, Cursor, n8n or LangChain.
Endpoints
One API, four clean endpoints.
Game odds, player props, fixtures and live scores, and the books covered. Every response is the same event-and-books shape, so you learn it once.
GET/v1/odds
Moneyline, spreads & totals grouped by book. Filter by league, sport, market.
GET/v1/props
Player props for upcoming games. The markets most odds APIs skip.
GET/v1/events
Fixtures and live scores. Also /v1/events/{id} for one event with all lines.
GET/v1/books
The sportsbooks currently covered.
Full API reference →
Use cases
From side projects to trading desks.
Celtics −4.5−108
DK −110FD −108ESPN −105
Total 224.5o −105
DK −110FD −105ESPN −112
Arb & +EV screens
Every book lined up side by side, so your tool can spot where they disagree and where the soft lines are.
/v1/oddsmarket=spreads
"What are tonight's NBA player props on the Celtics?"
◆ get_props · league=NBA
Tatum o27.5 pts −115 · Brown o4.5 ast +100 …
Betting bots & agents
Point an MCP client at propzapi and your agent pulls live odds and props in one line, no wrapper to write.
MCPget_odds · get_props
Model edge+3.2%
closing line valuetracked
Model backtests
Pull historical and live lines into a model, track closing-line value, and feed dashboards, all from one normalized feed.
/v1/odds/v1/events
Try the API
One call. Any language.
Works with plain curl, fetch or requests, no SDK required. Swap pk_live_… for your key and every example hits a live endpoint.
cURLJavaScriptPython
curl "https://api.propzapi.com/v1/odds?league=NBA&market=spreads" \
-H "X-API-Key: pk_live_…"
Pricing
Free while you build. Pay when it earns.
500 credits a month free, no card. Metered by market, so every call returns its exact cost in a header. See full pricing →
Free tier
500 free credits every month
No card. Upgrade any time. Same leagues and markets on every plan.
Start free →
Free
$0
- 500 credits / mo
- All leagues & markets
- No card required
★ Popular
Indie
$19/mo
- 25,000 credits / mo
- Props + webhooks
- MCP + email support
Pro
$49/mo
- 100,000 credits / mo
- Priority freshness
- Priority support
Scale
$149/mo
- 1,000,000 credits / mo
- Highest limits
- SLA on request
From the blog
Guides for building on odds data.
Player props, arbitrage and +EV, and wiring live odds into apps and AI agents. All articles →
Tutorial
Odds API quickstart: live lines in 10 minutes
Get a free key and pull live odds with copy-paste cURL, Python and JavaScript.
Read → Player props
Build an NFL player props model
Pull prop odds as JSON, flatten them per player and book, strip the vig, and find edges.
Read → Comparison
Odds API vs web scraping
Scraping sportsbooks looks free until it breaks at scale. An honest cost and reliability comparison.
The best sports odds API for developers in 2026
An honest comparison of the main odds APIs on price, coverage, props depth and billing.
Read →
Ship today
Your first call
takes sixty seconds.
Sign up with email, copy your key, paste it into curl. The first 500 credits are on us. No card, no contract.
Get a free key →Read the docs
# 60-second quickstart
curl -X POST https://api.propzapi.com/v1/register
# → { "api_key": "pk_live_…", "credits": 500 }
curl "https://api.propzapi.com/v1/odds?league=NBA" \
-H "X-API-Key: pk_live_…"