Compte, clés et aperçu de l'utilisation

Cette page décrit comment un compte Cryptohopper, ses clés API et son utilisation MCP sont liés les uns aux autres. C'est la carte conceptuelle qui relie les niveaux d'abonnement, la sécurité des clés API et les limites de taux.

Modèle de compte

Un compte Cryptohopper est l'autorité racine pour tout ce qui est décrit dans ces documents. Le compte contient :

• Le niveau d'abonnement actif (Pioneer, Explorer, Adventurer, Hero).
• L'ensemble des clés API (avec des limites par niveau sur le nombre qui peuvent exister simultanément).
• Le compteur d'utilisation hebdomadaire actuel et l'heure de réinitialisation.
• La liste des exchanges que le compte a la permission d'interroger.

Toutes les requêtes MCP s'authentifient avec une clé API, qui à son tour se résout en un compte. Toutes les limites décrites dans ces documents sont appliquées par compte.

Clés API

Une clé API est un jeton bearer émis par le compte. Elle est présentée dans l'en-tête Authorization de chaque requête MCP :

Authorization: Bearer 

Propriétés des clés

Propriété	Description
Propriété	Les clés sont liées au compte qui les a créées.
Portée	Toutes les clés d'un compte partagent un accès identique — même niveau, mêmes exchanges, même quota.
Révocation	Les clés peuvent être révoquées à tout moment via l'interface du compte Cryptohopper. La révocation prend effet immédiatement.
Rotation	Une nouvelle clé peut être créée et une ancienne clé révoquée indépendamment.
Quota	Les clés partagent le quota hebdomadaire unique du compte. Créer des clés supplémentaires n'augmente pas le quota.

Quand utiliser plusieurs clés

Le nombre de clés qu'un compte peut détenir dépend du niveau (voir niveaux d'abonnement). Plusieurs clés sont utiles pour :

• Séparation par agent. Différents agents IA ou workflows reçoivent chacun leur propre clé. Lors de la rotation ou de la révocation d'une clé, seul l'agent propriétaire est affecté.
• Séparation par environnement. Une clé de production et une clé de développement, chacune révocable indépendamment.
• Attribution. Les journaux d'utilisation (lorsqu'ils sont disponibles) peuvent être inspectés par clé pour identifier quel consommateur dépense le quota.

Plusieurs clés n'affectent pas le quota. Toutes les clés partagent la même limite hebdomadaire au niveau du compte. Voir comment exécuter plusieurs agents avec plusieurs clés API.

Utilisation

L'utilisation est suivie par compte, en unités d'appel. Le compteur hebdomadaire s'incrémente chaque fois qu'un outil est invoqué. Voir les limites de taux expliquées pour savoir comment les appels se traduisent en unités.

Le MCP expose un outil d'inspection qui retourne l'état d'utilisation actuel :

Champ	Type	Description
tier	string	Le niveau d'abonnement actif.
calls_used	integer	Unités utilisées dans le cycle hebdomadaire actuel.
calls_limit	integer	La limite hebdomadaire du niveau.
reset_at	string (ISO-8601)	Horodatage de la prochaine réinitialisation hebdomadaire.

Voir utilisation et limites pour le schéma de réponse complet et les exemples d'invocations.

Réinitialisation hebdomadaire

Tous les comptes partagent la même cadence de réinitialisation : le compteur hebdomadaire se réinitialise tous les vendredis. L'heure précise de réinitialisation par compte est stable d'une semaine à l'autre et est retournée dans le champ reset_at.

Les erreurs liées à l'utilisation (QUOTA_EXCEEDED) se résolvent automatiquement lors de la réinitialisation.

Niveau et couverture des exchanges

Le niveau du compte détermine :

• Quels exchanges peuvent être interrogés via le MCP.
• Quelle quantité de données historiques de chandeliers peut être demandée.
• Combien de clés API peuvent exister simultanément.
• La limite d'appels hebdomadaire et le facteur de coût pour les données historiques.

Voir niveaux d'abonnement pour la matrice complète et exchanges supportés pour la liste des exchanges.

Échec d'authentification

Une clé API invalide, révoquée ou mal formée retourne une réponse 401 Unauthorized, mappée à une erreur UNAUTHORIZED dans le schéma d'erreur MCP. Voir référence des erreurs.

Considérations de sécurité

Les clés API accordent un accès en lecture aux données de marché sous le niveau du compte. Elles n'accordent pas l'accès aux bots Cryptohopper, aux identifiants API d'exchange ou au compte lui-même. Néanmoins, les clés compromises consomment le quota et peuvent contribuer au bruit de limite de taux.

Voir meilleures pratiques de sécurité des clés API pour des conseils sur :

• Stockage et gestion des secrets.
• Cadence de rotation des clés.
• Révocation des clés compromises.
• Séparation des clés par environnement.

Relation avec l'API Trading de Cryptohopper

Le MCP Cryptohopper et l'API REST Trading de Cryptohopper utilisent des jetons d'authentification distincts émis sous le même compte. Une clé MCP n'autorise pas les appels à l'API Trading, et vice versa.

Pour les agents de bout en bout qui utilisent le MCP pour la recherche et l'API Trading pour l'exécution, les deux identifiants sont requis. Voir Combiner MCP + API Trading Cryptohopper pour les agents de bout en bout.

Vérifier l'état du compte depuis un client MCP Les requêtes courantes émises depuis un client compatible MCP :

Quel est mon niveau MCP Cryptohopper actuel ? Quelle part de mon quota hebdomadaire ai-je utilisé ? Quels exchanges ai-je l'autorisation d'interroger ?

Chacune de ces requêtes route vers l'outil correspondant et retourne une réponse structurée que le modèle résume.