mirror of
https://github.com/hanzoskill/odds-checker-api.git
synced 2026-10-30 21:12:51 +00:00
1.7 KiB
1.7 KiB
Odds-API.io quick reference (v3)
Base URL
Authentication
- Pass the API key as a query parameter:
apiKey=YOUR_KEY. - Never store the key in this skill or repo. Prefer
ODDS_API_KEY.
Core endpoints (GET)
/sports- List sports (no apiKey required)./bookmakers- List bookmakers (no apiKey required)./events- List events for a sport.- Required:
sport(slug) - Optional:
league,participantId,status,from,to,bookmaker
- Required:
/events/search- Search events by name.- Required:
query(min 3 chars)
- Required:
/events/{id}- Get a single event by ID./odds- Fetch odds for a specific event.- Required:
eventId,bookmakers(comma-separated, max 30)
- Required:
/odds/multi- Fetch odds for multiple events.- Required:
eventIds(comma-separated, up to 10),bookmakers
- Required:
/odds/movements- Odds movement for an event/market/bookmaker.- Required:
eventId,bookmaker,market
- Required:
/value-bets- Value bet opportunities./arbitrage-bets- Arbitrage opportunities.
Response fields (selected)
SimpleEventDto (from /events, /events/search)
id(integer)date(string)home,away(string)sport{name,slug}league{name,slug}status(string)
Odds response (from /odds)
id,date,home,away,statussport{name,slug}league{name,slug}bookmakersmap:{ "BookmakerName": [markets...] }urlsmap:{ "BookmakerName": "link" }
Recommended workflow
/sportsto get sport slugs./events/searchto find candidate events and IDs./bookmakersto pick bookmaker names./oddswitheventIdandbookmakers.