Límites actuales
Respuesta cuando se excede
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:
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.