Límites de tasa

Los límites usan un presupuesto de puntos por ventana de 60 segundos, según el nivel (tier) de tu llave. Cada operación consume puntos según su peso: una lectura estándar cuesta 1 punto; las operaciones más pesadas o que hacen fan-out cuestan más.

Se aplica en dos dimensiones

El presupuesto del nivel se comprueba a la vez por cuenta y por llave, y gana el más restrictivo:

• Por cuenta — el límite principal. El presupuesto del nivel se comparte entre todas las llaves de tu cuenta, así que crear llaves adicionales no multiplica tu límite total.
• Por llave — cada llave usa el presupuesto del nivel por defecto, y puede configurarse con un sub-límite más estricto para acotar una llave concreta.

Niveles

Las llaves nuevas empiezan en basic. Los niveles son bandas de límite, no planes de facturación.

Nivel	Presupuesto	Aprox.
basic (por defecto)	300 puntos / min	~5 req/s
standard	600 puntos / min	~10 req/s
premium	6000 puntos / min	~100 req/s

¿Necesitas un límite mayor?

Para subir de nivel, contacta a soporte de Skipo. Los niveles los ajusta Skipo; no son autoservicio.

Coste por herramienta MCP

El servidor MCP consume del mismo presupuesto que la API REST: una llamada a una herramienta cuesta los puntos que se indican abajo (no 1 punto fijo).

Puntos	Herramientas
1	check_api_health, get_server_time
2	get_account, get_balances, get_contacts, get_deposits, get_withdrawals, get_orders, get_assets, get_markets
3	get_fills, get_order_fills, get_ledger, get_balance_history
10	get_indicative_price

get_indicative_price cuesta 10 puntos

Es la única herramienta que llega a un proveedor de precios externo, y por eso cuesta 10 veces más que una lectura simple. En el nivel basic (300 puntos/min) eso son unas 30 llamadas por minuto antes de que te limiten, aunque el resto de tu presupuesto esté sin usar. Si vas a pedir precios en bucle, considera espaciar las llamadas o pedir un nivel mayor.

Cabeceras

Cada respuesta autenticada incluye las cabeceras estándar (borrador IETF) y sus equivalentes heredadas:

Cabecera	Significado
RateLimit-Limit · X-RateLimit-Limit	Presupuesto de la ventana actual.
RateLimit-Remaining · X-RateLimit-Remaining	Puntos restantes en la ventana.
RateLimit-Reset · X-RateLimit-Reset	Segundos hasta que se reinicia la ventana.

Respuesta 429

Si superas el límite recibes un 429 Too Many Requests con cuerpo application/problem+json y una cabecera Retry-After:

HTTP/1.1 429 Too Many Requests
Retry-After: 3
Content-Type: application/problem+json

{
  "type": "https://docs.skipo.com/errors/rate_limited",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limited",
  "retryable": true
}

Respeta siempre Retry-After y aplica backoff exponencial ante 429.