Convertir un monto

Calcula el equivalente de un monto en divisas a pesos dominicanos.

Convertir un monto

El monto amount se expresa en la moneda extranjera, con hasta dos decimales. El resultado amountDop es texto con dos decimales. La operación es desde el usuario: sell para vender divisas; buy para comprarlas.

const response = await fetch(
  'https://api.divisa.do/v1/convert?currency=USD&amount=100&operation=sell&fields=amountDop,rate,currency,operation,feesIncluded',
  { headers: { Accept: 'application/json' } }
);

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const { data, meta } = await response.json();
console.log(data);

Selecciona la entidad

Sin institution, la API usa las mejores tasas comerciales vigentes. Agrega institution y channel para limitar la selección. No incluye comisiones no publicadas.

curl --fail-with-body 'https://api.divisa.do/v1/convert?currency=USD&amount=100&operation=buy&institution=popular&channel=digital' \
  -H 'Accept: application/json'

Maneja una operación sin tasa

Una cotización parcial permite sólo el lado disponible. Si no hay una tasa elegible, no calcules con cero ni uses una referencia oficial como oferta comercial. Comprueba siempre el estado HTTP y el resultado.