Skip to main content
Mouv aplica límites de requests por IP de origen y, en algunos endpoints, por empresa. Los límites se aplican sobre una ventana móvil de un minuto.

Límites actuales

Respuesta cuando se excede

El header Retry-After indica los segundos exactos hasta que la ventana se libera. La respuesta 429 NO consume cuota adicional.

Cotizaciones de conversión (POST /swaps/quotes)

A diferencia de los demás, este límite se cuenta por empresa (no por IP): todas las llaves y sesiones de tu empresa comparten los 30 por minuto. Al excederlo responde 429:
Espera según el header Retry-After antes de volver a cotizar. Una cotización tiene vencimiento corto (expiresAt), así que cotiza solo cuando vayas a aceptar.

Estrategia recomendada

Tips para evitar rate limiting

Cachear saldo

GET /wallets/balance retorna header Cache-Control: private, max-age=10. Cacheá 10s en tu cliente — reduce ~50% del tráfico.

Batch consultas

En lugar de N llamadas a /transactions/:id, usá /transactions con paginación. Una sola request retorna hasta 100 movimientos.

Webhooks (próximo)

Cuando habilitemos webhooks salientes, podrás recibir notificaciones de transfer.completed en lugar de pollear estados.

Backoff exponencial

Si recibís 429 dos veces seguidas, hacé backoff 2^n * 1000ms (1s, 2s, 4s, 8s). Industry pattern Stripe/Plaid.

Límites elevados (enterprise)

Si tu volumen requiere más capacidad (>500 retiros/día sostenidos o >100 PSE links/día), contactanos en hola@vectora.com.co. Configuramos límites custom per-cliente con visibility métrica.