Taxas de câmbio ao vivo

GET

live

curl --request GET \
  --url https://exchange-rates.cleariflow.com/v1/live

import requests

url = "https://exchange-rates.cleariflow.com/v1/live"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://exchange-rates.cleariflow.com/v1/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://exchange-rates.cleariflow.com/v1/live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://exchange-rates.cleariflow.com/v1/live"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://exchange-rates.cleariflow.com/v1/live")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://exchange-rates.cleariflow.com/v1/live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
    "base": "EUR",
    "last_updated": 1755806612,
    "exchange_rates": {
        "AED": 4.26365,
        "AFN": 79.371761,
        "ALL": 96.766559,
        "AMD": 444.303396,
        "ANG": 2.07788,
        "AOA": 1064.607378,
        "ARS": 1526.092012,
        "AUD": 1.806504,
        "AWG": 2.091193,
        "AZN": 1.972485,
        "BAM": 1.94832,
        "BBD": 2.337356,
        "BDT": 141.197895,
        "BGN": 1.955876,
        "BHD": 0.437742,
        "BIF": 3441.108157,
        "BMD": 1.160968,
        "BND": 1.493687,
        "BOB": 8.019865,
        "BRL": 6.358386,
        "BSD": 1.160489,
        "BTC": 0.000010310136,
        "BTN": 101.21369,
        "BWP": 15.615325,
        "BYN": 3.908315,
        "BYR": 22754.966223,
        "BZD": 2.328351,
        "CAD": 1.613524,
        "CDF": 3326.172282,
        "CHF": 0.939106,
        "CLF": 0.028737,
        "CLP": 1127.358136,
        "CNH": 8.340287,
        "CNY": 8.336214,
        "COP": 4685.375252,
        "CRC": 585.59961,
        "CUC": 1.160968,
        "CUP": 30.765643,
        "CVE": 110.675173,
        "CZK": 24.576564,
        "DJF": 206.327505,
        "DKK": 7.464964,
        "DOP": 72.415347,
        "DZD": 150.838676,
        "EGP": 56.298231,
        "ERN": 17.414515,
        "ETB": 164.622148,
        "FJD": 2.639866,
        "FKP": 0.863167,
        "GBP": 0.865164,
        "GEL": 3.128807,
        "GGP": 0.863167,
        "GHS": 12.776446,
        "GIP": 0.863167,
        "GMD": 83.589605,
        "GNF": 10075.458774,
        "GTQ": 8.898796,
        "GYD": 242.80765,
        "HKD": 9.071975,
        "HNL": 30.525752,
        "HRK": 7.533057,
        "HTG": 151.846358,
        "HUF": 396.377133,
        "IDR": 18982.924233,
        "ILS": 3.959365,
        "IMP": 0.863167,
        "INR": 101.308333,
        "IQD": 1520.86764,
        "IRR": 48818.690683,
        "ISK": 143.390958,
        "JEP": 0.863167,
        "JMD": 186.50395,
        "JOD": 0.823108,
        "JPY": 172.202267,
        "KES": 150.348297,
        "KGS": 101.524282,
        "KHR": 4649.676029,
        "KMF": 490.514729,
        "KPW": 1044.880197,
        "KRW": 1626.556298,
        "KWD": 0.355128,
        "KYD": 0.967166,
        "KZT": 623.825974,
        "LAK": 25076.901249,
        "LBP": 103970.458898,
        "LKR": 350.343584,
        "LRD": 234.370341,
        "LSL": 20.51426,
        "LTL": 3.428035,
        "LVL": 0.702258,
        "LYD": 6.298234,
        "MAD": 10.472154,
        "MDL": 19.538584,
        "MGA": 5148.891487,
        "MKD": 61.564837,
        "MMK": 2436.793158,
        "MNT": 4174.925262,
        "MOP": 9.340105,
        "MRU": 46.403613,
        "MUR": 53.102389,
        "MVR": 17.890252,
        "MWK": 2016.019751,
        "MXN": 21.783335,
        "MYR": 4.904511,
        "MZN": 74.189833,
        "NAD": 20.51403,
        "NGN": 1784.279885,
        "NIO": 42.724297,
        "NOK": 11.816444,
        "NPR": 161.941505,
        "NZD": 1.994252,
        "OMR": 0.446385,
        "PAB": 1.160539,
        "PEN": 4.074746,
        "PGK": 4.810464,
        "PHP": 66.382391,
        "PKR": 327.334442,
        "PLN": 4.256788,
        "PYG": 8385.912082,
        "QAR": 4.226793,
        "RON": 5.053583,
        "RSD": 117.178773,
        "RUB": 93.545406,
        "RWF": 1677.598275,
        "SAR": 4.356784,
        "SBD": 9.543586,
        "SCR": 17.083033,
        "SDG": 697.172079,
        "SEK": 11.169246,
        "SGD": 1.496253,
        "SHP": 0.912338,
        "SLE": 27.052052,
        "SLL": 24344.909083,
        "SOS": 663.494948,
        "SRD": 44.093416,
        "STD": 24029.68667,
        "STN": 24.78666,
        "SVC": 10.15419,
        "SYP": 15094.850487,
        "SZL": 20.51423,
        "THB": 37.921835,
        "TJS": 10.909308,
        "TMT": 4.063387,
        "TND": 3.356326,
        "TOP": 2.719101,
        "TRY": 47.525837,
        "TTD": 7.864449,
        "TWD": 35.421552,
        "TZS": 2891.836946,
        "UAH": 47.809567,
        "UGX": 4137.187253,
        "USD": 1.160968,
        "UYU": 46.661654,
        "UZS": 14512.095553,
        "VES": 160.163499,
        "VND": 30687.277791,
        "VUV": 139.211829,
        "WST": 3.1432,
        "XAF": 653.501468,
        "XAG": 0.030479,
        "XAU": 0.000348,
        "XCD": 3.137573,
        "XCG": 2.091641,
        "XDR": 0.812147,
        "XOF": 652.464211,
        "XPF": 119.331742,
        "YER": 278.86379,
        "ZAR": 20.58816,
        "ZMK": 10450.103649,
        "ZMW": 26.838156,
        "ZWL": 373.831114
    }
}

