Account, sleutels en gebruiksoverzicht

Deze pagina beschrijft hoe een Cryptohopper-account, de API-sleutels en het MCP-gebruik zich tot elkaar verhouden. Het is de conceptuele kaart die abonnementsniveaus, API-sleutelbeveiliging en gebruikslimieten met elkaar verbindt.

Accountmodel

Een Cryptohopper-account is de hoofdautoriteit voor alles wat in deze documentatie beschreven staat. Het account bevat:

• Het actieve abonnementsniveau (Pioneer, Explorer, Adventurer, Hero).
• De verzameling API-sleutels (met per niveau limieten voor hoeveel er tegelijkertijd kunnen bestaan).
• De huidige wekelijkse gebruiksteller en resettijd.
• De lijst met beurzen waarvoor het account toestemming heeft om gegevens op te vragen.

Alle MCP-verzoeken authenticeren tegen een API-sleutel, die op zijn beurt naar een account verwijst. Alle limieten die in deze documentatie beschreven staan, worden per account afgedwongen.

API-sleutels

Een API-sleutel is een bearer token uitgegeven door het account. Het wordt gepresenteerd in de Authorization-header van elk MCP-verzoek:

Authorization: Bearer 

Sleuteleigenschappen

Eigenschap	Beschrijving
Eigendom	Sleutels zijn gekoppeld aan het account dat ze heeft aangemaakt.
Bereik	Alle sleutels onder een account delen identieke toegang — hetzelfde niveau, dezelfde beurzen, hetzelfde quotum.
Intrekking	Sleutels kunnen op elk moment ingetrokken worden via de Cryptohopper-accountinterface. Intrekking wordt onmiddellijk van kracht.
Rotatie	Een nieuwe sleutel kan onafhankelijk aangemaakt worden en een oude sleutel ingetrokken.
Quotum	Sleutels delen het enkele wekelijkse quotum van het account. Extra sleutels aanmaken verhoogt het quotum niet.

Wanneer meerdere sleutels gebruiken

Het aantal sleutels dat een account kan bevatten hangt af van het niveau (zie abonnementsniveaus). Meerdere sleutels zijn handig voor:

• Scheiding per agent. Verschillende AI-agents of workflows krijgen elk hun eigen sleutel. Bij het roteren of intrekken van een sleutel wordt alleen de eigenaar van die agent beïnvloed.
• Scheiding per omgeving. Een productiesleutel en een ontwikkelsleutel, elk onafhankelijk in te trekken.
• Toewijzing. Gebruikslogboeken (waar beschikbaar) kunnen per sleutel geïnspecteerd worden om te identificeren welke gebruiker quotum verbruikt.

Meerdere sleutels hebben geen invloed op het quotum. Alle sleutels delen dezelfde wekelijkse limiet op accountniveau. Zie hoe je meerdere agents kunt uitvoeren met meerdere API-sleutels.

Gebruik

Gebruik wordt per account bijgehouden, in aantallen oproepen. De wekelijkse teller neemt toe elke keer dat een tool wordt aangeroepen. Zie uitleg over gebruikslimieten voor hoe oproepen zich vertalen naar eenheden.

De MCP stelt een inspectietool beschikbaar die de huidige gebruiksstatus retourneert:

Veld	Type	Beschrijving
tier	string	Het actieve abonnementsniveau.
calls_used	integer	Eenheden gebruikt in de huidige wekelijkse cyclus.
calls_limit	integer	De wekelijkse limiet van het niveau.
reset_at	string (ISO-8601)	Tijdstempel van de volgende wekelijkse reset.

Zie gebruik en limieten voor het volledige responschema en voorbeeldaanroepen.

Wekelijkse reset

Alle accounts delen dezelfde resetcadans: de wekelijkse teller wordt elke vrijdag gereset. De precieze resettijd per account is stabiel over weken heen en wordt geretourneerd in het veld reset_at.

Gebruiksgerelateerde fouten (QUOTA_EXCEEDED) worden automatisch opgelost bij de reset.

Niveau en beursdekking

Het niveau van het account bepaalt:

• Welke beurzen via de MCP bevraagd kunnen worden.
• Hoeveel historische kaarsgegevens kunnen worden opgevraagd.
• Hoeveel API-sleutels tegelijkertijd kunnen bestaan.
• De wekelijkse oproeplicentielimiet en kostenfactor voor historische gegevens.

Zie abonnementsniveaus voor de volledige matrix en ondersteunde beurzen voor de lijst met beurzen.

Authenticatiefout

Een ongeldige, ingetrokken of verkeerd opgemaakte API-sleutel retourneert een 401 Unauthorized-respons, toegewezen aan een UNAUTHORIZED-fout in het MCP-foutschema. Zie foutreferentie.

Beveiligingsoverwegingen

API-sleutels verlenen leestoegang tot marktgegevens onder het niveau van het account. Ze verlenen geen toegang tot Cryptohopper-bots, beurs-API-credentials of het account zelf. Desondanks verbruiken gecompromitteerde sleutels quotum en kunnen ze bijdragen aan gebruikslimietstoringen.

Zie best practices voor API-sleutelbeveiliging voor richtlijnen over:

• Opslag en beheer van geheimen.
• Sleutelrotatiecadans.
• Intrekken van gecompromitteerde sleutels.
• Scheiden van sleutels per omgeving.

Relatie tot de Cryptohopper Trading API

De Cryptohopper MCP en de Cryptohopper REST Trading API gebruiken afzonderlijke authenticatietokens uitgegeven onder hetzelfde account. Een MCP-sleutel autoriseert geen Trading API-oproepen, en omgekeerd.

Voor end-to-end agents die de MCP gebruiken voor onderzoek en de Trading API voor uitvoering, zijn beide credentials vereist. Zie Combineer MCP + Cryptohopper Trading API voor end-to-end agents.

Accountstatus controleren vanuit een MCP-client De veelgestelde vragen vanuit een MCP-compatibele client:

Wat is mijn huidige Cryptohopper MCP-niveau? Hoeveel van mijn wekelijkse quotum heb ik gebruikt? Welke beurzen mag ik bevragen?

Elk hiervan leidt naar de corresponderende tool en retourneert een gestructureerde respons die het model samenvat.