Forex API

Una API RESTful simple que permite consultar y convertir tasas de cambio actualizadas de múltiples proveedores.

Endpoints de la API

La API acepta solicitudes mediante GET y POST (parámetros form-data o JSON puro). Todas las respuestas son en formato JSON.

1. Obtener Tasa de Cambio (`/get`)

Obtiene la tasa actual para la moneda especificada (con actualización cada hora).

Parámetros:

currency (requerido): Código ISO 4217 de 3 letras de la moneda destino (ej. EUR, MXN).

base (opcional): Código de 3 letras de la moneda base. Por defecto es USD.

Ejemplo de respuesta:

json

{

    "endpoint": "/get",

    "base": {

        "code": "USD",

        "name_en": "United States Dollar",

        "name_es": "Dólar estadounidense"

    },

    "currency": {

        "code": "MXN",

        "name_en": "Mexican Peso",

        "name_es": "Peso mexicano"

    },

    "rate": 18.50,

    "timestamp": 1710500000

}

2. Convertir Cantidad (`/convert`)

Parámetros:

currency (requerido): Código ISO 4217 de 3 letras de la moneda destino.

base (requerido): Código ISO 4217 de 3 letras de la moneda base.

amount (requerido): Cantidad numérica a convertir.

Ejemplo de respuesta:

json

{

    "endpoint": "/convert",

    "base": {

        "code": "EUR",

        "name_en": "Euro",

        "name_es": "Euro"

    },

    "currency": {

        "code": "MXN",

        "name_en": "Mexican Peso",

        "name_es": "Peso mexicano"

    },

    "rate": 20.05,

    "timestamp": 1710500000,

    "query_amount": 100,

    "converted_amount": 2005.00

}

Ejemplos de Uso

cURL

bash

# Ejemplo GET curl -s "https://api.latinapi.com/api/forex/get?currency=EUR"

# Ejemplo POST para /convert curl -X POST "https://api.latinapi.com/api/forex/convert" \ -H "Content-Type: application/json" \ -H "X-Api-Key: TU_LLAVE_PRIVADA_API" \ -d '{"currency": "MXN", "base": "EUR", "amount": 150}'

PHP

php

<?php
$data = ['currency' => 'MXN', 'base' => 'EUR', 'amount' => 150];

$options = [

    'http' => [

        'method'  => 'POST',

        'header'  => ['Content-Type: application/json','X-Api-Key: TU_LLAVE_PRIVADA_API'],

        'content' => json_encode($data)

    ]

];

$context  = stream_context_create($options);

$response = file_get_contents('https://api.latinapi.com/api/forex/convert', false, $context);

$result = json_decode($response, true);

print_r($result);

?>

Python (requests)

python

import requests

url = "https://api.latinapi.com/api/forex/convert"

payload = {

    "currency": "MXN",

    "base": "EUR",

    "amount": 150

}

headers = {

    'Content-Type': 'application/json',

    'X-Api-Key: TU_LLAVE_PRIVADA_API'

}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

JavaScript / Node.js (Fetch API)

javascript

const convertCurrency = async () => {
  const url = 'https://api.latinapi.com/api/forex/convert';
  const data = {
    currency: 'MXN',
    base: 'EUR',
    amount: 150
  };

try {

    const response = await fetch(url, {

      method: 'POST',

      headers: {

        'Content-Type': 'application/json',

        'X-Api-Key: TU_LLAVE_PRIVADA_API'

      },

      body: JSON.stringify(data)

    });

    

    const result = await response.json();

    console.log(result);

  } catch (error) {

    console.error('Error:', error);

  }

};

convertCurrency();

ForEX