Límite de solicitudes
Los límites son por ventana deslizante de 1 hora — cada solicitud cuenta contra el límite durante los 60 minutos siguientes; no hay un reinicio a hora fija — y se separan en tres franjas: lectura (GET), escritura (POST, PUT, PATCH, DELETE) y las acciones que mueven dinero, que tienen su propio cubo, más restrictivo.
| Tipo | Límite |
|---|---|
Lectura (GET) | 60 solicitudes/hora |
Escritura (POST, PUT, PATCH, DELETE) | 1000 solicitudes/hora |
| Movimiento de dinero (emitir/cancelar cobro, enviar/cancelar pago al banco) | 60 solicitudes/hora |
Las acciones que mueven dinero cuentan solo contra su propia franja (throttle_v1_money), no contra la de escritura. Si tu operación necesita un número mayor, habla con el soporte o el área comercial.
Headers de respuesta
En cada solicitud, el servidor adjunta a los encabezados de la respuesta los límites utilizados y cuándo se libera el conteo:
| Header | Ejemplo | Descripción |
|---|---|---|
ratelimit-limit | 60 | Límite de solicitudes para el cliente. |
ratelimit-name | throttle_v1_write | Nombre del throttle utilizado. |
ratelimit-remaining | 0 | Número de solicitudes disponibles. |
ratelimit-reset | 1782648000000 | Unix time en milisegundos — cuándo se reinicia el conteo. |
retry-after | 30 | Segundos hasta que el conteo se reinicie. Ver Retry-After. |
Ejemplo de respuesta en éxito
Date: Fri, 17 Jul 2026 12:00:00 GMT
Content-Type: application/json; charset=utf-8
ratelimit-limit: 1000
ratelimit-remaining: 486
Ejemplo de respuesta en bloqueo
Cuando se alcanza el límite, el servidor devuelve HTTP 429 Too Many Requests. Espera el número de segundos del header retry-after antes de la próxima solicitud.
HTTP/1.1 429 Too Many Requests
Date: Fri, 17 Jul 2026 12:00:00 GMT
Content-Type: application/json; charset=utf-8
ratelimit-limit: 1000
ratelimit-remaining: 0
ratelimit-reset: 1784293200000
ratelimit-name: throttle_v1_write
retry-after: 3600
{ "error": { "code": "RATE_LIMITED", "message": "Write request rate limit exceeded for this token." } }
Referencia: RateLimit header fields for HTTP