Primeiros passos

URL base

https://exchange-rates.cleariflow.com/v1/live

Endpoint de validação

Quando nenhuma moeda de destino é especificada, o endpoint devolve taxas para todas as moedas disponíveis. Explore a lista completa de moedas suportadas aqui.

https://exchange-rates.cleariflow.com/v1/live
? api_key = YOUR_UNIQUE_API_KEY
& base = USD

Este pedido bem-sucedido devolve taxas de câmbio para todas as moedas disponíveis relativamente à moeda base:

{
    "base": "EUR",
    "last_updated": 1755806612,
    "exchange_rates": {
        "AED": 4.26365,
        "AFN": 79.371761,
        "ALL": 96.766559,
        "AMD": 444.303396,
        "ANG": 2.07788,
        "AOA": 1064.607378,
        "ARS": 1526.092012,
        "AUD": 1.806504,
        "AWG": 2.091193,
        "AZN": 1.972485,
        "BAM": 1.94832,
        "BBD": 2.337356,
        "BDT": 141.197895,
        "BGN": 1.955876,
        "BHD": 0.437742,
        "BIF": 3441.108157,
        "BMD": 1.160968,
        "BND": 1.493687,
        "BOB": 8.019865,
        "BRL": 6.358386,
        "BSD": 1.160489,
        "BTC": 0.000010310136,
        "BTN": 101.21369,
        "BWP": 15.615325,
        "BYN": 3.908315,
        "BYR": 22754.966223,
        "BZD": 2.328351,
        "CAD": 1.613524,
        "CDF": 3326.172282,
        "CHF": 0.939106,
        "CLF": 0.028737,
        "CLP": 1127.358136,
        "CNH": 8.340287,
        "CNY": 8.336214,
        "COP": 4685.375252,
        "CRC": 585.59961,
        "CUC": 1.160968,
        "CUP": 30.765643,
        "CVE": 110.675173,
        "CZK": 24.576564,
        "DJF": 206.327505,
        "DKK": 7.464964,
        "DOP": 72.415347,
        "DZD": 150.838676,
        "EGP": 56.298231,
        "ERN": 17.414515,
        "ETB": 164.622148,
        "FJD": 2.639866,
        "FKP": 0.863167,
        "GBP": 0.865164,
        "GEL": 3.128807,
        "GGP": 0.863167,
        "GHS": 12.776446,
        "GIP": 0.863167,
        "GMD": 83.589605,
        "GNF": 10075.458774,
        "GTQ": 8.898796,
        "GYD": 242.80765,
        "HKD": 9.071975,
        "HNL": 30.525752,
        "HRK": 7.533057,
        "HTG": 151.846358,
        "HUF": 396.377133,
        "IDR": 18982.924233,
        "ILS": 3.959365,
        "IMP": 0.863167,
        "INR": 101.308333,
        "IQD": 1520.86764,
        "IRR": 48818.690683,
        "ISK": 143.390958,
        "JEP": 0.863167,
        "JMD": 186.50395,
        "JOD": 0.823108,
        "JPY": 172.202267,
        "KES": 150.348297,
        "KGS": 101.524282,
        "KHR": 4649.676029,
        "KMF": 490.514729,
        "KPW": 1044.880197,
        "KRW": 1626.556298,
        "KWD": 0.355128,
        "KYD": 0.967166,
        "KZT": 623.825974,
        "LAK": 25076.901249,
        "LBP": 103970.458898,
        "LKR": 350.343584,
        "LRD": 234.370341,
        "LSL": 20.51426,
        "LTL": 3.428035,
        "LVL": 0.702258,
        "LYD": 6.298234,
        "MAD": 10.472154,
        "MDL": 19.538584,
        "MGA": 5148.891487,
        "MKD": 61.564837,
        "MMK": 2436.793158,
        "MNT": 4174.925262,
        "MOP": 9.340105,
        "MRU": 46.403613,
        "MUR": 53.102389,
        "MVR": 17.890252,
        "MWK": 2016.019751,
        "MXN": 21.783335,
        "MYR": 4.904511,
        "MZN": 74.189833,
        "NAD": 20.51403,
        "NGN": 1784.279885,
        "NIO": 42.724297,
        "NOK": 11.816444,
        "NPR": 161.941505,
        "NZD": 1.994252,
        "OMR": 0.446385,
        "PAB": 1.160539,
        "PEN": 4.074746,
        "PGK": 4.810464,
        "PHP": 66.382391,
        "PKR": 327.334442,
        "PLN": 4.256788,
        "PYG": 8385.912082,
        "QAR": 4.226793,
        "RON": 5.053583,
        "RSD": 117.178773,
        "RUB": 93.545406,
        "RWF": 1677.598275,
        "SAR": 4.356784,
        "SBD": 9.543586,
        "SCR": 17.083033,
        "SDG": 697.172079,
        "SEK": 11.169246,
        "SGD": 1.496253,
        "SHP": 0.912338,
        "SLE": 27.052052,
        "SLL": 24344.909083,
        "SOS": 663.494948,
        "SRD": 44.093416,
        "STD": 24029.68667,
        "STN": 24.78666,
        "SVC": 10.15419,
        "SYP": 15094.850487,
        "SZL": 20.51423,
        "THB": 37.921835,
        "TJS": 10.909308,
        "TMT": 4.063387,
        "TND": 3.356326,
        "TOP": 2.719101,
        "TRY": 47.525837,
        "TTD": 7.864449,
        "TWD": 35.421552,
        "TZS": 2891.836946,
        "UAH": 47.809567,
        "UGX": 4137.187253,
        "USD": 1.160968,
        "UYU": 46.661654,
        "UZS": 14512.095553,
        "VES": 160.163499,
        "VND": 30687.277791,
        "VUV": 139.211829,
        "WST": 3.1432,
        "XAF": 653.501468,
        "XAG": 0.030479,
        "XAU": 0.000348,
        "XCD": 3.137573,
        "XCG": 2.091641,
        "XDR": 0.812147,
        "XOF": 652.464211,
        "XPF": 119.331742,
        "YER": 278.86379,
        "ZAR": 20.58816,
        "ZMK": 10450.103649,
        "ZMW": 26.838156,
        "ZWL": 373.831114
    }
}

