Riferimento errori
Questa pagina elenca gli errori restituiti dal Cryptohopper Market Data MCP e descrive la causa e la gestione consigliata per ciascuno.
Per una guida alla risoluzione dei problemi orientata alle attività, consulta risoluzione dei problemi comuni MCP.
Formato degli errori
Gli errori vengono restituiti al client MCP nell'envelope di errore MCP standard. I campi:
| Campo | Tipo | Descrizione |
|---|---|---|
| code | string | Un identificatore stabile in maiuscolo (es. QUOTA_EXCEEDED). |
| message | string | Una descrizione leggibile. |
| details | object | Contesto strutturato opzionale. |
Il code è il contratto stabile. I client devono ramificare su code, non sul testo di message.
Errori di autenticazione
UNAUTHORIZED
La chiave API è mancante, malformata, scaduta o revocata.
Cause comuni:
- Nessun header Authorization nella richiesta.
- Bearer token malformato (spazi bianchi, artefatti da copia-incolla).
- La chiave è stata revocata nell'interfaccia dell'account Cryptohopper.
- La chiave è stata generata per un prodotto diverso e non è valida per l'MCP.
Gestione: rigenera la chiave dall'interfaccia dell'account Cryptohopper e riconfigura il client. Consulta best practice per la sicurezza delle chiavi API e come ottenere una chiave API Cryptohopper MCP.
FORBIDDEN
La richiesta è autenticata ma l'account non ha il permesso di eseguire l'azione richiesta.
Cause comuni:
- L'account è sospeso o segnalato.
- L'endpoint è stato limitato per l'account.
Gestione: contatta il supporto Cryptohopper. Rigenerare la chiave non risolverà questo errore.
Errori di quota e limite di rate
QUOTA_EXCEEDED
L'account ha raggiunto il limite di chiamate settimanale.
Gestione: attendi il prossimo reset (venerdì), aggiorna il livello di abbonamento o controlla i pattern di chiamata per ridurre l'utilizzo. Il campo details.reset_at contiene il timestamp del prossimo reset.
Consulta spiegazione dei limiti di rate e livelli di abbonamento.
RATE_LIMIT_EXCEEDED
L'account ha superato il limite di rate a breve intervallo.
Gestione: riprova dopo un breve ritardo. I client che si comportano bene fanno backoff esponenziale; un nuovo tentativo iniziale dopo 500ms è tipicamente sufficiente. Se l'errore si ripete, aggiungi un piccolo ritardo tra le chiamate sequenziali nel tuo workflow.
HISTORY_LIMIT_EXCEEDED
Una richiesta di candele ha specificato un lookback maggiore del massimo storico del livello attivo.
Gestione: riduci il lookback o aggiorna a un livello con uno storico più profondo. Consulta livelli di abbonamento.
Errori di livello e accesso
EXCHANGE_NOT_SUPPORTED
L'exchange richiesto non è disponibile per il livello attivo o non è supportato dall'MCP.
Gestione: conferma che l'exchange sia nella lista consentita del livello in exchange supportati. Se l'exchange è elencato per un livello superiore, aggiorna. Se non è elencato affatto, l'exchange non è supportato.
PAIR_NOT_FOUND
La coppia richiesta non esiste sull'exchange specificato o il simbolo della coppia è malformato.
Gestione: verifica il simbolo della coppia usando il tool list-pairs. I simboli delle coppie usano il formato BASE/QUOTE (es. BTC/USDT).
TIMEFRAME_NOT_SUPPORTED
Il timeframe candela richiesto (intervallo) non è supportato per questo exchange o coppia.
Gestione: usa un timeframe supportato. Consulta riferimento tool candele.
Errori di richiesta
INVALID_PARAMETER
Uno o più argomenti del tool hanno fallito la validazione.
Cause comuni:
- Lookback inferiore a 1 o superiore al massimo del livello.
- Valori non-stringa dove sono richieste stringhe.
- Identificatori di exchange o coppia malformati.
Gestione: l'oggetto details contiene il parametro difettoso. Correggi e riprova.
MISSING_PARAMETER
Un argomento obbligatorio non è stato fornito.
Gestione: l'oggetto details nomina il parametro mancante. Correggi e riprova.
Errori upstream
EXCHANGE_UNAVAILABLE
L'API dell'exchange sottostante non risponde o sta restituendo errori. Questo è tipicamente transitorio.
Gestione: riprova dopo un breve ritardo. Se l'errore persiste su più exchange, potrebbe indicare un incidente lato MCP — controlla la pagina stato Cryptohopper.
DATA_UNAVAILABLE
I dati richiesti esistono concettualmente ma sono temporaneamente non disponibili (ad esempio, una serie di candele che non è ancora stata popolata).
Gestione: riprova dopo un ritardo. Per interruzioni prolungate, scegli un exchange diverso o una coppia diversa.
Errori del server
INTERNAL_ERROR
Si è verificato un errore imprevisto all'interno del server MCP.
Gestione: riprova una volta. Se l'errore persiste, segnalalo attraverso il supporto Cryptohopper con il details.trace_id se presente.
SERVICE_UNAVAILABLE
Il servizio MCP è temporaneamente impossibilitato a gestire le richieste. Solitamente durante la manutenzione o sotto carico insolito.
Gestione: riprova dopo un ritardo. Controlla la pagina stato Cryptohopper per incidenti in corso.
Tabella di riferimento rapido
| Code | Categoria | Riprova? | Soluzione |
|---|---|---|---|
| UNAUTHORIZED | Auth | No | Rigenera chiave |
| FORBIDDEN | Auth | No | Contatta supporto |
| QUOTA_EXCEEDED | Quota | Al reset | Aggiorna livello o riduci utilizzo |
| RATE_LIMIT_EXCEEDED | Quota | Dopo ritardo | Limita client |
| HISTORY_LIMIT_EXCEEDED | Livello | No | Riduci lookback / aggiorna livello |
| EXCHANGE_NOT_SUPPORTED | Livello | No | Controlla lista consentita livello |
| PAIR_NOT_FOUND | Richiesta | No | Verifica simbolo coppia |
| TIMEFRAME_NOT_SUPPORTED | Richiesta | No | Usa timeframe supportato |
| INVALID_PARAMETER | Richiesta | No | Correggi parametro |
| MISSING_PARAMETER | Richiesta | No | Aggiungi parametro |
| EXCHANGE_UNAVAILABLE | Upstream | Sì | Breve nuovo tentativo |
| DATA_UNAVAILABLE | Upstream | Sì | Ritardo poi riprova |
| INTERNAL_ERROR | Server | Una volta | Segnala se persistente |
| SERVICE_UNAVAILABLE | Server | Sì | Ritardo poi riprova |