Tipo de Cambio

Obtén el tipo de cambio oficial del dólar americano (USD) a soles (PEN) publicado por la Superintendencia de Banca y Seguros (SBS).

Endpoint

GET /api/tipocambio

Parámetros de query

Parámetro	Tipo	Requerido	Descripción
`fecha`	string	No	Fecha en formato YYYY-MM-DD (default: hoy)

Headers

Header	Requerido	Descripción
`X-API-KEY`	Sí	Tu API Key de KipuDev

Ejemplo de solicitud

curl -X GET "https://api.kipudev.com/api/tipocambio" \
  -H "X-API-KEY: tu-api-key"

curl -X GET "https://api.kipudev.com/api/tipocambio?fecha=2025-12-15" \
  -H "X-API-KEY: tu-api-key"

Respuesta exitosa

{
  "compra": 3.712,
  "venta": 3.718,
  "moneda": "USD",
  "fecha": "2025-12-19",
  "origen": "SBS"
}

Campos de respuesta

Campo	Tipo	Descripción
`compra`	number	Tipo de cambio de compra
`venta`	number	Tipo de cambio de venta
`moneda`	string	Código de moneda (siempre "USD")
`fecha`	string	Fecha del tipo de cambio (YYYY-MM-DD)
`origen`	string	Fuente del dato (siempre "SBS")

El tipo de cambio de la SBS se publica generalmente después de las 5:00 PM hora de Lima. Si consultas la fecha de hoy muy temprano, es posible que aún no esté disponible.

Errores

Código	Error	Descripción
400	`Formato de fecha inválido`	La fecha debe estar en formato YYYY-MM-DD
404	`Tipo de cambio no disponible`	No hay datos para la fecha solicitada

{
  "error": "Tipo de cambio no disponible para la fecha solicitada",
  "code": "NOT_FOUND"
}

Consideraciones

El tipo de cambio no está disponible para:

Fines de semana (sábado y domingo)
Feriados nacionales de Perú
Días muy recientes (puede tardar unas horas en publicarse)

Ejemplo de uso

interface TipoCambio {
  compra: number;
  venta: number;
  moneda: string;
  fecha: string;
  origen: string;
}

async function obtenerTipoCambio(fecha?: string): Promise<TipoCambio> {
  const url = fecha
    ? `https://api.kipudev.com/api/tipocambio?fecha=${fecha}`
    : "https://api.kipudev.com/api/tipocambio";

  const response = await fetch(url, {
    headers: { "X-API-KEY": process.env.KIPUDEV_API_KEY },
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error);
  }

  return response.json();
}

// Uso
const hoy = await obtenerTipoCambio();
console.log(`Compra: S/${hoy.compra} | Venta: S/${hoy.venta}`);

// Fecha específica
const historico = await obtenerTipoCambio("2025-12-01");
console.log(`TC del 01/12: S/${historico.venta}`);

Casos de uso comunes

Facturación: Calcular el equivalente en soles de facturas en dólares
Reportes contables: Tipo de cambio para cierre de mes
E-commerce: Mostrar precios en ambas monedas
Aplicaciones financieras: Conversión de divisas en tiempo real

Rate Limiting

Este endpoint consume 1 consulta de tu cuota diaria.

Si necesitas el tipo de cambio frecuentemente, considera cachearlo localmente y actualizarlo una vez al día.