Parâmetros de pedido

api_key

String

obrigatório

A sua chave API única. Note que cada utilizador tem chaves API únicas para cada uma das APIs Cleariflow — a sua chave da API de taxas de câmbio não funcionará para a API de geolocalização IP, por exemplo.

base

String

obrigatório

A moeda base utilizada para obter a(s) taxa(s) de câmbio mais recente(s). Utiliza o padrão de moeda ISO 4217 (por exemplo, USD para dólares americanos), como todos os parâmetros de moeda nesta API.

target

String

A moeda ou moedas de destino para obter a taxa de câmbio face à moeda base. Como os parâmetros base, qualquer moeda passada aqui segue o padrão ISO 4217. Se forem passadas várias moedas no target, devem ser separadas por vírgulas (por exemplo, &target=EUR,CAD,AUD).

Parâmetros de resposta

A resposta da API é devolvida num formato JSON universal e leve.

base

String

A moeda base utilizada para obter as taxas de câmbio.

last_updated

Integer

O timestamp Unix de quando os dados devolvidos foram atualizados pela última vez.

exchange_rates

Object

Um objeto JSON em que cada moeda de destino é a chave e a sua taxa de câmbio face à moeda base é o valor dessa chave.

Conversão de moedaO endpoint `convert` converte montantes específicos entre moedas com taxas de câmbio em tempo real — ideal para cálculos financeiros e processamento de pagamentos.

