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 --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.
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 --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.