API Reference

oddsblaze.client.OddsblazeClient(settings=None, timeout=30.0)

Synchronous client for the OddsBlaze API.

close()

Close the HTTP client.

get_active_markets()

Get active markets across all leagues.

get_consensus(league, market, *, price=None, dedupe=None, sportsbooks=None, required_sportsbooks=None, weights=None)

Get consensus odds across sportsbooks.

Parameters:

Name	Type	Description	Default
league	str	League ID (e.g., "nfl")	required
market	str	Market ID (e.g., "point-spread")	required
price	Optional[PriceFormat]	Price format (defaults to settings)	None
dedupe	Optional[bool]	Remove duplicate prices (default True)	None
sportsbooks	Optional[list[str]]	Sportsbooks to include (at least one must have odds)	None
required_sportsbooks	Optional[list[str]]	Sportsbooks that must all be present	None
weights	Optional[dict[str, float]]	Custom weights by sportsbook ID (e.g., {"draftkings": 1.5})	None

get_historical(odds_id, *, price=None, time_series=False, locked=False)

Get historical odds with CLV, OLV, and line movement.

Parameters:

Name	Type	Description	Default
odds_id	str	The odds ID from a previous odds response	required
price	Optional[PriceFormat]	Price format (defaults to settings)	None
time_series	bool	Include line movement history	False
locked	bool	Include locked odds in time series	False

get_last_polled(*, league=None, sportsbook=None, group=False)

Get last polled timestamps for odds.

Parameters:

Name	Type	Description	Default
league	Optional[str | list[str]]	League ID(s) to filter	None
sportsbook	Optional[str | list[str]]	Sportsbook ID(s) to filter	None
group	bool	Group results by sportsbook	False

get_leagues()

Get all available leagues.

get_odds(sportsbook, league, *, market=None, market_contains=None, price=None, event=None, main=None, live=None)

Get real-time odds for a sportsbook and league.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook ID (e.g., "draftkings")	required
league	str	League ID (e.g., "nfl")	required
market	Optional[str | list[str]]	Market ID(s) or name(s) to filter	None
market_contains	Optional[str | list[str]]	Filter markets containing these strings	None
price	Optional[PriceFormat]	Price format (defaults to settings)	None
event	Optional[str | list[str]]	Event ID(s) to filter	None
main	Optional[bool]	True for main lines only, False for alternates only	None
live	Optional[bool]	True for live events only, False for pre-match only	None

get_schedule(league, *, event_id=None, team=None, date=None, live=None)

Get upcoming and live events.

Parameters:

Name	Type	Description	Default
league	str	League ID (e.g., "nfl")	required
event_id	Optional[str | list[str]]	Event ID(s) to filter	None
team	Optional[str | list[str]]	Team ID(s), name(s), or abbreviation(s) to filter	None
date	Optional[str | list[str]]	Date(s) in YYYY-MM-DD format, or range YYYY-MM-DD-YYYY-MM-DD	None
live	Optional[bool]	True for live only, False for pre-match only	None

get_sportsbooks()

Get all available sportsbooks.

grade_bet(odds_id, *, live=False)

Grade a bet (Win, Lose, or Push).

Parameters:

Name	Type	Description	Default
odds_id	str	The odds ID to grade	required
live	bool	Grade while event is still in progress	False

grade_moneyline(sportsbook, event_id, team, *, live=False)

Grade a moneyline bet.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
team	str	Team name (e.g., "Boston Celtics")	required
live	bool	Grade while event is still in progress	False

grade_player_bet(sportsbook, event_id, market, player_name, player_id, side, line, *, live=False)

Grade a player prop bet.

Builds the odds ID automatically from the provided components.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
market	str	Market name (e.g., "Player Points", "Player Rebounds")	required
player_name	str	Player's name (e.g., "Jaylen Brown")	required
player_id	str	Player's UUID (from a previous get_odds() call)	required
side	str	Selection side ("Over" or "Under")	required
line	float	The betting line (e.g., 22.5)	required
live	bool	Grade while event is still in progress	False

grade_spread(sportsbook, event_id, team, line, *, market='Point Spread', live=False)

Grade a point spread bet.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
team	str	Team name (e.g., "Boston Celtics")	required
line	float	The spread line (e.g., -2.5 or +2.5)	required
market	str	Market name (default "Point Spread", or "1st Quarter Point Spread")	'Point Spread'
live	bool	Grade while event is still in progress	False

grade_total(sportsbook, event_id, side, line, *, market='Total Points', live=False)

Grade a total points bet.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
side	str	"Over" or "Under"	required
line	float	The total line (e.g., 229.5)	required
market	str	Market name (default "Total Points", or "1st Quarter Total Points")	'Total Points'
live	bool	Grade while event is still in progress	False

grade_yes_no(sportsbook, event_id, market, selection, *, live=False)

Grade a Yes/No or simple selection bet.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
market	str	Market name (e.g., "Overtime?", "Total Points Odd/Even")	required
selection	str	The selection (e.g., "Yes", "No", "Odd", "Even")	required
live	bool	Grade while event is still in progress	False

oddsblaze.async_client.AsyncOddsblazeClient(settings=None, timeout=30.0)

