propzapi-full

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.

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.