docs: list unirate_api in provider tables#155
Merged
Conversation
Exchanger merged UniRateAPI support in florianv/exchanger#180. Swap auto-inherits provider services from Exchanger's Registry, so `->add('unirate_api', ['api_key' => getenv('UNIRATE_API_KEY')])` already works on master; only the docs were missing. - README.md: add row to commercial providers table (alphabetical position between `open_exchange_rates` and `webservicex`); bump provider counts 30 → 31 in tagline, providers section, and the Exchanger sibling-package line. - doc/readme.md: add `unirate_api` / `api_key` row to the commercial config table. UniRateAPI is a commercial REST API for FX (latest rates on the free tier; historical and commodities on the paid tier — same shape as the other paid providers in the table).
There was a problem hiding this comment.
Pull request overview
Updates Swap’s documentation to include the newly added UniRateAPI provider (registered upstream in Exchanger as unirate_api) and to reflect an updated total provider count.
Changes:
- Add UniRateAPI (
unirate_api) to the README commercial providers table. - Add
unirate_api/api_keyto the provider configuration reference indoc/readme.md. - Update several README references from “30 providers” to “31 providers”.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| README.md | Adds UniRateAPI to the commercial providers list and updates stated provider counts. |
| doc/readme.md | Documents unirate_api configuration (api_key) in the commercial provider options table. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| [](https://packagist.org/packages/florianv/swap) | ||
|
|
||
| > _The easy-to-use PHP currency conversion library. Retrieve exchange rates from 30 providers, with caching and fallback. Maintained since 2014._ | ||
| > _The easy-to-use PHP currency conversion library. Retrieve exchange rates from 31 providers, with caching and fallback. Maintained since 2014._ |
| ## 📊 Providers | ||
|
|
||
| Swap supports 30 exchange rate providers. Pass the **identifier** to `Builder::add()`. | ||
| Swap supports 31 exchange rate providers. Pass the **identifier** to `Builder::add()`. |
|
|
||
| - [**Swap**](https://github.com/florianv/swap). The easy-to-use, high-level API (this package). | ||
| - [**Exchanger**](https://github.com/florianv/exchanger). Lower-level, more granular alternative; direct access to the 30 provider implementations and the `ExchangeRateService` interface. | ||
| - [**Exchanger**](https://github.com/florianv/exchanger). Lower-level, more granular alternative; direct access to the 31 provider implementations and the `ExchangeRateService` interface. |
Contributor
Author
|
Quick note on the Copilot suggestions about the The Exchanger PR that adds UniRateAPI (florianv/exchanger#180) merged 2026-05-18, but the most recent tagged Exchanger release (2.9.1, 2026-05-14) was before that, so packagist installs of Happy with either path here, whichever you prefer:
No pending changes on my end otherwise — just let me know. (Disclosure unchanged: I work on UniRateAPI, raised in the PR body.) |
alies-dev
approved these changes
Jun 17, 2026
alies-dev
left a comment
alies-dev
left a comment
Collaborator
There was a problem hiding this comment.
thanks @rob-browncc for your contribution. I'd create a new PR to word it as 30+, so we'll not have these annoying edits.
alies-dev
pushed a commit
to florianv/laravel-swap
that referenced
this pull request
Jun 17, 2026
Exchanger merged UniRateAPI support in florianv/exchanger#180 and Swap's docs PR is florianv/swap#155. Laravel Swap auto-inherits the underlying Swap service list, so `'unirate_api' => ['api_key' => env(...)]` already works on master once the next Exchanger release tag lands; only the docs and the published config stub were missing. - config/swap.php: add `unirate_api` to the in-file docblock spec list (after `xchangeapi`) and add a commented-out example line to the `services` array next to the other commercial providers, mirroring the existing `apilayer_fixer` / `open_exchange_rates` examples. - README.md: add `UniRateAPI` row to the commercial provider table (alphabetical, between `open_exchange_rates` and `webservicex`); bump count 30 → 31. - doc/readme.md: add `unirate_api` / `api_key` row to the commercial configuration table. UniRateAPI is a commercial REST API for FX. Latest rates are on the free tier; historical and commodities are paid-tier only — the upstream `Exchanger\Service\UniRateApi` maps HTTP 403 on those endpoints to `Exchanger\Exception\ChainException`, matching the existing fastFOREX / Fixer plan-gated behaviour.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds UniRateAPI to the documented provider lists, following florianv/exchanger#180 which landed the
UniRateApiservice and registered it under the identifierunirate_apiinExchanger\Service\Registry.Swap\Service\Registryalready pulls every entry fromExchangerRegistry::getServices(), so once Exchanger ships its next tagged release this is usable on master as-is:This PR only updates the docs.
Changes
UniRateAPIrow to the commercial provider table, alphabetical betweenopen_exchange_ratesandwebservicex; bumps the provider count30 → 31in three places (tagline, Providers section, sibling-package line for Exchanger).unirate_api/api_keyto the commercial provider configuration table.Notes
unirate_apimatches the key used in Exchanger'sRegistry::getServices()after #180./api/historical) and commodities are paid-tier only — the upstreamUniRateApi.phpmaps HTTP 403 from those endpoints toExchanger\Exception\ChainException, matching the existing fastFOREX / Fixer behaviour for plan-gated endpoints.Disclosure
I work with UniRateAPI. The implementation work (Exchanger #180) was done first; opening this docs PR now that the merge has landed so users can discover the provider through the standard table without needing to read the changelog. Happy to revise the wording or drop the count bump if you'd rather hold the count fixed until the next Exchanger release tag.