Asynchronous client for the OddsBlaze API.

close()

Close the HTTP client.

get_active_markets()

Get active markets across all leagues.

get_consensus(league, market, *, price=None, dedupe=None, sportsbooks=None, required_sportsbooks=None, weights=None)

Get consensus odds across sportsbooks.

Parameters:

Name	Type	Description	Default
league	str	League ID (e.g., "nfl")	required
market	str	Market ID (e.g., "point-spread")	required
price	Optional[PriceFormat]	Price format (defaults to settings)	None
dedupe	Optional[bool]	Remove duplicate prices (default True)	None
sportsbooks	Optional[list[str]]	Sportsbooks to include (at least one must have odds)	None
required_sportsbooks	Optional[list[str]]	Sportsbooks that must all be present	None
weights	Optional[dict[str, float]]	Custom weights by sportsbook ID (e.g., {"draftkings": 1.5})	None

get_historical(odds_id, *, price=None, time_series=False, locked=False)

Get historical odds with CLV, OLV, and line movement.

Parameters:

Name	Type	Description	Default
odds_id	str	The odds ID from a previous odds response	required
price	Optional[PriceFormat]	Price format (defaults to settings)	None
time_series	bool	Include line movement history	False
locked	bool	Include locked odds in time series	False

get_last_polled(*, league=None, sportsbook=None, group=False)

Get last polled timestamps for odds.

Parameters:

Name	Type	Description	Default
league	Optional[str | list[str]]	League ID(s) to filter	None
sportsbook	Optional[str | list[str]]	Sportsbook ID(s) to filter	None
group	bool	Group results by sportsbook	False

get_leagues()

Get all available leagues.

get_odds(sportsbook, league, *, market=None, market_contains=None, price=None, event=None, main=None, live=None)

Get real-time odds for a sportsbook and league.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook ID (e.g., "draftkings")	required
league	str	League ID (e.g., "nfl")	required
market	Optional[str | list[str]]	Market ID(s) or name(s) to filter	None
market_contains	Optional[str | list[str]]	Filter markets containing these strings	None
price	Optional[PriceFormat]	Price format (defaults to settings)	None
event	Optional[str | list[str]]	Event ID(s) to filter	None
main	Optional[bool]	True for main lines only, False for alternates only	None
live	Optional[bool]	True for live events only, False for pre-match only	None

get_schedule(league, *, event_id=None, team=None, date=None, live=None)

Get upcoming and live events.

Parameters:

Name	Type	Description	Default
league	str	League ID (e.g., "nfl")	required
event_id	Optional[str | list[str]]	Event ID(s) to filter	None
team	Optional[str | list[str]]	Team ID(s), name(s), or abbreviation(s) to filter	None
date	Optional[str | list[str]]	Date(s) in YYYY-MM-DD format, or range YYYY-MM-DD-YYYY-MM-DD	None
live	Optional[bool]	True for live only, False for pre-match only	None

get_sportsbooks()

Get all available sportsbooks.

grade_bet(odds_id, *, live=False)

Grade a bet (Win, Lose, or Push).

Parameters:

Name	Type	Description	Default
odds_id	str	The odds ID to grade	required
live	bool	Grade while event is still in progress	False

grade_moneyline(sportsbook, event_id, team, *, live=False)

Grade a moneyline bet.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
team	str	Team name (e.g., "Boston Celtics")	required
live	bool	Grade while event is still in progress	False

grade_player_bet(sportsbook, event_id, market, player_name, player_id, side, line, *, live=False)

Grade a player prop bet.

Builds the odds ID automatically from the provided components.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
market	str	Market name (e.g., "Player Points", "Player Rebounds")	required
player_name	str	Player's name (e.g., "Jaylen Brown")	required
player_id	str	Player's UUID (from a previous get_odds() call)	required
side	str	Selection side ("Over" or "Under")	required
line	float	The betting line (e.g., 22.5)	required
live	bool	Grade while event is still in progress	False

grade_spread(sportsbook, event_id, team, line, *, market='Point Spread', live=False)

Grade a point spread bet.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
team	str	Team name (e.g., "Boston Celtics")	required
line	float	The spread line (e.g., -2.5 or +2.5)	required
market	str	Market name (default "Point Spread", or "1st Quarter Point Spread")	'Point Spread'
live	bool	Grade while event is still in progress	False

grade_total(sportsbook, event_id, side, line, *, market='Total Points', live=False)

Grade a total points bet.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
side	str	"Over" or "Under"	required
line	float	The total line (e.g., 229.5)	required
market	str	Market name (default "Total Points", or "1st Quarter Total Points")	'Total Points'
live	bool	Grade while event is still in progress	False

grade_yes_no(sportsbook, event_id, market, selection, *, live=False)

Grade a Yes/No or simple selection bet.

Parameters:

Name	Type	Description	Default
sportsbook	str	Sportsbook name (e.g., "FanDuel", "DraftKings")	required
event_id	str	Event ID (UUID)	required
market	str	Market name (e.g., "Overtime?", "Total Points Odd/Even")	required
selection	str	The selection (e.g., "Yes", "No", "Odd", "Even")	required
live	bool	Grade while event is still in progress	False