Documentación de la API

Aprende cómo usar nuestra API de tipo de cambio

GET Obtener Todas las Tasas de Cambio
https://tipodecambio.cr/api/rates

Devuelve las últimas tasas de cambio de todas las instituciones, incluyendo las tasas de BCCR y Monex.

Ejemplo de Respuesta:

{
  "timestamp": 1700000000,
  "rates": [
    {
      "entidad": "Banco Nacional",
      "compra": 520.50,
      "venta": 525.00,
      "actualizacion": "2024-01-15",
      "institution_id": 1
    }
  ],
  "bccr_rate": {
    "compra": 520.00,
    "venta": 525.00,
    "fecha": "2024-01-15"
  },
  "monex_rate": {
    "promedio": 522.50,
    "fecha": "2024-01-15"
  }
}
GET Obtener Historial de Tasas de Cambio
https://tipodecambio.cr/api/rates/history?institution_id={id}&limit={limit}

Devuelve datos históricos de tasas de cambio.

Parámetros de Consulta:

Parámetro Tipo Requerido Descripción
institution_id integer No Filtrar por ID de institución. Si se omite, devuelve todas las instituciones.
limit integer No Número máximo de registros a devolver (por defecto: 100)

Ejemplo de Respuesta:

{
  "history": [
    {
      "fecha": "2024-01-15",
      "compra": 520.50,
      "venta": 525.00,
      "institution": {
        "id": 1,
        "name": "Banco Nacional"
      }
    }
  ]
}
GET Obtener Historial de Institución
https://tipodecambio.cr/api/rates/institution/{id}?limit={limit}

Devuelve datos históricos de tasas de cambio para una institución específica.

Parámetros de URL:

Parámetro Tipo Requerido Descripción
id integer ID de Institución

Parámetros de Consulta:

Parámetro Tipo Requerido Descripción
limit integer No Número máximo de registros a devolver (por defecto: 100)

Ejemplo de Respuesta:

{
  "institution": {
    "id": 1,
    "name": "Banco Nacional",
    "logo_url": "https://example.com/logo.png",
    "website_url": "https://www.bncr.fi.cr"
  },
  "history": [
    {
      "fecha": "2024-01-15",
      "compra": 520.50,
      "venta": 525.00
    }
  ]
}

Notas Generales

  • Todos los endpoints de la API devuelven respuestas JSON
  • Todas las fechas están en formato YYYY-MM-DD
  • Los tipos de cambio se devuelven como números de punto flotante
  • La API no requiere autenticación para endpoints públicos
  • La limitación de tasa se aplica por dirección IP