Propzapi Full

Live sports odds & player props via propzapi.com. Four tools — pull moneyline/spreads/totals odds grouped by sportsbook, player props for upcoming games, fixtures & live scores, and the list of covered books, normalized across books so you don't scrape each one.

Live sports odds and player props via propzapi.com. Use when the user explicitly asks for real sportsbook odds, player props, lines, or fixtures/scores for a game or league — and wants sourced numbers rather than a guess.

Odds live behind a dozen different sportsbook sites, each with its own markup and its own idea of a "market." propzapi normalizes moneyline, spreads, totals and player props across books into one JSON shape, so your agent gets a line it can trust in one call.

When to use this skill

Each tool call spends propzapi credits (1 for a single market, 3 for all game markets, 5 for player props), so this skill activates only when the request is genuinely about live odds — not when a team or league merely comes up in passing.

DO use when the user:

• Asks for the odds / moneyline / spread / total on a game or league → get_odds
• Asks for player props (points, rebounds, passing yards, etc.) → get_props
• Asks what games are on, live scores, or the schedule → get_events
• Asks which sportsbooks are covered → get_books

Do NOT use when:

• A team or league appears incidentally (news, small talk, a fantasy roster)
• The user wants historical results or season stats — propzapi is live/upcoming odds, not a stats archive
• The user is asking for betting advice or a pick — return the numbers, not a recommendation

When intent is ambiguous, confirm the league before calling.

Tools

get_odds — game odds grouped by book

Moneyline, spreads and totals for upcoming games, grouped by sportsbook. Args: league (e.g. NBA, NFL, MLB, NHL, EPL, MLS), sport (e.g. basketball), market (h2h | spreads | totals | player_props; omit for all game markets), limit (1–100, default 25). Costs 1 credit for a single market, 3 for all.

get_props — player props

Player props for upcoming games — the markets most odds APIs skip. Args: league, sport, limit (1–100, default 25). Costs 5 credits.

get_events — fixtures & live scores

Games and live scores, no odds. Args: league, sport, status (upcoming | live | final), limit (1–100, default 25). Costs 1 credit.

get_books — covered sportsbooks

The sportsbooks currently normalized. No args. Costs 1 credit.

Authentication

Set PROPZAPI_KEY to your propzapi key. Keys are pk_live_... strings, sent as the X-API-Key header.

bash

export PROPZAPI_KEY="pk_live_..."

Get a free key (500 free credits, no card required) at https://propzapi.com/app.

Pricing

Calls are metered by market — the response returns the exact charge in the X-Credits-Cost header. Credits never expire.

Plan	Price	Credits / mo
Free	$0	500
Indie	$19/mo	25,000
Pro	$49/mo	100,000
Scale	$149/mo	1,000,000

Manage plans at https://propzapi.com/pricing.

Errors

All functions return a Python dict. On success it's the API response; on failure it has an error key:

• {"error": "auth_required", ...} — PROPZAPI_KEY not set (includes signup_url)
• {"error": "auth_invalid", ...} — key rejected; mint a new one at /app
• {"error": "out_of_credits", ...} — credit balance exhausted; includes upgrade_url
• {"error": "not_found", ...} — no match for that league/event
• {"error": "rate_limit_exceeded", ...} — plan request limit or too many free keys from this IP
• {"error": "upstream_unavailable", ...} — an odds source was briefly unreachable; retry
• {"error": "invalid_argument", ...} — bad market or status value
• {"error": "network" | "HTTP <code>" | "unexpected", ...} — transport / other failures

API reference

• Docs: https://propzapi.com/docs
• OpenAPI spec: https://api.propzapi.com/openapi.json
• Pricing: https://propzapi.com/pricing

Independence

propzapi is an independent developer tool that aggregates publicly listed sportsbook odds. It is not a sportsbook, does not accept wagers, and does not provide betting advice. Odds are informational and may be delayed. Comply with the laws of your jurisdiction and each sportsbook's terms.