Dashboard
Feed Active
🔗
0
Total Clients
⚡
0
Active Clients
📈
0
Requests Today
🏆
0
Total Requests
Live EventsLIVE
0
currently in-play
Prematch Events
0
upcoming
WebSocket Clients
0
connected now
API Clients
Loading...
| Client | API Key | Plan | Status | Rate | Today | Total | Last Used | Actions |
|---|
No API clients yet
API PlaygroundTest endpoints live
GET
// Response will appear here
// Enter an endpoint and API key, then click Send
Quick Endpoints
/odds/v1/status
/odds/v1/sports
/odds/v1/live?sport=1
/odds/v1/prematch?sport=1
Response Info
Status: --
Time: --
Size: --
Events: --
API Reference
Complete documentation for the Fillesabet Odds API v1
https://fillesabet.com
Authentication
All requests require an API key via the
X-API-Key header or ?api_key= query parameter. Unauthorized requests return 401. Rate-limited requests return 429.
REST Endpoints
GET/odds/v1/statusHealth check▼
Returns service health, live event count, last update timestamp, and connected WebSocket clients.
RequestCopy
curl -H "X-API-Key: YOUR_KEY" https://fillesabet.com/odds/v1/status
Response
{
"success": true,
"live_events": 64,
"prematch_events": 0,
"last_update": 1775131802036,
"ws_clients": 2
}
GET/odds/v1/sportsList sports▼
Returns all available sports with live and prematch event counts.
RequestCopy
curl -H "X-API-Key: YOUR_KEY" https://fillesabet.com/odds/v1/sports
GET/odds/v1/liveLive events + odds▼
Get all live (in-play) events with full market and odds data. Filter by sport using query parameter.
| Parameter | Type | Description |
|---|---|---|
sport | integer | Optional. Filter by sport ID (e.g. 1 for Soccer) |
RequestCopy
curl -H "X-API-Key: YOUR_KEY" "https://fillesabet.com/odds/v1/live?sport=1"
Response (truncated)
{
"success": true,
"sport": 1,
"ts": 1775131802036,
"data": {
"12345": {
"id": "12345",
"home": "Team A",
"away": "Team B",
"sport": 1,
"league": "Premier League",
"score": { "home": 1, "away": 0 },
"state": 1,
"live": true,
"markets": {
"1": {
"name": "1X2",
"outcomes": {
"1": { "name": "1", "odds": 1.85, "active": true }
}
}
}
}
}
}
GET/odds/v1/prematchPre-match events▼
Get all pre-match events with full market and odds data. Same parameters as /live.
RequestCopy
curl -H "X-API-Key: YOUR_KEY" "https://fillesabet.com/odds/v1/prematch?sport=1"
GET/odds/v1/eventSingle event▼
Fetch a specific event by its unique ID. Provide sport for faster lookup.
| Parameter | Type | Description |
|---|---|---|
id | string | Required. Event ID |
sport | integer | Optional. Sport ID for faster cache lookup |
RequestCopy
curl -H "X-API-Key: YOUR_KEY" "https://fillesabet.com/odds/v1/event?id=12345&sport=1"
WebSocket
WSwss://fillesabet.com/odds-wsReal-time push▼
Connect for real-time live odds updates. Receives a full snapshot on connect, then differential updates every ~3 seconds when odds change. Authenticate via ?api_key=YOUR_KEY query parameter.
JavaScriptCopy
const ws = new WebSocket('wss://fillesabet.com/odds-ws?api_key=YOUR_KEY');
ws.onmessage = (event) => {
const msg = JSON.parse(event.data);
if (msg.type === 'snapshot') {
// Full initial state
console.log('Live events:', msg.live);
console.log('Prematch:', msg.prematch);
}
if (msg.type === 'live_update') {
// Incremental update (same structure as /odds/v1/live)
console.log('Updated at:', msg.ts, msg.data);
}
};
Sport IDs
1
Soccer
2
Basketball
3
Baseball
4
Ice Hockey
5
Tennis
6
Handball
7
Volleyball
10
Boxing
20
Table Tennis
21
Badminton
22
Snooker
23
Darts
Rate Limits
Free
10
requests / min
- Live events only
- REST API access
Basic
60
requests / min
- Live + Prematch
- REST API access
Pro
300
requests / min
- All endpoints
- WebSocket access
- Priority support