Référence des erreurs
Cette page liste les erreurs retournées par le Cryptohopper Market Data MCP et décrit la cause et la gestion recommandée pour chacune.
Pour un guide de dépannage orienté tâches, consulte dépanner les erreurs MCP courantes.
Format d'erreur
Les erreurs sont retournées au client MCP dans l'enveloppe d'erreur MCP standard. Les champs :
| Champ | Type | Description |
|---|---|---|
| code | string | Un identifiant stable en majuscules (ex. QUOTA_EXCEEDED). |
| message | string | Une description lisible par l'humain. |
| details | object | Contexte structuré optionnel. |
Le code est le contrat stable. Les clients doivent se brancher sur le code, pas sur le texte du message.
Erreurs d'authentification
UNAUTHORIZED
La clé API est manquante, mal formée, expirée ou révoquée.
Causes courantes :
- Pas d'en-tête Authorization dans la requête.
- Token bearer mal formé (espaces, artefacts de copier-coller).
- La clé a été révoquée dans l'interface du compte Cryptohopper.
- La clé a été générée pour un produit différent et n'est pas valide pour le MCP.
Gestion : régénère la clé depuis l'interface du compte Cryptohopper et reconfigure le client. Consulte les bonnes pratiques de sécurité des clés API et comment obtenir une clé API Cryptohopper MCP.
FORBIDDEN
La requête est authentifiée mais le compte n'a pas la permission d'effectuer l'action demandée.
Causes courantes :
- Le compte est suspendu ou signalé.
- Le point de terminaison a été restreint pour le compte.
Gestion : contacte le support Cryptohopper. Régénérer la clé ne résoudra pas cette erreur.
Erreurs de quota et de limite de débit
QUOTA_EXCEEDED
Le compte a atteint sa limite d'appels hebdomadaire.
Gestion : attends la prochaine réinitialisation (vendredi), améliore le niveau d'abonnement, ou audite les modèles d'appels pour réduire l'utilisation. Le champ details.reset_at contient l'horodatage de la prochaine réinitialisation.
Consulte les limites de débit expliquées et les niveaux d'abonnement.
RATE_LIMIT_EXCEEDED
Le compte a dépassé la limite de débit à court intervalle.
Gestion : réessaie après un bref délai. Les clients bien conçus reculent de façon exponentielle ; une première tentative après 500ms est généralement suffisante. Si l'erreur se reproduit, ajoute un petit délai entre les appels séquentiels dans ton flux de travail.
HISTORY_LIMIT_EXCEEDED
Une requête de chandelier a spécifié un lookback supérieur à l'historique maximum du niveau actif.
Gestion : réduis le lookback, ou améliore vers un niveau avec un historique plus profond. Consulte les niveaux d'abonnement.
Erreurs de niveau et d'accès
EXCHANGE_NOT_SUPPORTED
L'exchange demandé n'est pas disponible pour le niveau actif, ou n'est pas pris en charge par le MCP du tout.
Gestion : confirme que l'exchange est dans la liste autorisée du niveau dans exchanges pris en charge. Si l'exchange est listé pour un niveau supérieur, améliore. S'il n'est pas du tout listé, l'exchange n'est pas pris en charge.
PAIR_NOT_FOUND
La paire demandée n'existe pas sur l'exchange spécifié, ou le symbole de la paire est mal formé.
Gestion : vérifie le symbole de la paire en utilisant l'outil list-pairs. Les symboles de paires utilisent le format BASE/QUOTE (ex. BTC/USDT).
TIMEFRAME_NOT_SUPPORTED
La période de chandelier (intervalle) demandée n'est pas prise en charge pour cet exchange ou cette paire.
Gestion : utilise une période prise en charge. Consulte la référence de l'outil chandelier.
Erreurs de requête
INVALID_PARAMETER
Un ou plusieurs arguments de l'outil ont échoué à la validation.
Causes courantes :
- Lookback inférieur à 1 ou au-dessus du maximum du niveau.
- Valeurs non-string là où des strings sont requises.
- Identifiants d'exchange ou de paire mal formés.
Gestion : l'objet details contient le paramètre fautif. Corrige et réessaie.
MISSING_PARAMETER
Un argument requis n'a pas été fourni.
Gestion : l'objet details nomme le paramètre manquant. Corrige et réessaie.
Erreurs en amont
EXCHANGE_UNAVAILABLE
L'API de l'exchange sous-jacent ne répond pas ou retourne des erreurs. Ceci est généralement transitoire.
Gestion : réessaie après un court délai. Si l'erreur persiste sur plusieurs exchanges, cela peut indiquer un incident côté MCP — vérifie la page de statut Cryptohopper.
DATA_UNAVAILABLE
Les données demandées existent conceptuellement mais sont temporairement indisponibles (par exemple, une série de chandeliers qui n'a pas encore été peuplée).
Gestion : réessaie après un délai. Pour les pannes de longue durée, choisis un exchange différent ou une paire différente.
Erreurs de serveur
INTERNAL_ERROR
Une erreur inattendue s'est produite à l'intérieur du serveur MCP.
Gestion : réessaie une fois. Si l'erreur persiste, signale-la via le support Cryptohopper avec le details.trace_id si présent.
SERVICE_UNAVAILABLE
Le service MCP est temporairement incapable de traiter les requêtes. Généralement pendant la maintenance ou sous charge inhabituelle.
Gestion : réessaie après un délai. Vérifie la page de statut Cryptohopper pour les incidents en cours.
Tableau de référence rapide
| Code | Catégorie | Réessayer ? | Correction |
|---|---|---|---|
| UNAUTHORIZED | Auth | Non | Régénérer la clé |
| FORBIDDEN | Auth | Non | Contacter le support |
| QUOTA_EXCEEDED | Quota | À la réinitialisation | Améliorer le niveau ou réduire l'utilisation |
| RATE_LIMIT_EXCEEDED | Quota | Après délai | Limiter le client |
| HISTORY_LIMIT_EXCEEDED | Niveau | Non | Réduire le lookback / améliorer le niveau |
| EXCHANGE_NOT_SUPPORTED | Niveau | Non | Vérifier la liste autorisée du niveau |
| PAIR_NOT_FOUND | Requête | Non | Vérifier le symbole de la paire |
| TIMEFRAME_NOT_SUPPORTED | Requête | Non | Utiliser une période prise en charge |
| INVALID_PARAMETER | Requête | Non | Corriger le paramètre |
| MISSING_PARAMETER | Requête | Non | Ajouter le paramètre |
| EXCHANGE_UNAVAILABLE | Amont | Oui | Brève nouvelle tentative |
| DATA_UNAVAILABLE | Amont | Oui | Délai puis réessayer |
| INTERNAL_ERROR | Serveur | Une fois | Signaler si persistant |
| SERVICE_UNAVAILABLE | Serveur | Oui | Délai puis réessayer |