Swap

Swap allows you to retrieve currency exchange rates from various services such as Fixer, currencylayer, exchangeratesapi or Abstract and optionally cache the results. It is integrated to other libraries like moneyphp/money and provides a Symfony Bundle and a Laravel Package.

Sponsors

	Fixer is a simple and lightweight API for foreign exchange rates that supports up to 170 world currencies.
	currencylayer provides reliable exchange rates and currency conversions for your business up to 168 world currencies.
	exchangeratesapi provides reliable exchange rates and currency conversions for your business with over 15 data sources.
	Abstract provides simple exchange rates for developers and a dozen of APIs covering thousands of use cases.

QuickStart

$ composer require php-http/curl-client nyholm/psr7 php-http/message florianv/swap

use Swap\Builder;

// Build Swap
$swap = (new Builder())

    // Use the Fixer.io service as first level provider
    ->add('fixer', ['access_key' => 'your-access-key'])
     
    // Use the currencylayer.com service as first fallback
    ->add('currency_layer', ['access_key' => 'secret', 'enterprise' => false])
    
    // Use the exchangeratesapi.io service as second fallback
    ->add('exchange_rates_api', ['access_key' => 'secret'])
     
    // Use the abstractapi.com service as third fallback
    ->add('abstract_api', ['api_key' => 'secret'])
->build();
    
// Get the latest EUR/USD rate
$rate = $swap->latest('EUR/USD');

// 1.129
$rate->getValue();

// 2016-08-26
$rate->getDate()->format('Y-m-d');

// Get the EUR/USD rate 15 days ago
$rate = $swap->historical('EUR/USD', (new \DateTime())->modify('-15 days'));

We recommend to use the services that support our project, providing a free plan up to 1,000 requests per day.

Documentation

The documentation for the current branch can be found here.

Services

Here is the list of the currently implemented services:

Additionally, you can add your own services as long as they implement the ExchangeRateService interface.

Integrations

• A Symfony Bundle FlorianvSwapBundle
• A Laravel Package florianv/laravel-swap

Credits

• Florian Voutzinos
• All Contributors

License

The MIT License (MIT). Please see LICENSE for more information.