Consultar tasas

Filtra por moneda, entidad y canal. Ordena o selecciona los campos que necesitas.

Filtra y selecciona campos

Compra y venta se expresan desde la entidad. buy es lo que paga cuando vendes divisas; sell es lo que cobra cuando compras. Los decimales son texto y un lado sin dato es null.

cURL
curl --fail-with-body 'https://api.divisa.do/v1/rates?currency=USD&kind=commercial&fields=id,institutionId,currency,buy,sell,channel,kind,stale,lastCheckedAt,expiresAt&sort=-buy&limit=10' \
  -H 'Accept: application/json'

Recorre las páginas

Usa meta.nextCursor como cursor de la próxima consulta. Termina cuando sea null. Conserva los mismos filtros entre páginas.

JavaScript
const url = new URL('https://api.divisa.do/v1/rates?currency=USD&limit=50');
const rates = [];
let cursor = 0;

do {
  url.searchParams.set('cursor', String(cursor));
  const response = await fetch(url);
  if (!response.ok) throw new Error(`HTTP ${response.status}`);

  const { data, meta } = await response.json();
  rates.push(...data);
  cursor = meta.nextCursor;
} while (cursor !== null);

console.log(rates);

Encuentra la mejor tasa

operation=sell ordena por la compra más alta; operation=buy por la venta más baja. Las referencias oficiales y las cotizaciones vencidas quedan fuera.

cURL
curl --fail-with-body 'https://api.divisa.do/v1/rates/best?currency=USD&operation=sell' \
  -H 'Accept: application/json'

Fechas y procedencia

publishedAt es la fecha y hora publicada; effectiveDate conserva una fecha sin hora; datePrecision declara esa precisión. lastCheckedAt indica la última consulta. La API mantiene procedencia, vigencia y evidencia asociada a cada observación.