Conversión de tipos de cambio

GET

convert

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://exchange-rates.cleariflow.com/v1/convert",
  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/convert"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

Primeros pasos

URL base

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

Endpoint de validación

El endpoint convert requiere su clave API, una divisa base y un parámetro target para realizar conversiones de divisas.

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

Esta solicitud exitosa convierte 1 EUR a USD utilizando el tipo de cambio más actual:

{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

Parámetros de solicitud

String

requerido

Su clave API única. Tenga en cuenta que cada usuario tiene claves API únicas para cada una de las APIs de Cleariflow, por lo que su clave de la API de tipos de cambio no funcionará para su API de geolocalización IP, por ejemplo.

String

requerido

La divisa base utilizada para obtener el o los tipos de cambio más recientes. Utiliza el estándar de divisas ISO 4217 (p. ej., USD para dólares estadounidenses), como todos los parámetros de divisa en esta API.

String

requerido

La divisa o divisas de destino para obtener el tipo de cambio respecto a la divisa base. Al igual que el parámetro base, cualquier divisa enviada aquí sigue el estándar ISO 4217. Tenga en cuenta que, a diferencia de los otros endpoints, convert solo acepta una divisa de destino a la vez.

String

La fecha histórica de la que desea obtener los tipos, en formato YYYY-MM-DD. Si deja este campo en blanco, se utilizarán los tipos más recientes disponibles.

Float

El importe de la divisa base que desea convertir a la divisa de destino.

Parámetros de respuesta

La respuesta de la API se devuelve en un formato JSON universal y ligero.

String

La divisa base utilizada para obtener los tipos de cambio.

String

La divisa de destino a la que se convirtió base_amount.

String

La fecha de la que se obtuvieron las divisas, según la solicitud exitosa.

Float

El importe de la divisa base de la solicitud.

Float

El importe de la divisa de destino al que se ha convertido base_amount.

Float

El tipo de cambio utilizado para convertir base_amount de la divisa base a la divisa de destino.

Conversión de tipos de cambio

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://exchange-rates.cleariflow.com/v1/convert",
  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/convert"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

Validación

Consulta

Creación

Conversión de tipos de cambio

Primeros pasos

URL base

Endpoint de validación

Parámetros de solicitud

Parámetros de respuesta

​Primeros pasos

​URL base

​Endpoint de validación

​Parámetros de solicitud

​Parámetros de respuesta

Primeros pasos

URL base

Endpoint de validación

Parámetros de solicitud

Parámetros de respuesta