GET /v1/fx/convert · Todos los planes, sujeto al acceso al mercado elegido. Sin via se usa BCV, no la mejor tasa de mercado.
Consulta
La moneda base del mercado debe coincidir:
eur_reference no convierte USD. Los mercados remittance solo admiten la dirección hacia VES. Parámetros desconocidos producen 400 unknown_parameter.
Los ejemplos se ejecutan en el servidor. JavaScript y Python usan los clientes del inicio rápido; configura allí COTIZAVE_API_KEY.
Respuesta
Respuesta ilustrativa: las cifras y fechas no son cotizaciones actuales.from y to contienen currency y amount. to.amount se redondea a dos decimales. rate es la tasa mid en VES por unidad de la divisa. Para convertir hacia VES se multiplica; en sentido inverso se divide.
market, type y updated_at identifican la cotización aplicada. effective_date aparece cuando la tasa tiene fecha valor, como BCV. staleness_sec indica antigüedad en segundos y stale si supera el umbral de su fuente. Guarda estos datos con el resultado si necesitas trazabilidad.
Elegir moneda y mercado
- BCV USD:
from=USD&to=VES&amount=100&via=reference. - BCV EUR:
from=EUR&to=VES&amount=100&via=eur_reference. - Inversa P2P:
from=VES&to=USD&amount=1000000&via=binance. - Para comparar varios mercados, obtén todas las tasas una vez y filtra por moneda base antes de calcular.
Errores
400 missing_field, invalid_format o unknown_parameter señalan entradas inválidas; revisa field. Un mercado ausente puede devolver 404 resource_not_found; uno restringido por plan, 402 feature_not_in_plan. No cambies a otro mercado silenciosamente.
Además pueden producirse los errores comunes de autenticación, cuota o disponibilidad. Las respuestas de error de la API son JSON; decide por code, no por el texto de message.
Frescura y precisión
Un BCV de varios días durante un fin de semana puede seguir vigente.stale: false tampoco acredita por sí solo la tasa requerida por una factura. Conserva effective_date y aplica la política de validación y redondeo de tu negocio. La API calcula importes con mid; no incluye comisiones ni garantiza ejecución.