Livelli di sottoscrizione
Questa pagina documenta i livelli di sottoscrizione disponibili per Cryptohopper Market Data MCP.
Riepilogo livelli
| Pioneer | Explorer | Adventurer | Hero | |
|---|---|---|---|---|
| Costo | Gratuito | A pagamento | A pagamento | A pagamento |
| Limite chiamate settimanali | 6.000 | 30.000 | 150.000 | 1.250.000 |
| Exchange | 3 | 8 | Tutti supportati | Tutti supportati |
| Dati storici | Nessuno | Fino a 90 giorni | Fino a 365 giorni | Fino a 3 anni |
| Fattore di costo storico | — | 5× / 20× | 5× / 20× | 1× (fisso) |
| Chiavi API consentite | 1 | 1 | 3 | 10 |
Tutti i limiti si rinnovano ogni venerdì. Il limite di chiamate settimanali e il rate limit si applicano per account utente, non per chiave API.
Per i prezzi attuali dei livelli a pagamento, consulta la pagina dei prezzi di Cryptohopper.
Limite chiamate settimanali
Ogni livello ha un numero fisso di chiamate che possono essere effettuate per settimana. Le chiamate vengono conteggiate per invocazione dello strumento. Una singola invocazione dello strumento conta come unità di base, soggetta al fattore di costo storico descritto di seguito.
Il contatore settimanale si azzera ogni venerdì. L'orario esatto di reset è registrato per l'account utente ed è visibile tramite l'endpoint di utilizzo. Vedi utilizzo e limiti.
Le richieste effettuate dopo il raggiungimento del limite settimanale restituiscono un errore QUOTA_EXCEEDED fino al prossimo reset. Vedi riferimento errori.
Accesso agli exchange
L'accesso agli exchange è limitato per livello. Il livello Pioneer è limitato a tre exchange; Explorer estende questo numero a otto; Adventurer e Hero espongono l'elenco completo.
Vedi exchange supportati per la matrice completa.
Le richieste verso un exchange non incluso nell'elenco consentito per il livello attuale restituiscono un errore EXCHANGE_NOT_SUPPORTED.
Dati storici
I dati storici si riferiscono alle query di candele con un periodo di lookback superiore alla barra più recente.
| Livello | Disponibilità storica |
|---|---|
| Pioneer | Non disponibile. Viene restituita solo la candela attuale (in tempo reale). |
| Explorer | Fino a 90 giorni di storico. |
| Adventurer | Fino a 365 giorni di storico. |
| Hero | Fino a 3 anni di storico. |
Le richieste che superano il limite storico del livello attuale restituiscono un errore HISTORY_LIMIT_EXCEEDED.
Le query di ticker e registro degli ordini sono sempre in tempo reale e non sono soggette al limite storico.
Fattore di costo per i dati storici
Sui livelli Explorer e Adventurer, le query di candele storiche vengono addebitate con un moltiplicatore rispetto all'unità di base per chiamata:
| Profondità lookback | Moltiplicatore costo |
|---|---|
| Storico breve (recente) | 5× |
| Storico lungo (vicino al limite del livello) | 20× |
Sul livello Hero, tutte le query storiche vengono addebitate a 1× indipendentemente dalla profondità del lookback.
Le query di ticker e registro degli ordini vengono sempre addebitate a 1× su tutti i livelli.
Le soglie esatte tra storico "breve" e "lungo", e la matrice completa dei costi, sono documentate in spiegazione dei rate limits.
Chiavi API
Ogni livello consente un numero massimo di chiavi API attive simultaneamente:
| Livello | Chiavi massime |
|---|---|
| Pioneer | 1 |
| Explorer | 1 |
| Adventurer | 3 |
| Hero | 10 |
Le chiavi API vengono generate e revocate tramite l'interfaccia dell'account Cryptohopper.
Quota per account. La creazione di chiavi aggiuntive non aumenta il limite di chiamate settimanali. Tutte le chiavi associate a un account condividono la stessa quota settimanale e lo stesso rate limit. Le chiavi vengono utilizzate per segmentazione e rotazione, non per moltiplicazione della quota. Vedi come eseguire più agenti con più chiavi API.
Vedi best practice per la sicurezza delle chiavi API.
Rate limits
I rate limits si applicano a livello di account e sono uniformi su tutti i livelli. I dettagli sono documentati in spiegazione dei rate limits.
Upgrade e downgrade
Le modifiche di livello diventano effettive all'inizio del ciclo settimanale successivo. Il downgrade a un livello con un limite inferiore di chiavi API potrebbe richiedere la revoca di chiavi per rientrare nel nuovo limite consentito.
Verifica del livello attivo
Il livello attuale viene restituito dall'endpoint di utilizzo come campo tier. Vedi utilizzo e limiti.
Esempio di query tramite un client MCP:
Qual è il mio livello attuale di Cryptohopper MCP e quanto della mia quota settimanale ho utilizzato?