Quickstart
First API request in minutes
Copy these curl commands to exchange credentials for a JWT, pull a slate, and run a batch prediction. Full reference: API docs →
Not gambling advice. Model outputs are statistical estimates for information and entertainment only — not guarantees of outcomes.
1. Create account & API key
Developer accounts are separate from the consumer picks app. Sign up, then open the dashboard and create an API key. Copy api_key and api_secret — the secret is shown only once.
2. Exchange for a Bearer token
POST your key pair to /api/v1/auth/token. Use the access_token from the JSON response as Authorization: Bearer … on all other calls.
curl -sS -X POST "https://api.predictflow.club/api/v1/auth/token" \
-H "Content-Type: application/json" \
-d '{"api_key":"YOUR_API_KEY","api_secret":"YOUR_API_SECRET"}'3. Fetch a slate
Example: upcoming MLB games. See docs for NFL, WNBA, soccer, tennis, UFC, and other leagues.
curl -sS "https://api.predictflow.club/api/v1/mlb/games?completed=false&limit=5" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
4. Batch predictions
Send game IDs from step 3 to the batch predictions endpoint. Each authenticated request counts toward your monthly quota.
curl -sS -X POST "https://api.predictflow.club/api/v1/predictions/games" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"games":[{"sport":"MLB","game_id":12345}]}'Quotas & limits
The free plan includes 1,000 requests per calendar month. When your quota is exhausted, the API returns HTTP 429 — a hard stop until the next month or until you upgrade.
Upgrade to pay-as-you-go to remove the hard cap. Usage bills at $1.00 per 1,000 requests.
Upgrade from dashboard