Cuenta, claves y descripción general de uso
Esta página describe cómo se relacionan entre sí una cuenta de Cryptohopper, sus claves API y su uso de MCP. Es el mapa conceptual que conecta los niveles de suscripción, la seguridad de las claves API y los límites de tasa.
Modelo de cuenta
Una cuenta de Cryptohopper es la autoridad raíz para todo lo descrito en esta documentación. La cuenta contiene:
- El nivel de suscripción activo (Pioneer, Explorer, Adventurer, Hero).
- El conjunto de claves API (con límites por nivel sobre cuántas pueden existir simultáneamente).
- El contador de uso semanal actual y el tiempo de reinicio.
- La lista de exchanges que la cuenta tiene permiso para consultar.
Todas las solicitudes MCP se autentican contra una clave api, que a su vez se resuelve a una cuenta. Todos los límites descritos en esta documentación se aplican por cuenta.
Claves API
Una clave api es un token portador emitido por la cuenta. Se presenta en el encabezado Authorization de cada solicitud MCP:
Authorization: Bearer
Propiedades de la clave
| Propiedad | Descripción |
|---|---|
| Propiedad | Las claves están vinculadas a la cuenta que las creó. |
| Alcance | Todas las claves bajo una cuenta comparten acceso idéntico: mismo nivel, mismos exchanges, misma cuota. |
| Revocación | Las claves pueden revocarse en cualquier momento a través de la interfaz de cuenta de Cryptohopper. La revocación surte efecto de inmediato. |
| Rotación | Se puede crear una clave nueva y revocar una clave antigua de forma independiente. |
| Cuota | Las claves comparten la única cuota semanal de la cuenta. Crear claves adicionales no aumenta la cuota. |
Cuándo usar múltiples claves
La cantidad de claves que puede tener una cuenta depende del nivel (consulta los niveles de suscripción). Múltiples claves son útiles para:
- Separación por agente. Diferentes agentes de IA o flujos de trabajo reciben cada uno su propia clave. Al rotar o revocar una clave, solo el agente propietario se ve afectado.
- Separación por entorno. Una clave de producción y una clave de desarrollo, cada una revocable de forma independiente.
- Atribución. Los registros de uso (cuando estén disponibles) pueden inspeccionarse por clave para identificar qué consumidor está gastando la cuota.
Múltiples claves no afectan la cuota. Todas las claves comparten el mismo límite semanal a nivel de cuenta. Consulta cómo ejecutar múltiples agentes con múltiples claves api.
Uso
El uso se rastrea por cuenta, en unidades de llamada. El contador semanal se incrementa cada vez que se invoca una herramienta. Consulta los límites de tasa explicados para saber cómo las llamadas se traducen en unidades.
El MCP expone una herramienta de inspección que devuelve el estado de uso actual:
| Campo | Tipo | Descripción |
|---|---|---|
| tier | string | El nivel de suscripción activo. |
| calls_used | integer | Unidades usadas en el ciclo semanal actual. |
| calls_limit | integer | El límite semanal del nivel. |
| reset_at | string (ISO-8601) | Marca de tiempo del próximo reinicio semanal. |
Consulta uso y límites para ver el esquema de respuesta completo y ejemplos de invocaciones.
Reinicio semanal
Todas las cuentas comparten la misma cadencia de reinicio: el contador semanal se reinicia cada viernes. El tiempo de reinicio preciso por cuenta es estable entre semanas y se devuelve en el campo reset_at.
Los errores relacionados con el uso (QUOTA_EXCEEDED) se borran automáticamente en el reinicio.
Nivel y cobertura de exchange
El nivel de la cuenta determina:
- Qué exchanges pueden consultarse a través del MCP.
- Cuántos datos históricos de velas pueden solicitarse.
- Cuántas claves api pueden existir simultáneamente.
- El límite de llamadas semanales y el factor de costo para datos históricos.
Consulta los niveles de suscripción para ver la matriz completa y los exchanges admitidos para ver la lista de exchanges.
Fallo de autenticación
Una clave api inválida, revocada o mal formada devuelve una respuesta 401 Unauthorized, mapeada a un error UNAUTHORIZED en el esquema de error de MCP. Consulta la referencia de errores.
Consideraciones de seguridad
Las claves api otorgan acceso de lectura a datos de mercado bajo el nivel de la cuenta. No otorgan acceso a los bots de Cryptohopper, credenciales API de exchange o la cuenta misma. No obstante, las claves comprometidas consumen cuota y pueden contribuir al ruido de límite de tasa.
Consulta las mejores prácticas de seguridad de claves api para obtener orientación sobre:
- Almacenamiento y gestión de secretos.
- Cadencia de rotación de claves.
- Revocación de claves comprometidas.
- Separación de claves por entorno.
Relación con la API de Trading de Cryptohopper
El MCP de Cryptohopper y la API REST de Trading de Cryptohopper usan tokens de autenticación separados emitidos bajo la misma cuenta. Una clave MCP no autoriza llamadas a la API de Trading, y viceversa.
Para agentes de extremo a extremo que usan el MCP para investigación y la API de Trading para ejecución, se requieren ambas credenciales. Consulta Combinar MCP + API de Trading de Cryptohopper para agentes de extremo a extremo.
Comprobación del estado de la cuenta desde un cliente MCP Las consultas comunes emitidas desde un cliente compatible con MCP:
¿Cuál es mi nivel actual de MCP de Cryptohopper? ¿Cuánto de mi cuota semanal he usado? ¿Qué exchanges tengo permitido consultar?
Cada una de estas se dirige a la herramienta correspondiente y devuelve una respuesta estructurada que el modelo resume.