Para desarrolladores

API de Tipo de Cambio

Integra el tipo de cambio oficial del dólar en Costa Rica (BCCR) directamente en tus aplicaciones. Una única fuente de verdad, siempre actualizada, sin que tengas que conectarte al Banco Central.

URL base/api/v1

¿Por qué usar nuestra API?

Rápida

Respuestas optimizadas y cacheadas que responden en milisegundos.

Segura

Autenticación por API key, rate limiting y CORS configurable.

Versionada

Endpoints estables bajo /api/v1 para que tus apps nunca se rompan.

Confiable

Datos oficiales del BCCR sincronizados todos los días.

Precios

Un plan simple con acceso completo a la API.

Plan Pro

$2.99/mes
  • Acceso a todos los endpoints
  • 5.000 solicitudes al mes
  • Datos oficiales del BCCR, actualizados a diario
  • Widgets, SDK y soporte

Personalizado

Contáctanos

¿Necesitás mayor capacidad? Diseñamos un plan a la medida de tu necesidad.

  • Más de 5.000 solicitudes al mes
  • Límites y endpoints a medida
  • Soporte prioritario y SLA
  • Facturación adaptada a tu volumen

Tipos de consulta

Todas las consultas devuelven JSON con un formato consistente. Estos son los tipos disponibles:

GET/api/v1/exchange-rate/latestRequiere API key

Último tipo de cambio

Obtén la tasa de compra y venta más reciente del par USD/CRC.

GET/api/v1/exchange-rate?date=YYYY-MM-DDRequiere API key

Por fecha específica

Consulta el tipo de cambio de un día puntual.

GET/api/v1/exchange-rate/history?days=30Requiere API key

Historial

Los últimos N días de tasas (hasta 365), ideal para gráficos.

GET/api/v1/exchange-rate/range?from=…&to=…Requiere API key

Rango de fechas

Todas las tasas entre dos fechas para análisis de períodos.

GET/api/v1/convert?amount=1000&from=USD&to=CRCRequiere API key

Conversor de montos

Convierte montos entre USD y CRC con la tasa oficial.

GET/api/v1/exchange-rate/analytics?days=30Requiere API key

Analítica

Promedio, mínimo, máximo, variación, volatilidad y tendencia ya calculados.

GET/api/v1/exchange-rate/stats?period=monthly&from=…&to=…Requiere API key

Estadísticas por período

Agregados mensuales o anuales para un rango de fechas.

GET/api/v1/exchange-rate/chart?days=90&points=60Requiere API key

Datos para gráficos

Serie optimizada y reducida a N puntos, con línea de tendencia.

GET/api/v1/banking/ratesRequiere API key

Tasas por institución

Compra y venta de dólares por banco y casa de cambio (ventanilla).

GET/api/v1/banking/best?operation=sellRequiere API key

Mejor tasa

Qué institución compra o vende dólares al mejor precio, con ranking.

GET/api/v1/insights?days=30&locale=esRequiere API key

AI Market Insights

Resumen con IA de las causas probables de los movimientos y un veredicto.

GET/api/v1/healthPúblico

Estado del servicio

Verifica la disponibilidad de la API y la última fecha registrada.

Todas las consultas requieren tu API key en el header x-api-key, excepto el estado del servicio.

Ejemplo de respuesta

Respuesta de la consulta «Último tipo de cambio»:

GET /api/v1/exchange-rate/latest
{
  "success": true,
  "data": {
    "date": "2026-07-19",
    "currencyFrom": "USD",
    "currencyTo": "CRC",
    "buy": 505.12,
    "sell": 512.34,
    "source": "BCCR",
    "fetchedAt": "2026-07-19T12:00:00.000Z"
  }
}

Widgets embebibles

Mostrá el tipo de cambio en tu sitio con un iframe. Sin API key, se actualiza solo.

Widget (tarjeta)
<iframe src="https://exchangecr.com/es/widget?theme=auto"
        width="360" height="150" style="border:0"></iframe>
Banner (horizontal)
<iframe src="https://exchangecr.com/es/banner?theme=auto"
        width="640" height="90" style="border:0"></iframe>

Ver estado del servicio

¿Listo para integrarla?

Escríbenos para obtener tu API key y empezar a consumir el tipo de cambio en minutos.

Solicitar acceso