Getting started with Oddlyx
Build powerful betting applications with real-time, normalized odds data. This guide walks you through the basics so you can ship your first integration in minutes.
Overview
Oddlyx provides real-time, normalized odds data across multiple sportsbooks. Whether you're building arbitrage bots, +EV scanners, or betting platforms, our API delivers sub-5-second updates with consistent data structures.
Real-time updates
Live odds via WebSocket push (~20s) or REST. Never miss an opportunity with our real-time data stream.
Normalized data
Consistent data structure across all sportsbooks. No need to handle different formats or schemas.
Quick Start
Get up and running in 3 simple steps:
2Make your first request
Use your API key to authenticate and fetch data. Here's a simple example:
curl -X GET "https://odds-marketplace.onrender.com/api/v1/nba/odds/games?date=2024-01-15" \
-H "Authorization: Bearer sk_your_api_key_here"Authentication
All API requests require authentication using your API key. Include your key in the request headers using the Authorization header with Bearer format:
Authorization Header
Example header:
Authorization: Bearer sk_your_api_key_hereKeep Your API Key Secure
Example Request
Here's a complete example using JavaScript's fetch API:
const response = await fetch(
"https://odds-marketplace.onrender.com/api/v1/nba/odds/games?date=2024-01-15",
{
headers: {
"Authorization": "Bearer sk_your_api_key_here",
"Content-Type": "application/json"
}
}
);
if (!response.ok) {
throw new Error(`API error: ${response.status}`);
}
const data = await response.json();
console.log(data);Python example
import requests
response = requests.get(
"https://odds-marketplace.onrender.com/api/v1/nba/odds/games",
params={"date": "2024-01-15"},
headers={"Authorization": "Bearer sk_your_api_key_here"}
)
if response.status_code == 200:
data = response.json()
print(data)
else:
print(f"Error: {response.status_code}")Response Format
All API responses follow a consistent JSON structure:
{
"success": true,
"data": [
{
"game_id": 12345,
"home_team": "Lakers",
"away_team": "Warriors",
"start_time": "2024-01-15T20:00:00Z",
"status": "scheduled"
}
],
"meta": {
"total": 1,
"limit": 100,
"offset": 0
}
}Error Responses
success: false and an error field containing the error message.