Struct TheOddsApiClient 

pub struct TheOddsApiClient { /* private fields */ }

The main client for interacting with The Odds API.

Implementations

impl TheOddsApiClient

pub fn new(api_key: impl Into<String>) -> Self

Create a new client with the given API key.

pub fn builder(api_key: impl Into<String>) -> TheOddsApiClientBuilder

Create a builder for more advanced configuration.

pub async fn get_sports(&self) -> Result<Response<Vec<Sport>>>

Get all in-season sports.

This endpoint does not count against your usage quota.

Example

let client = the_odds_api::TheOddsApiClient::new("your-api-key");
let sports = client.get_sports().await?;
for sport in sports.data {
    println!("{}: {}", sport.key, sport.title);
}

pub async fn get_all_sports(&self) -> Result<Response<Vec<Sport>>>

Get all sports, including out-of-season ones.

This endpoint does not count against your usage quota.

pub fn get_events(&self, sport: impl Into<String>) -> GetEventsRequest<'_>

Get events for a sport without odds.

This endpoint does not count against your usage quota.

pub fn get_odds(&self, sport: impl Into<String>) -> GetOddsRequest<'_>

Get odds for a sport.

Quota Cost

Cost = number of markets × number of regions

Example

let client = the_odds_api::TheOddsApiClient::new("your-api-key");
let odds = client
    .get_odds("americanfootball_nfl")
    .regions(&[Region::Us])
    .markets(&[Market::H2h, Market::Spreads])
    .send()
    .await?;

pub fn get_upcoming_odds(&self) -> GetOddsRequest<'_>

Get odds for upcoming events across all sports.

pub fn get_scores(&self, sport: impl Into<String>) -> GetScoresRequest<'_>

Get scores for a sport.

Quota Cost

1 for live/upcoming scores, 2 when using days_from.

pub fn get_event_odds( &self, sport: impl Into<String>, event_id: impl Into<String>, ) -> GetEventOddsRequest<'_>

Get detailed odds for a single event.

This endpoint supports all available markets including player props.

pub fn get_event_markets( &self, sport: impl Into<String>, event_id: impl Into<String>, ) -> GetEventMarketsRequest<'_>

Discover available markets for an event.

Quota Cost

1

pub async fn get_participants( &self, sport: impl Into<String>, ) -> Result<Response<Vec<Participant>>>

Get all participants (teams/players) for a sport.

Quota Cost

1

pub fn get_historical_odds( &self, sport: impl Into<String>, ) -> GetHistoricalOddsRequest<'_>

Get historical odds for a sport at a specific timestamp.

Quota Cost

10 × number of markets × number of regions

pub fn get_historical_events( &self, sport: impl Into<String>, ) -> GetHistoricalEventsRequest<'_>

Get historical events for a sport at a specific timestamp.

Quota Cost

1 (0 if no events found)

pub fn get_historical_event_odds( &self, sport: impl Into<String>, event_id: impl Into<String>, ) -> GetHistoricalEventOddsRequest<'_>

Get historical odds for a single event at a specific timestamp.

Trait Implementations

impl Clone for TheOddsApiClient

fn clone(&self) -> TheOddsApiClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TheOddsApiClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.