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,entityId,currency,buy,sell,channel,kind,stale,isOfficialSource,lastCheckedAt,expiresAt&sort=-buy&limit=10' \
-H 'Accept: application/json' \
-H "Authorization: Bearer $DIVISA_API_KEY"Consulta real en producción: consume cuota. La clave permanece en memoria hasta cerrar o recargar esta página.
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, { headers: { Authorization: `Bearer ${process.env.DIVISA_API_KEY}` } });
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' \
-H "Authorization: Bearer $DIVISA_API_KEY"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. isOfficialSource es true cuando el adaptador, el origen y la entidad corresponden al registro de una fuente oficial directa; es false para agregadores, cargas manuales y orígenes desconocidos. El campo es aditivo: su ausencia debe tratarse como false. Identifica el origen y no certifica el precio. JSON y XML conservan la procedencia completa.