PHP — Cotação de Moedas Diversas

Olá Gente!


Obter a cotação de moedas é algo que deveria ser super simples, mas encontrar uma API boa e gratuita é complicado.


Para isto, iremos utilizar a API:

ExchangeRate-API - Free & Pro Currency Converter API
Accurate & reliable Exchange Rates API trusted by tens of thousands of developers since 2010. Free access, all world currencies, helpful support & easy to integrate JSON API.

Esta API permite que você faça até 1500 requisições por mês de forma gratuita.

Com isto, basta consulta algumas vezes por dia e deixar em cache.


Antes de tudo, precisamos criar uma API KEY, para isto, faça seu cadastro abaixo:

ExchangeRate-API - Free Plan Sign Up
Get an ExchangeRate-API account for free & instant access to our foreign exchange rates API.

Sua API KEY será exibida ao lado de “Your API Key”:


Antes de obtermos a cotação de uma moeda, precisamos checar quais as moedas que eles tem cotação, para isto, acesse:

ExchangeRate-API - Supported Currency Codes and Countries
Our API supports 160 currencies used by nearly every country in the world. This list of currency codes will help get you started!

Em nosso exemplo, iremos buscar a cotação do DÓLAR, que possui sigla USD.


Para obtermos os dados deste moeda, iremos fazer uma GET para:

https://v6.exchangerate-api.com/v6/[API_KEY]/latest/[MOEDA]


Observe que aqui, precisamos preencher:

- API_KEY: Sua API KEY gerada no painel da Exchange
- MOEDA: A Sigla da moeda que verificamos na lista de moedas suportadas


Exemplo:


Será retornado um array com os dados da Moeda:


A informação mais importante aqui esta no elemento “conversion_rates” onde consta a cotação do DÓLAR para várias outras moedas.


Neste caso, para REAL, iremos buscar o elemento “BRL”:

{
“BRL”:4.9122
}


Você pode também, fazer uma busca de conversão direta, ou seja “Quanto é 1 dólar para 1 real”, para isto, iremos faer uma GET para:

https://v6.exchangerate-api.com/v6/[API_KEY]/pair/[MOEDA_ORIGEM]/[MOEDA_DESTINO]


Observe que aqui, precisamos preencher:

- API_KEY: Sua API KEY gerada no painel da Exchange
- MOEDA_ORIGEM: A moeda de origem, neste exemplo, “USD”
- MOEDA_DESTINO: A moeda de destino, neste caso, “BRL”


Exemplo:


Será retornado um array onde o valor da conversão esta em “conversion_rate”:


Neste caso:

{
“conversion_rate”: 4.9122
}


Por hoje é isto, queridos desenvolvedores! 👩‍💼
Até logo! 👋