Documentación API

API REST para acceder a las tasas de cambio de República Dominicana. Todas las respuestas son en formato JSON.

Base URL https://tasareal.com/api/v1

Autenticación

Incluye tu API key en el header Authorization de cada petición.

// Header requerido
Authorization: Bearer tu_api_key_aqui

Obtén tu API key en la página de planes. El plan gratuito incluye 50 peticiones diarias.

Endpoints

GET /rates Tasas por fecha

Devuelve las tasas publicadas para una fecha (una fila por institución y moneda). Sin parámetros devuelve las tasas de hoy. Una institución sin tasa ese día simplemente no aparece en <code class="text-xs bg-navy-950 px-1 rounded">rates</code>: consulta <code class="text-xs bg-navy-950 px-1 rounded">missing_institutions</code> para detectar huecos. <code class="text-xs bg-navy-950 px-1 rounded">count</code> es el número de filas devueltas, no de instituciones. <code class="text-xs bg-navy-950 px-1 rounded">sell</code> es <code class="text-xs bg-navy-950 px-1 rounded">null</code> en casas que solo compran divisas (remesadoras).

Parámetros
date date Fecha (YYYY-MM-DD). Default: hoy
currency string Moneda: USD, EUR. Default: todas
type string Filtrar por tipo: bank, exchange, official
institution string ID de institución específica: popular, reservas, etc.
Respuesta
{
  "date": "2026-09-04",
  "currency": "USD",
  "count": 24,
  "rates": [
    {
      "institution": "reservas",
      "institution_name": "Banreservas",
      "institution_type": "bank",
      "currency": "USD",
      "buy": 56.40,
      "sell": 59.90,
      "date": "2026-09-04",
      "verification": "verified",
      "source": null
    },
    {
      "institution": "caribe",
      "institution_name": "Caribe Express",
      "institution_type": "exchange",
      "currency": "USD",
      "buy": 58.25,
      "sell": null,
      "date": "2026-09-04",
      "verification": "verified",
      "source": null
    }
  ],
  "missing_institutions": ["popular"]
}
GET /rates/history Histórico de tasas

Devuelve las tasas históricas para una institución y rango de fechas (ambos extremos inclusive). Los días sin tasa publicada no aparecen.

Parámetros
institution string requerido ID de la institución
currency string requerido USD o EUR
from date requerido Fecha inicio (YYYY-MM-DD)
to date requerido Fecha fin (YYYY-MM-DD)
Respuesta
{
  "institution": "reservas",
  "currency": "USD",
  "from": "2026-09-01",
  "to": "2026-09-04",
  "count": 4,
  "data": [
    {
      "date": "2026-09-01",
      "buy": 56.40,
      "sell": 59.90,
      "verified": true
    }
  ]
}
GET /institutions Lista de instituciones

Devuelve las instituciones activas con sus metadatos. <code class="text-xs bg-navy-950 px-1 rounded">last_rate_date</code> es el último día con tasa publicada (<code class="text-xs bg-navy-950 px-1 rounded">null</code> = nunca): úsalo para saber si una fuente está al día antes de consultarla.

Respuesta
{
  "institutions": [
    {
      "id": "reservas",
      "name": "Banreservas",
      "full_name": "Banco de Reservas de la Rep. Dominicana",
      "type": "bank",
      "website": "https://banreservas.com.do",
      "participates_in_ranking": true,
      "last_rate_date": "2026-09-04"
    }
  ]
}
GET /rates/best Mejores tasas

Devuelve la mejor tasa de compra y la mejor tasa de venta del mercado (excluye oficiales).

Parámetros
currency string requerido USD o EUR
date date Fecha (YYYY-MM-DD). Default: hoy
Respuesta
{
  "date": "2026-04-06",
  "currency": "USD",
  "best_buy": {
    "institution": "quezada",
    "rate": 60.50
  },
  "best_sell": {
    "institution": "quezada",
    "rate": 60.70
  }
}

Límites y códigos de error

Códigos HTTP
200 Petición exitosa
401 API key inválida o no proporcionada
403 Plan no tiene acceso a este recurso (ej: histórico en plan gratuito)
422 Parámetros inválidos (la respuesta incluye el detalle por campo)
429 Límite de peticiones diarias excedido, o más de 120 peticiones por minuto
500 Error interno del servidor
Los headers de respuesta incluyen X-RateLimit-Remaining y X-RateLimit-Limit para monitorear tu uso.
TasaReal.com · Tasas de cambio verificadas en República Dominicana