X-Forwarded-For (vía CloudFront). Los límites se aplican por minuto rolling window.
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.
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.