Authentication
All requests to the MoneyLine API must include a valid API key. Pass your key via the x-api-key header on every request. Requests without a valid key will be rejected with a 401 status code.
Getting an API Key
- Create a free account on the sign-up page.
- Open your dashboard.
- Click Create Key to generate a new API key.
Your key will look something like ml_live_abc123.... Keep it secret — treat it like a password.
Example Request
Include the x-api-key header with your key in every request:
Authenticated request
curl -H "x-api-key: ml_live_abc123..." \
https://mlapi.bet/v1/events/today
Tier Access Levels
The data you can access depends on your plan. Each tier unlocks additional endpoints and higher rate limits:
| Plan | Includes | Rate Limit |
|---|---|---|
| Free | Scores, standings, schedules, rosters | 1,000 req/month |
| Hobbyist | + Odds, injuries, bookmaker data | 50,000 req/month |
| Pro | + Edge analysis, play-by-play, all bookmakers | 500,000 req/month |
| Enterprise | Everything + custom feeds | Unlimited |
Error Responses
If your API key is missing or invalid, the API returns a 401 Unauthorized response:
401 — Invalid or missing key
{
"success": false,
"error": {
"code": 401,
"message": "Valid API key required. Pass x-api-key header."
}
}
If your key is valid but your plan does not include the requested resource, the API returns a 403 Forbidden response:
403 — Tier-gated resource
{
"success": false,
"error": {
"code": 403,
"message": "Your plan does not include access to this resource."
}
}