PHPackages                             ranium/fixerio-php-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ranium/fixerio-php-client

ActiveLibrary[API Development](/categories/api)

ranium/fixerio-php-client
=========================

A PHP client for fixer.io foreign exchange rates and currency conversion API.

v1.2.0(5y ago)345.5k↑29.2%31MITPHPCI failing

Since Feb 5Pushed 5y agoCompare

[ Source](https://github.com/ranium/fixerio-php-client)[ Packagist](https://packagist.org/packages/ranium/fixerio-php-client)[ RSS](/packages/ranium-fixerio-php-client/feed)WikiDiscussions 1.x Synced 2d ago

READMEChangelog (4)Dependencies (3)Versions (6)Used By (1)

 [ ![Build Status](https://github.com/ranium/fixerio-php-client/workflows/tests/badge.svg) ](https://github.com/ranium/fixerio-php-client/actions) [ ![Total Downloads](https://camo.githubusercontent.com/8fc4d2b2375487902afa16bff8e20485d70e079236e89d0cade8d8243c684b15/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f72616e69756d2f6669786572696f2d7068702d636c69656e74) ](https://packagist.org/packages/ranium/fixerio-php-client) [ ![Latest Stable Version](https://camo.githubusercontent.com/ba160cf688b38500251231531ee1292a5551194bee460ec0490cdf0a4031e3d0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f72616e69756d2f6669786572696f2d7068702d636c69656e74) ](https://packagist.org/packages/ranium/fixerio-php-client) [ ![License](https://camo.githubusercontent.com/b31a56e13060cd2f43676493eeccbf1642fbf394c58cf8f20f0eb35ad32232f6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f72616e69756d2f6669786572696f2d7068702d636c69656e74) ](https://packagist.org/packages/ranium/fixerio-php-client)

Fixer.io PHP Client
===================

[](#fixerio-php-client)

Provides an easy to use client for [fixer.io](https://fixer.io) exchange rates and currency conversion JSON API.

*Looking for a Laravel package? Please use [ranium/laravel-fixerio](https://github.com/ranium/laravel-fixerio) instead of this library.*

Installation
------------

[](#installation)

This project can be installed using Composer:

`composer require ranium/fixerio-php-client`

Usage
-----

[](#usage)

This package uses's [Guzzle's Service Description](https://github.com/guzzle/guzzle-services) to make HTTP Requests to the fixer.io API.

To use this package in your application, simply use the package and instantiate the client as follows

```
use Ranium\Fixerio\Client;

$accessKey = '12345678901234567890';
$secure = true; // Optional, default is true (only paid plans of fixer.io supports SSL)
$config = []; // Optional, guzzle command client config that you might want to pass

$fixerio = Client::create($accessKey, $secure, $config);
```

Here's how you can access the fixer.io's endpoints:

*Note: `access_key` parameter is sent by default in all requests so no need to pass it in the argument while calling methods. However, you can include it should you want to override the access key used while instantiating the fixerio client.*

### [Latest rates endpoint](https://fixer.io/documentation#latestrates)

[](#latest-rates-endpoint)

```
$latestRates = $fixerio->latest(
    [
        'base' => 'USD', // optional
        'symbols' => 'INR', // optional
    ]
);

// Display the INR rates
echo $latestRates['rates']['INR'];
```

### [Historical rates endpoint](https://fixer.io/documentation#historicalrates)

[](#historical-rates-endpoint)

```
$historicalRates = $fixerio->historical(
    [
        'date' => '2019-01-01',
        'base' => 'USD', // optional
        'symbols' => 'INR', //optional
    ]
);

// Display the INR rates
echo $latestRates['rates']['INR'];
```

### [Convert endpoint](https://fixer.io/documentation#convertcurrency)

[](#convert-endpoint)

```
$convertedRates = $fixerio->convert(
    [
        'from' => 'USD',
        'to' => 'INR',
        'amount' => 50.75,
        'date' => '2019-01-01', //optional
    ]
);

// Display the converted amount
echo $convertedRates['result'];
```

### [Time-Series data endpoint](https://fixer.io/documentation#timeseries)

[](#time-series-data-endpoint)

```
$timeseriesData = $fixerio->timeseries(
    [
        'start_date' => '2019-01-01',
        'end_date' => '2019-01-05',
        'base' => 'USD', // optional
        'symbols' => 'INR', //optional
    ]
);

// Display the INR rate for 2019-01-02
echo $timeseriesData['rates']['2019-01-02']['INR'];
```

### [Fluctuation data endpoint](https://fixer.io/documentation#timeseries)

[](#fluctuation-data-endpoint)

```
$fluctuationData = $fixerio->fluctuation(
    [
        'start_date' => '2019-01-01',
        'end_date' => '2019-01-05',
        'base' => 'USD', // optional
        'symbols' => 'INR', //optional
    ]
);

// Display the change/fluctuation amount of INR between the given date range
echo $fluctuationData['rates']['INR']['change'];
```

The response for all the above calls will be a JSON object. Please refer fixer.io's [documentation](https://fixer.io/documentation) for further details about various endpoints, request parameters and response objects.

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity34

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~175 days

Total

5

Last Release

2006d ago

Major Versions

v0.0.1 → v1.0.02019-02-05

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1827901?v=4)[Ranium Systems](/maintainers/ranium)[@ranium](https://github.com/ranium)

---

Top Contributors

[![abbasali](https://avatars.githubusercontent.com/u/145739?v=4)](https://github.com/abbasali "abbasali (4 commits)")[![abhishek-ranium](https://avatars.githubusercontent.com/u/45379749?v=4)](https://github.com/abhishek-ranium "abhishek-ranium (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ranium-fixerio-php-client/health.svg)

```
[![Health](https://phpackages.com/badges/ranium-fixerio-php-client/health.svg)](https://phpackages.com/packages/ranium-fixerio-php-client)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[avalara/avataxclient

Client library for Avalara's AvaTax suite of business tax calculation and processing services. Uses the REST v2 API.

528.5M7](/packages/avalara-avataxclient)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[files.com/files-php-sdk

Files.com PHP SDK

2481.1k](/packages/filescom-files-php-sdk)[aimeos/prisma

A powerful PHP package for integrating media related Large Language Models (LLMs) into your applications

1943.1k5](/packages/aimeos-prisma)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)