clutchapi

The official Python client for the CLUTCH API: live odds and player props from 30+ sportsbooks, line movement, closing lines, CLV grading, arbitrage and webhooks. Standard library only.

pip install clutchapi

from clutchapi import Clutch

clutch = Clutch("ck_live_...")   # or set CLUTCH_API_KEY

nfl = clutch.odds("nfl")
props = clutch.props("nba", market="points")
steam = clutch.steam(sport="nfl")
close = clutch.closing(sport="nfl", game_key="...", market="spread")

Get a key at api.clutchbets.online/console.

Live stream

for event, data in clutch.stream(sport="nba"):
    print(event, data)

Line-move webhooks

out = clutch.alerts.create(channel="webhook", url="https://your.app/hooks/clutch",
                           book="pinnacle", sport="nfl", min_move=1)
secret = out["secret"]   # shown once, save it

Verify each delivery (Flask example, raw body):

from clutchapi import verify_webhook

@app.post("/hooks/clutch")
def hook():
    if not verify_webhook(request.get_data(), request.headers.get("X-Clutch-Signature"), SECRET):
        return "", 401
    moves = request.get_json()["moves"]
    return "", 200

Errors and limits

Failed requests raise ClutchError with .status and .body. After every call, clutch.last_limits holds your rate-limit and monthly-quota headers.

Any endpoint is reachable directly with clutch.get("/api/v1/...", {...}). Full reference: api.clutchbets.online/docs.

MIT © Cooper Tech Solutions LLC