BASE URL

https://arb-mvp-production.up.railway.app

ENDPOINTS

GET /health System health check
GET /api/v1/odds/live/:sport Live odds by sport
GET /api/v1/odds/movement/:eventId Line movement history
GET /api/v1/books/latency Book latency metrics
GET /api/v1/edges Current edge opportunities
GET /api/v1/events Active events list

LIVE ODDS

GET /api/v1/odds/live/:sport

Returns current odds across all connected sportsbooks for a given sport.

Parameter Type Description
sport string nba, nfl, mlb, nhl, ncaab, ncaaf
GET /api/v1/odds/live/nba

Example response:

{ "sport": "nba", "timestamp": "2025-01-15T18:30:00Z", "events": [ { "eventId": "nba_lal_bos_20250115", "home": "Boston Celtics", "away": "Los Angeles Lakers", "books": { "draftkings": { "homeML": -150, "awayML": +130 }, "fanduel": { "homeML": -145, "awayML": +125 } } } ] }

Python Example:

import requests url = "https://arb-mvp-production.up.railway.app/api/v1/odds/live/nba" response = requests.get(url) data = response.json() print(f"Events found: {len(data['events'])}")

HISTORICAL DATA

GET /api/v1/odds/history

Retrieve past odds for backtesting strategies. Defaults to last 24h if no dates provided.

Parameter Type Description
sport string nba, nfl, mlb, nhl, ncaab, ncaaf
start string ISO 8601 Date (Optional)
end string ISO 8601 Date (Optional)
GET /api/v1/odds/history?sport=nba&start=2023-01-01T00:00:00Z

LINE MOVEMENT

GET /api/v1/odds/movement/:eventId

Returns 24h rolling history of line changes for a specific event.

Parameter Type Description
eventId string Unique event identifier
GET /api/v1/odds/movement/nba_lal_bos_20250115

LATENCY

GET /api/v1/books/latency

Returns latency metrics for each connected sportsbook, measured in milliseconds.

{ "timestamp": "2025-01-15T18:30:00Z", "books": { "draftkings": { "avgLatencyMs": 145, "lastUpdateMs": 87 }, "fanduel": { "avgLatencyMs": 198, "lastUpdateMs": 234 } } }

EDGES

GET /api/v1/edges

Returns current arbitrage and value opportunities detected across books.

{ "timestamp": "2025-01-15T18:30:00Z", "edges": [ { "eventId": "nba_lal_bos_20250115", "type": "arb", "expectedValue": 1.2, "books": ["draftkings", "fanduel"] } ] }