README

Installation

composer require aveiv/open-exchange-rates-api

Usage example

$api = new OpenExchangeRates('YOUR_APP_ID');
// or $client = new OpenExchangeRates('YOUR_APP_ID', new YourHttpClient());


// Getting currencies

$api->currencies(); // returns ["USD" => "United States Dollar", ...]

$api->currencies([
    'show_alternative' => true, // include alternative currencies
    'show_inactive' => true,    // include historical/inactive currencies
]);


// Getting latest rates

$api->latest(); // returns ["USD" => 1.0, ...]

$api->latest([
    'base' => 'EUR',             // base currency
    'symbols' => ['CNY', 'USD'], // limit results to specific currencies
    'show_alternative' => true,  // include alternative currencies
]);


// Getting historical rates

$api->historical(new \DateTime('2020-01-01')); // ["USD" => 1.0, ...]

$api->historical(new \DateTime('2020-01-01'), [
    'base' => 'EUR',             // base currency
    'symbols' => ['CNY', 'USD'], // limit results to specific currencies
    'show_alternative' => true,  // include alternative currencies
]);


// Currency conversion

$api->convert(99.99, 'USD', 'EUR'); // returns the converted value (from USD to EUR)