ZenHodl Sports Edge
ZenHodl is a sports API for live and delayed game states, fair probabilities, fair lines, venue comparisons, and edge signals across 7 sports. Use it to: - monitor live games and model probabilities - compare fair prices to market prices - retrieve fair lines by sport - inspect venue-level market differences - power dashboards, alerts, and internal workflows The API includes REST endpoints for…
ZenHodl Sports Edge endpoints
| Method | Endpoint | Description |
|---|---|---|
| v1 | ||
| DELETE |
delete_webhook_v1_webhooks__webhook_id__delete /v1/webhooks/{webhook_id} |
Deactivate a webhook (must own it). |
| GET |
get_sports_v1_sports_get /v1/sports |
Available sports and model metadata. |
| POST |
create_watchlist_endpoint_v1_watchlists_post /v1/watchlists |
Create a new watchlist. |
| GET |
model_clv_v1_model_clv_get /v1/model/clv |
Live Closing Line Value (CLV) tracking — measures signal quality against market close. |
| PUT |
update_prefs_v1_preferences_put /v1/preferences |
Update user notification preferences. |
| GET |
get_prefs_v1_preferences_get /v1/preferences |
Get user notification preferences. |
| POST |
register_webhook_v1_webhooks_post /v1/webhooks |
Register a webhook to receive edge signal push notifications (Starter+). |
| PUT |
update_watchlist_endpoint_v1_watchlists__watchlist_id__put /v1/watchlists/{watchlist_id} |
Update a watchlist. |
| GET |
list_watchlists_v1_watchlists_get /v1/watchlists |
List user's watchlists. |
| GET |
model_performance_v1_model_performance_get /v1/model/performance |
Model quality metrics from training metadata (Brier, ROC-AUC, ECE, etc.). |
| DELETE |
delete_watchlist_endpoint_v1_watchlists__watchlist_id__delete /v1/watchlists/{watchlist_id} |
Delete a watchlist. |
| GET |
predictions_latest_v1_predictions_latest_get /v1/predictions/latest |
Download today's pre-game fair probability predictions as CSV. |
| GET |
predictions_batch_v1_predictions_batch_get /v1/predictions/batch |
Download predictions for a date range (Pro+ only). Query params: - start: YYYYMMDD - end: YYYYMMDD - sport: optional filter (NBA, NHL, etc.) Returns concatenated CSV of all daily… |
| GET |
backtest_sports_v1_backtest_sports_get /v1/backtest/sports |
List available sports and seasons for backtesting. |
| GET |
try_edge_v1_try_get /v1/try |
Free: look up a live game and see fair WP vs market price. |
| GET |
get_fair_lines_v1_fair_lines__sport__get /v1/fair-lines/{sport} |
Fair moneylines in American odds format for all live games. |
| GET |
predictions_by_date_v1_predictions__date__get /v1/predictions/{date} |
Download predictions for a specific date (YYYYMMDD). |
| GET |
predict_pregame_v1_predict__sport__pregame_get /v1/predict/{sport}/pregame |
Today's upcoming games with Elo-based pregame win probabilities. |
| GET |
predictions_sample_csv_v1_predictions_sample_csv_get /v1/predictions/sample.csv |
Free sample: live + recent edge signals as CSV (no auth). Shows the full value proposition: fair WP, market ask, edge, model type. Live games get real data; always padded with… |
| GET |
edges_sample_v1_edges_sample_get /v1/edges/sample |
Free sample: top 3 edges, delayed 15 minutes, NBA + NHL only. |
| GET |
predict_game_v1_predict__sport___game_id__get /v1/predict/{sport}/{game_id} |
Single game detail with full model output and multi-venue edges. |
| GET |
get_venues_v1_venues_get /v1/venues |
List all available data venues with their connection status. |
| GET |
get_usage_v1_usage_get /v1/usage |
Current month's API usage. |
| GET |
get_snapshots_v1_snapshots__sport___date__get /v1/snapshots/{sport}/{date} |
Read archived WP snapshots for a sport on a given date (YYYYMMDD). Requires Pro tier or above. |
| GET |
list_webhooks_v1_webhooks_get /v1/webhooks |
List all webhooks for the authenticated user. |
| GET |
predict_live_v1_predict__sport__live_get /v1/predict/{sport}/live |
Live games with win probabilities and multi-venue edges. |
| GET |
live_preview_v1_live_preview_get /v1/live-preview |
Public: top live games with fair WP for landing page previews (no auth). |
| GET |
health_v1_health_get /v1/health |
Health check — no auth required. |
| GET |
get_games_v1_games_get /v1/games |
Get all live games with fair win probabilities. |
| GET |
get_edges_v1_edges_get /v1/edges |
Get current edge signals (model disagrees with market). |
| POST |
run_backtest_v1_backtest_post /v1/backtest |
Run a WP model backtest with custom parameters. Submit your strategy config (min_edge, min_period, etc.) and get backtest results against our 25.6M-row dataset. Pro tier and above. |
ZenHodl Sports Edge pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $49 / month | 60 / minute |
|
| ULTRA | $149 / month | 300 / minute |
|
| MEGA | $299 / month | 1000 / minute |
|