Cotizaciones y Tasas de Cambio
Cotizaciones y Tasas de Cambio
Las Cotizaciones proporcionan información de tasas de cambio y te permiten bloquear tasas por un período específico antes de crear órdenes.
¿Qué son las Cotizaciones?
Una Cotización es una solicitud de información de tasa de cambio que devuelve:
- Tasa de cambio actual entre monedas
- Comisiones (comisión Koywe, comisión de red, comisión de socio)
- Tiempo de expiración (cuánto tiempo es válida la tasa)
- Montos esperados (entrada y salida)
Tiempo de Vida (TTL) de Cotización
Validez Corta: Las cotizaciones son válidas por 10-15 segundos solamente. Después de la expiración, debes solicitar una nueva cotización. Siempre verifica el campo expiresAt o validFor.
¿Por qué tan corto?
- Los mercados de cripto y forex son volátiles
- Asegura precios precisos y en tiempo real
- Protege contra manipulación de precios
- Previene uso de tasas obsoletas
Cuándo Usar Cotizaciones
Usa cotizaciones cuando:
- Necesites mostrar a los clientes el monto exacto que recibirán
- Conviertas entre monedas (BALANCE_TRANSFER)
- Compres o vendas cripto (ONRAMP/OFFRAMP)
- Quieras transparencia en las tasas
Opcional pero Recomendado: Las cotizaciones son opcionales para la mayoría de tipos de orden pero muy recomendadas para transparencia y mejor experiencia de usuario.
Crear una Cotización
Solicitud Básica de Cotización
Respuesta:
Campos de Respuesta de Cotización
Usar Cotizaciones en Órdenes
Bloqueo de Tasa
Cuando creas una orden con un quoteId, la tasa de cambio se bloquea:
Expiración de Cotización: Las cotizaciones son válidas por un tiempo limitado (típicamente 5 minutos). Si la cotización expira antes de crear la orden, necesitarás obtener una nueva cotización.
Tipos de Cotización por Tipo de Orden
Cotizaciones PAYIN
Para aceptar pagos (típicamente misma moneda, por lo que tasa = 1):
Respuesta:
Cotizaciones BALANCE_TRANSFER
Para conversión de moneda:
Respuesta:
Cotizaciones ONRAMP
Para comprar cripto:
Red Requerida: Las cotizaciones ONRAMP requieren un parámetro network para especificar la red blockchain del activo cripto.
Redes soportadas:
ETHEREUM(para USDC, USDT, ETH)POLYGON(para USDC, USDT, MATIC)BSC(para USDC, USDT, BNB)BITCOIN(para BTC)TRON(para USDT)
Respuesta:
Cotizaciones OFFRAMP
Para vender cripto:
Red Requerida: Las cotizaciones OFFRAMP requieren un parámetro network para especificar la red blockchain del activo cripto.
Respuesta:
Comprender las Comisiones
Desglose de Comisiones
Cálculo ejemplo:
Tipos de Comisiones
Mostrar Tasas a Usuarios
Visualización Amigable
Salida:
Recuperar una Cotización
Obtener detalles de una cotización existente:
Mejores Prácticas
Cuándo Obtener una Cotización
Siempre obtén una cotización para:
- Conversiones de moneda (BALANCE_TRANSFER)
- Operaciones cripto (ONRAMP/OFFRAMP)
- Mostrar tasa a usuarios antes de que confirmen
Visualización de Tasa
Muestra a los usuarios:
- Tasa de cambio en términos familiares (1 USD = X COP)
- Comisiones totales claramente separadas
- Tasa efectiva (incluyendo comisiones)
- Tiempo de expiración
Manejo de Expiración
Cotización vs Sin Cotización
Con Cotización
Beneficios:
- Tasa bloqueada
- Usuario sabe exactamente qué recibirá
- Mejor transparencia
Sin Cotización
Consideraciones:
- Tasa determinada al momento de creación de orden
- Pequeña fluctuación de tasa posible
- Más rápido (una llamada API menos)