Límites de la API de cuotas por plan
Respuesta: el REST usa un token bucket por clave; las conexiones WebSocket se cuentan por cuenta. Al superarlos recibes 429 con un código claro.
| Plan | REST | Cuota diaria | WebSocket |
|---|---|---|---|
| Free | 1 req/s | 1.000 (reinicio 00:00 UTC) | No |
| Hobby | 2 req/s | Sin cuota diaria | No |
| Builder | 10 req/s | Sin cuota diaria | 3 conexiones |
| Pro | 30 req/s | Sin cuota diaria | 10 conexiones |
Qué devuelve el 429#
| Código | Causa | Qué hacer |
|---|---|---|
rate_limited | Demasiadas peticiones por segundo | Espera los segundos de la cabecera Retry-After (también retryAfterMs en el cuerpo) |
daily_quota | Free agotó sus 1.000 peticiones | Espera a las 00:00 UTC o mejora de plan |
connection_limit | Demasiados WebSocket abiertos | Cierra uno o pasa a Pro |
Consejos prácticos#
- Para tableros en vivo usa el WebSocket de Builder: no haces polling.
- Consulta
GET /v1/accountpara ver tus límites yusage.restRequestsToday. - Cada llamada a una herramienta MCP cuenta como una petición REST.
- Detalle completo: límites.
Builder (€99/mes) para WebSocket e histórico de cierre. Prueba de 3 días; se requiere tarjeta y se cobra después del día 3 salvo que canceles. REST gratis: registro.
Contenido educativo para mayores de 18 años.
Preguntas frecuentes#
¿Los mensajes del WebSocket tienen límite como el REST?#
Se limita el número de conexiones; el volumen de mensajes depende de tus filtros. Los clientes lentos reciben 4008 slow_consumer.
¿El límite es por clave o por cuenta?#
El límite REST por segundo es por clave; las conexiones WebSocket y los deportes elegidos son por cuenta.
¿El MCP cuenta como REST?#
Sí: cada llamada a una herramienta es una petición REST.