Account, chiavi API e panoramica utilizzo

Questa pagina descrive come un account Cryptohopper, le sue chiavi API e il suo utilizzo MCP si relazionano tra loro. È la mappa concettuale che collega i livelli di abbonamento, la sicurezza delle chiavi API e i limiti di utilizzo.

Modello account

Un account Cryptohopper è l'autorità principale per tutto ciò che è descritto in questa documentazione. L'account contiene:

• Il livello di abbonamento attivo (Pioneer, Explorer, Adventurer, Hero).
• L'insieme delle chiavi API (con limiti per livello su quante possono esistere simultaneamente).
• Il contatore di utilizzo settimanale corrente e il momento del reset.
• L'elenco degli exchange che l'account ha il permesso di interrogare.

Tutte le richieste MCP si autenticano tramite una chiave API, che a sua volta si riferisce a un account. Tutti i limiti descritti in questa documentazione sono applicati per account.

Chiavi API

Una chiave API è un token bearer emesso dall'account. Viene presentata nell'header Authorization di ogni richiesta MCP:

Authorization: Bearer 

Proprietà delle chiavi

Proprietà	Descrizione
Proprietà	Le chiavi sono collegate all'account che le ha create.
Ambito	Tutte le chiavi di un account condividono accesso identico — stesso livello, stessi exchange, stessa quota.
Revoca	Le chiavi possono essere revocate in qualsiasi momento tramite l'interfaccia dell'account Cryptohopper. La revoca ha effetto immediato.
Rotazione	Una nuova chiave può essere creata e una vecchia chiave revocata in modo indipendente.
Quota	Le chiavi condividono la singola quota settimanale dell'account. Creare chiavi aggiuntive non aumenta la quota.

Quando usare più chiavi

Il numero di chiavi che un account può contenere dipende dal livello (vedi livelli di abbonamento). Più chiavi sono utili per:

• Separazione per agente. Diversi agenti AI o flussi di lavoro ricevono ciascuno la propria chiave. Quando ruoti o revochi una chiave, solo l'agente proprietario è interessato.
• Separazione per ambiente. Una chiave di produzione e una chiave di sviluppo, ciascuna revocabile indipendentemente.
• Attribuzione. I log di utilizzo (dove disponibili) possono essere ispezionati per chiave per identificare quale consumatore sta utilizzando la quota.

Più chiavi non influenzano la quota. Tutte le chiavi condividono lo stesso limite settimanale a livello di account. Vedi come eseguire più agenti con più chiavi API.

Utilizzo

L'utilizzo è tracciato per account, in unità di chiamata. Il contatore settimanale si incrementa ogni volta che viene invocato uno strumento. Vedi spiegazione dei limiti di utilizzo per come le chiamate si traducono in unità.

L'MCP espone uno strumento di ispezione che restituisce lo stato di utilizzo corrente:

Campo	Tipo	Descrizione
tier	string	Il livello di abbonamento attivo.
calls_used	integer	Unità utilizzate nel ciclo settimanale corrente.
calls_limit	integer	Il limite settimanale del livello.
reset_at	string (ISO-8601)	Timestamp del prossimo reset settimanale.

Vedi utilizzo e limiti per lo schema di risposta completo e invocazioni di esempio.

Reset settimanale

Tutti gli account condividono la stessa cadenza di reset: il contatore settimanale si azzera ogni venerdì. Il momento preciso del reset per account è stabile tra le settimane ed è restituito nel campo reset_at.

Gli errori legati all'utilizzo (QUOTA_EXCEEDED) si risolvono automaticamente al momento del reset.

Livello e copertura exchange

Il livello dell'account determina:

• Quali exchange possono essere interrogati tramite l'MCP.
• Quanti dati storici delle candele possono essere richiesti.
• Quante chiavi API possono esistere simultaneamente.
• Il limite di chiamate settimanali e il fattore di costo per i dati storici.

Vedi livelli di abbonamento per la matrice completa e exchange supportati per l'elenco degli exchange.

Errore di autenticazione

Una chiave API non valida, revocata o malformata restituisce una risposta 401 Unauthorized, mappata a un errore UNAUTHORIZED nello schema di errore MCP. Vedi riferimento errori.

Considerazioni sulla sicurezza

Le chiavi API garantiscono accesso in lettura ai dati di mercato nel livello dell'account. Non garantiscono accesso ai bot Cryptohopper, alle credenziali API degli exchange o all'account stesso. Tuttavia, le chiavi compromesse consumano quota e possono contribuire al rumore dei limiti di utilizzo.

Vedi best practice per la sicurezza delle chiavi API per indicazioni su:

• Archiviazione e gestione dei segreti.
• Cadenza di rotazione delle chiavi.
• Revoca delle chiavi compromesse.
• Separazione delle chiavi per ambiente.

Relazione con l'API Trading Cryptohopper

L'MCP Cryptohopper e l'API REST Trading di Cryptohopper utilizzano token di autenticazione separati emessi sotto lo stesso account. Una chiave MCP non autorizza chiamate all'API Trading e viceversa.

Per agenti end-to-end che utilizzano l'MCP per la ricerca e l'API Trading per l'esecuzione, sono richieste entrambe le credenziali. Vedi Combinare MCP + API Trading Cryptohopper per agenti end-to-end.

Controllo dello stato dell'account da un client MCP Le query comuni effettuate da un client compatibile MCP:

Qual è il mio attuale livello MCP Cryptohopper? Quanto della mia quota settimanale ho utilizzato? Quali exchange posso interrogare?

Ognuna di queste si indirizza allo strumento corrispondente e restituisce una risposta strutturata che il modello riassume.