Taxas de câmbio ao vivo

curl --request GET \
  --url https://exchange-rates.cleariflow.com/v1/live

import requests

url = "https://exchange-rates.cleariflow.com/v1/live"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://exchange-rates.cleariflow.com/v1/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://exchange-rates.cleariflow.com/v1/live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://exchange-rates.cleariflow.com/v1/live"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://exchange-rates.cleariflow.com/v1/live")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://exchange-rates.cleariflow.com/v1/live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
    "base": "EUR",
    "last_updated": 1755806612,
    "exchange_rates": {
        "AED": 4.26365,
        "AFN": 79.371761,
        "ALL": 96.766559,
        "AMD": 444.303396,
        "ANG": 2.07788,
        "AOA": 1064.607378,
        "ARS": 1526.092012,
        "AUD": 1.806504,
        "AWG": 2.091193,
        "AZN": 1.972485,
        "BAM": 1.94832,
        "BBD": 2.337356,
        "BDT": 141.197895,
        "BGN": 1.955876,
        "BHD": 0.437742,
        "BIF": 3441.108157,
        "BMD": 1.160968,
        "BND": 1.493687,
        "BOB": 8.019865,
        "BRL": 6.358386,
        "BSD": 1.160489,
        "BTC": 0.000010310136,
        "BTN": 101.21369,
        "BWP": 15.615325,
        "BYN": 3.908315,
        "BYR": 22754.966223,
        "BZD": 2.328351,
        "CAD": 1.613524,
        "CDF": 3326.172282,
        "CHF": 0.939106,
        "CLF": 0.028737,
        "CLP": 1127.358136,
        "CNH": 8.340287,
        "CNY": 8.336214,
        "COP": 4685.375252,
        "CRC": 585.59961,
        "CUC": 1.160968,
        "CUP": 30.765643,
        "CVE": 110.675173,
        "CZK": 24.576564,
        "DJF": 206.327505,
        "DKK": 7.464964,
        "DOP": 72.415347,
        "DZD": 150.838676,
        "EGP": 56.298231,
        "ERN": 17.414515,
        "ETB": 164.622148,
        "FJD": 2.639866,
        "FKP": 0.863167,
        "GBP": 0.865164,
        "GEL": 3.128807,
        "GGP": 0.863167,
        "GHS": 12.776446,
        "GIP": 0.863167,
        "GMD": 83.589605,
        "GNF": 10075.458774,
        "GTQ": 8.898796,
        "GYD": 242.80765,
        "HKD": 9.071975,
        "HNL": 30.525752,
        "HRK": 7.533057,
        "HTG": 151.846358,
        "HUF": 396.377133,
        "IDR": 18982.924233,
        "ILS": 3.959365,
        "IMP": 0.863167,
        "INR": 101.308333,
        "IQD": 1520.86764,
        "IRR": 48818.690683,
        "ISK": 143.390958,
        "JEP": 0.863167,
        "JMD": 186.50395,
        "JOD": 0.823108,
        "JPY": 172.202267,
        "KES": 150.348297,
        "KGS": 101.524282,
        "KHR": 4649.676029,
        "KMF": 490.514729,
        "KPW": 1044.880197,
        "KRW": 1626.556298,
        "KWD": 0.355128,
        "KYD": 0.967166,
        "KZT": 623.825974,
        "LAK": 25076.901249,
        "LBP": 103970.458898,
        "LKR": 350.343584,
        "LRD": 234.370341,
        "LSL": 20.51426,
        "LTL": 3.428035,
        "LVL": 0.702258,
        "LYD": 6.298234,
        "MAD": 10.472154,
        "MDL": 19.538584,
        "MGA": 5148.891487,
        "MKD": 61.564837,
        "MMK": 2436.793158,
        "MNT": 4174.925262,
        "MOP": 9.340105,
        "MRU": 46.403613,
        "MUR": 53.102389,
        "MVR": 17.890252,
        "MWK": 2016.019751,
        "MXN": 21.783335,
        "MYR": 4.904511,
        "MZN": 74.189833,
        "NAD": 20.51403,
        "NGN": 1784.279885,
        "NIO": 42.724297,
        "NOK": 11.816444,
        "NPR": 161.941505,
        "NZD": 1.994252,
        "OMR": 0.446385,
        "PAB": 1.160539,
        "PEN": 4.074746,
        "PGK": 4.810464,
        "PHP": 66.382391,
        "PKR": 327.334442,
        "PLN": 4.256788,
        "PYG": 8385.912082,
        "QAR": 4.226793,
        "RON": 5.053583,
        "RSD": 117.178773,
        "RUB": 93.545406,
        "RWF": 1677.598275,
        "SAR": 4.356784,
        "SBD": 9.543586,
        "SCR": 17.083033,
        "SDG": 697.172079,
        "SEK": 11.169246,
        "SGD": 1.496253,
        "SHP": 0.912338,
        "SLE": 27.052052,
        "SLL": 24344.909083,
        "SOS": 663.494948,
        "SRD": 44.093416,
        "STD": 24029.68667,
        "STN": 24.78666,
        "SVC": 10.15419,
        "SYP": 15094.850487,
        "SZL": 20.51423,
        "THB": 37.921835,
        "TJS": 10.909308,
        "TMT": 4.063387,
        "TND": 3.356326,
        "TOP": 2.719101,
        "TRY": 47.525837,
        "TTD": 7.864449,
        "TWD": 35.421552,
        "TZS": 2891.836946,
        "UAH": 47.809567,
        "UGX": 4137.187253,
        "USD": 1.160968,
        "UYU": 46.661654,
        "UZS": 14512.095553,
        "VES": 160.163499,
        "VND": 30687.277791,
        "VUV": 139.211829,
        "WST": 3.1432,
        "XAF": 653.501468,
        "XAG": 0.030479,
        "XAU": 0.000348,
        "XCD": 3.137573,
        "XCG": 2.091641,
        "XDR": 0.812147,
        "XOF": 652.464211,
        "XPF": 119.331742,
        "YER": 278.86379,
        "ZAR": 20.58816,
        "ZMK": 10450.103649,
        "ZMW": 26.838156,
        "ZWL": 373.831114
    }
}

Validação

Consulta

Criação

Primeiros passos

URL base

Endpoint de validação

Parâmetros de pedido

Parâmetros de resposta

​Primeiros passos

​URL base

​Endpoint de validação

​Parâmetros de pedido

​Parâmetros de resposta

Primeiros passos

URL base

Endpoint de validação

Parâmetros de pedido

Parâmetros de resposta