README

A convenient API wrapper for the Odds API, designed for Composer environments such as Laravel.

About "The Odds API"

The Odds API is a simple and very well-documented API, allowing for fast, low-cost integration. It covers over 70 sports and over 40 bookmakers - with a continuing expanding offering. The Odds API is an Australian company based in Melbourne since 2017.

Why a Wrapper?

A wrapper simplifies the usage and implementation of powerful APIs like "The Odds API". It abstracts the complexities of direct API interactions, providing a more user-friendly interface for us developers.

Contribution Guide

This is an open-source project, so contributions are welcome! Whether you want to add new features, fix bugs, or improve documentation, your help is appreciated. Submit your PR for review and I will review them as soon as possible.

Steps for Installation

Composer

composer require sethsharp/odds-api

Publish Config file

This file contains some essential information the Client requires to make successful requests

php artisan vendor:publish --tag="odds-api-config"

Example Usages

You can simply create a new Client, passing in your api key and that's it!

$client = new OddsClient(config('odds-api.api_key'));

$response = $client->setRegion('au')
    ->dateFormat('iso')
    ->getOddsForSport(SportsEnum::RUGBYLEAGUE_NRL);

return $response->json();

This package is set up in a way that all the params you need can be built using chainable function helpers, as they all return $this. Once you call one of the API endpoints which return a response, you can no longer call these function helpers.

Another way to define your Client Class

You can bind your Client class at runtime in the AppServiceProvider. Allowing you to simply define the Client on the container (via the constructor of a class in Laravel), without having to constantly pass the api credentials.

$this->app->bind(OddsClient::class, function () {
    return new OddsClient(config('odds-api.api_key'));
});

then your class may look like

use HandlesOddsResponse;

public function __invoke(OddsClient $client): Response
{
    $response = $client->setRegion('us')
        ->getOddsForSport(SportsEnum::RUGBYLEAGUE_NRL);
        
    return $this->extractJsonFromResponse($response);
}

Additional: When constructing the Client, it will have some default parameters

$this->params = [
    'api_key' => $this->apiKey,
    'regions' => config('odds-api.default_region'),
    'oddsFormat' => config('odds-api.default_odds_format')
];

This avoids having to define these on each request, but they can be overwritten with their corresponding class functions ie; setRegions('au')

To help manage your quota, there are helpers that you can call to return the number of requests used and remaining. Checkout the UseHandleHeaders trait, which can be called on any OddsClient instant.

Also, if this API ever becomes outdated for a small period of time and you need to add new parameters, you can utilise the addParams() function, which accepts an array.

Credits

• Seth Sharp
• All Contributors