Endpoint para retornar a cotação atualizada

O endpoint https://api.starkbank.com/v2/currency retorna a cotação mais recente (PTAX) para cada moeda suportada. A cotação é atualizada diariamente com base no valor fornecido pela Mastercard, que serve como referência para conversões de moeda.

A moeda de referência utilizada é sempre o dólar (USD). Todas as demais moedas, incluindo BRL e EUR, são calculadas em relação ao dólar.

Observação importante:
O valor retornado pela API é utilizado como base para cálculos de conversão. Porém, o valor efetivamente considerado é aquele presente no momento em que recebemos o arquivo de clearing da Mastercard com o status confirmed da transação.

Requisição

GET https://api.starkbank.com/v2/currency

Não é necessário enviar parâmetros adicionais.

Resposta

A resposta contém uma lista de moedas com suas respectivas cotações em relação ao dólar (USD).

Exemplo de resposta

{
 "currencies": [
   {
     "code": "BRL",
     "created": "2021-09-09T12:15:52.817414+00:00",
     "digits": 2,
     "name": "Brazilian Real",
     "number": "986",
     "rate": 5.25275,
     "symbol": "R$",
     "updated": "2021-09-09T12:17:14.492251+00:00"
   },
   {
     "code": "USD",
     "created": "2021-09-09T12:15:52.182000+00:00",
     "digits": 2,
     "name": "US Dollar",
     "number": "840",
     "rate": 1.0,
     "symbol": "US$",
     "updated": "2021-09-09T12:17:14.488000+00:00"
   },
   {
     "code": "EUR",
     "created": "2021-09-09T12:15:52.081691+00:00",
     "digits": 2,
     "name": "Euro",
     "number": "978",
     "rate": 0.845492,
     "symbol": "€",
     "updated": "2021-09-09T12:17:14.491910+00:00"
   }
 ]
}

Campos retornados

Campo	Tipo	Descrição
code	string	Código da moeda conforme ISO 4217 (ex: BRL, USD, EUR).
name	string	Nome da moeda.
number	string	Código numérico da moeda conforme ISO 4217.
symbol	string	Símbolo da moeda.
rate	decimal	Taxa de câmbio em relação ao USD.
digits	integer	Número de casas decimais utilizado para a moeda.
created	datetime	Data e hora em que o registro foi criado.
updated	datetime	Data e hora da última atualização da cotação.

Notas finais

• As cotações são fornecidas diariamente pela Mastercard.
• Os valores podem variar até o momento de clearing, quando o valor definitivo da transação é confirmado.

Se ainda restarem dúvidas, nosso time de suporte está à disposição para ajudar!