Límites de tasa y factores de costo

Esta página documenta cómo el MCP de Datos de Mercado de Cryptohopper cuenta las llamadas, aplica límites de tasa y cobra multiplicadores de costo por datos históricos. Es la referencia técnica; para el resumen de niveles, consulta niveles de suscripción.

Dos límites independientes

El MCP aplica dos límites separados en cada cuenta:

• Límite de llamadas semanales. Una cuota semanal renovable de llamadas, específica por nivel.
• Límite de tasa. Un límite de intervalo corto sobre qué tan rápido se pueden hacer las llamadas.

Ambos límites se aplican por cuenta. Crear claves api adicionales no multiplica ninguno de los límites.

Límite semanal de llamadas

Nivel	Llamadas semanales
Pioneer	6,000
Explorer	30,000
Adventurer	150,000
Hero	1,250,000

El contador se reinicia cada viernes a una hora fija por cuenta. Exceder el límite devuelve un error QUOTA_EXCEEDED hasta el próximo reinicio.

El uso actual y el tiempo hasta el reinicio se pueden consultar en cualquier momento. Consulta uso y límites.

Límite de tasa

Además del límite semanal, un límite de tasa de intervalo corto previene ráfagas rápidas. La ventana exacta y el umbral se aplican uniformemente en todos los niveles y pueden ajustarse sin previo aviso para mantener la estabilidad del servicio.

Exceder el límite de tasa devuelve un error RATE_LIMIT_EXCEEDED. Reintentar después de una breve espera típicamente tiene éxito.

Orientación: Si tu flujo de trabajo implica muchas llamadas secuenciales (por ejemplo, barriendo tickers en todos los pares de un exchange), añade una pequeña espera entre llamadas — del orden de decenas a cientos de milisegundos — para permanecer bajo el límite de tasa. Los clientes MCP hacen esto automáticamente en la mayoría de los casos.

Unidad de costo

Una unidad de llamada es el cargo base por una sola invocación de herramienta. El límite de llamadas semanales se expresa en unidades.

La mayoría de las invocaciones de herramientas cuentan como 1 unidad. Las consultas de velas históricas pueden contar como más de 1 unidad, como se describe a continuación.

Factor de costo: datos históricos

Las consultas de velas históricas llevan un multiplicador de costo en los niveles Explorer y Adventurer. El multiplicador depende de la profundidad de retrospección:

Profundidad de retrospección	Multiplicador de costo
Historial corto (barras recientes dentro de una ventana corta)	5×
Historial largo (barras que alcanzan hacia el historial máximo del nivel)	20×

El límite entre "corto" y "largo" es específico del nivel y puede ajustarse. Como regla práctica, las consultas que obtienen aproximadamente el ~10% más reciente del historial permitido del nivel se cobran a 5×; las consultas más profundas se cobran a 20×.

En el nivel Hero, todas las consultas históricas se cobran a 1× independientemente de la profundidad de retrospección.

Las consultas de ticker y libro de órdenes siempre se cobran a 1× en todos los niveles.

Ejemplos

Consulta	Nivel	Costo en unidades
Ticker actual de BTC/USDT en Binance	Cualquiera	1
Captura completa del libro de órdenes para ETH/USDT en Kraken	Cualquiera	1
Últimas 100 × velas de 1h para SOL/USDT en Binance (reciente)	Explorer	5
Últimas 500 × velas de 1h retrocediendo ~3 semanas	Explorer	5
Últimas 1,000 × velas de 1h retrocediendo hacia el límite de 90 días	Explorer	20
Últimas 1,000 × velas de 4h (retrospección profunda)	Adventurer	20
Últimas 3,000 × velas de 1h (retrospección de 3 años)	Hero	1

El costo exacto de una consulta específica puede previsualizarse llamando al endpoint de uso después de la consulta — el delta en calls_used es el costo en unidades.

Orientación para presupuesto

Algunas reglas prácticas para mantenerse dentro de la cuota:

• Prefiere tickers para escaneos amplios. Un barrido de 200 pares con ticker cuesta 200 unidades. El mismo barrido mediante libros de órdenes cuesta 200 unidades (aunque cada llamada transfiere mucho más datos). El mismo barrido mediante historial profundo de velas puede costar miles de unidades.
• Mantén ajustada la retrospección de velas. La mayoría de los indicadores (RSI, MACD, promedios móviles hasta 200 períodos) no necesitan más de 150-200 velas de contexto. Obtener 1,000 velas por defecto es la causa más común de gasto innecesario de cuota.
• Almacena en caché donde tenga sentido. Los libros de órdenes se vuelven obsoletos en segundos, por lo que almacenar en caché capturas de libros de órdenes rara vez es útil. Los datos de velas más antiguos que la barra actual son inmutables, por lo que almacenar en caché o persistir velas históricas es apropiado.
• Usa Hero cuando la profundidad histórica es estructuralmente requerida. Si tu flujo de trabajo obtiene rutinariamente historiales largos de velas, el factor de costo plano de 1× en Hero típicamente es más económico que obtener los mismos datos en Adventurer a 20×.

Cuota para despliegues multi-agente

Si múltiples agentes comparten una cuenta, todos los agentes consumen de la misma cuota semanal. Para separar agentes:

• Crea claves api adicionales (dentro de la cantidad de claves permitida del nivel). Cada clave consume de la cuota compartida pero puede revocarse o rotarse de forma independiente.
• Implementa limitación a nivel de aplicación por clave para evitar que un agente agote la cuota de otros.

Consulta cómo ejecutar múltiples agentes con múltiples claves api para patrones.

Manejo de errores

Errores relacionados con límites devueltos por el MCP:

Código de error	Significado
QUOTA_EXCEEDED	Límite de llamadas semanales alcanzado. Se reinicia en el próximo tiempo de reinicio.
RATE_LIMIT_EXCEEDED	Límite de tasa de intervalo corto alcanzado. Reintenta después de una breve espera.
HISTORY_LIMIT_EXCEEDED	La retrospección solicitada excede el historial máximo del nivel.
EXCHANGE_NOT_SUPPORTED	El exchange solicitado no está en la lista permitida del nivel.

Referencia completa de errores: referencia de errores.

Verificar el uso actual

El MCP expone una herramienta de inspección de uso que devuelve:

• tier — el nivel de suscripción activo.
• calls_used — unidades usadas en el ciclo semanal actual.
• calls_limit — el límite semanal del nivel.
• reset_at — timestamp ISO-8601 del próximo reinicio.