peso/openexchangerates-service

Open Exchange Rates data provider for Peso

1.0.2 2025-07-26 00:58 UTC

Requires

• php: ^8.2
• peso/core: ^1.1
• psr/http-client: ^1
• psr/http-factory: ^1
• psr/simple-cache: ^1 || ^2 || ^3

Requires (Dev)

• guzzlehttp/guzzle: ^7.9
• php-http/discovery: ^1.20
• php-http/mock-client: ^1.6
• phpunit/phpunit: ^12.2
• psy/psysh: *
• sandfox.dev/code-standard: ^1.2025.05.07
• squizlabs/php_codesniffer: *
• symfony/cache: ^7.3
• vimeo/psalm: ^6.12

MIT

• Anton Smirnov

• currency
• conversion
• openexchangerates
• exchange
• Open Exchange Rates
• peso
• phpeso

README

This is an exchange data provider for Peso that retrieves data from Open Exchange Rates.

Installation

composer require peso/openexchangerates-service

Install the service with all recommended dependencies:

composer install peso/openexchangerates-service php-http/discovery guzzlehttp/guzzle symfony/cache

Example

<?php

use Peso\Peso\CurrencyConverter;
use Peso\Services\OpenExchangeRatesService;
use Peso\Services\OpenExchangeRatesService\AppType;
use Symfony\Component\Cache\Adapter\FilesystemAdapter;
use Symfony\Component\Cache\Psr16Cache;

require __DIR__ . '/../vendor/autoload.php';

$cache = new Psr16Cache(new FilesystemAdapter(directory: __DIR__ . '/cache'));
$service = new OpenExchangeRatesService('...', AppType::Free, cache: $cache);
$converter = new CurrencyConverter($service);

// 10664.96 as of 2025-06-26
echo $converter->convert('12500', 'USD', 'EUR', 2), PHP_EOL;

Documentation

Read the full documentation here: https://phpeso.org/v1.x/services/openexchangerates.html

Support

Please file issues on our main repo at GitHub: https://github.com/phpeso/openexchangerates-service/issues

License

The library is available as open source under the terms of the MIT License.