Foutmeldingenreferentie

Deze pagina bevat een overzicht van de foutmeldingen die door de Cryptohopper Market Data MCP worden geretourneerd en beschrijft de oorzaak en aanbevolen afhandeling voor elke foutmelding.

Voor een taakgerichte probleemoplossingsgids, zie problemen met veelvoorkomende MCP-fouten oplossen.

Foutmeldingenformaat

Foutmeldingen worden naar de MCP-client geretourneerd in de standaard MCP-foutmeldingenenvelope. De velden:

Veld	Type	Beschrijving
code	string	Een stabiele identifier in hoofdletters (bijv. QUOTA_EXCEEDED).
message	string	Een mensleesbare beschrijving.
details	object	Optionele gestructureerde context.

De code is het stabiele contract. Clients moeten vertakken op basis van code, niet op basis van de tekst van message.

Authenticatiefouten

UNAUTHORIZED

De API-sleutel ontbreekt, is onjuist geformatteerd, verlopen of ingetrokken.

Veelvoorkomende oorzaken:

• Geen Authorization-header in het verzoek.
• Onjuist geformatteerde bearer-token (witruimte, kopieer-plak-artefacten).
• Sleutel is ingetrokken in de Cryptohopper-accountinterface.
• Sleutel is gegenereerd voor een ander product en is niet geldig voor de MCP.

Afhandeling: genereer de sleutel opnieuw via de Cryptohopper-accountinterface en configureer de client opnieuw. Zie best practices voor API-sleutelbeveiliging en hoe je een Cryptohopper MCP API-sleutel krijgt.

FORBIDDEN

Het verzoek is geauthenticeerd, maar het account heeft geen toestemming om de gevraagde actie uit te voeren.

Veelvoorkomende oorzaken:

• Account is opgeschort of gemarkeerd.
• Het endpoint is beperkt voor het account.

Afhandeling: neem contact op met Cryptohopper-ondersteuning. Het opnieuw genereren van de sleutel zal deze foutmelding niet oplossen.

Quota- en limietfouten

QUOTA_EXCEEDED

Het account heeft de wekelijkse oproeplimiet bereikt.

Afhandeling: wacht tot de volgende reset (vrijdag), upgrade het abonnementsniveau of controleer oproeppatronen om het gebruik te verminderen. Het veld details.reset_at bevat de tijdstempel van de volgende reset.

Zie limieten uitgelegd en abonnementsniveaus.

RATE_LIMIT_EXCEEDED

Het account heeft de limiet voor korte-intervaloproepen overschreden.

Afhandeling: probeer het opnieuw na een korte vertraging. Goed gedragende clients vertragen exponentieel; een eerste herpoging na 500 ms is doorgaans voldoende. Als de foutmelding terugkeert, voeg dan een kleine vertraging toe tussen opeenvolgende oproepen in jouw workflow.

HISTORY_LIMIT_EXCEEDED

Een kaarsverzoek specificeerde een terugkijkperiode die groter is dan het maximale geschiedenisbereik van het actieve niveau.

Afhandeling: verklein de terugkijkperiode of upgrade naar een niveau met diepere geschiedenis. Zie abonnementsniveaus.

Niveau- en toegangsfouten

EXCHANGE_NOT_SUPPORTED

De gevraagde beurs is niet beschikbaar voor het actieve niveau, of wordt helemaal niet ondersteund door de MCP.

Afhandeling: bevestig dat de beurs in de toegestane lijst van het niveau staat in ondersteunde beurzen. Als de beurs voor een hoger niveau wordt vermeld, upgrade dan. Als de beurs helemaal niet wordt vermeld, wordt de beurs niet ondersteund.

PAIR_NOT_FOUND

Het gevraagde paar bestaat niet op de gespecificeerde beurs, of het paarsymbool is onjuist geformatteerd.

Afhandeling: verifieer het paarsymbool met behulp van de list-pairs-tool. Paarsymbolen gebruiken het BASE/QUOTE-formaat (bijv. BTC/USDT).

TIMEFRAME_NOT_SUPPORTED

Het gevraagde kaarstijdvenster (interval) wordt niet ondersteund voor deze beurs of dit paar.

Afhandeling: gebruik een ondersteund tijdvenster. Zie kaarstoolreferentie.

Verzoekfouten

INVALID_PARAMETER

Eén of meer toolargumenten zijn niet gevalideerd.

Veelvoorkomende oorzaken:

• Terugkijkperiode kleiner dan 1 of boven het niveaumaximum.
• Niet-stringwaarden waar strings vereist zijn.
• Onjuist geformatteerde beurs- of paaridentifiers.

Afhandeling: het details-object bevat de onjuiste parameter. Corrigeer en probeer het opnieuw.

MISSING_PARAMETER

Een vereist argument is niet opgegeven.

Afhandeling: het details-object noemt de ontbrekende parameter. Corrigeer en probeer het opnieuw.

Upstreamfouten

EXCHANGE_UNAVAILABLE

De onderliggende beursAPI reageert niet of retourneert fouten. Dit is doorgaans tijdelijk.

Afhandeling: probeer het opnieuw na een korte vertraging. Als de foutmelding aanhoudt over meerdere beurzen, kan dit duiden op een incident aan MCP-zijde — controleer de Cryptohopper-statuspagina.

DATA_UNAVAILABLE

De gevraagde data bestaat conceptueel, maar is tijdelijk niet beschikbaar (bijvoorbeeld een kaarsreeks die nog niet is gevuld).

Afhandeling: probeer het opnieuw na een vertraging. Voor langdurige uitval, kies een andere beurs of een ander paar.

Serverfouten

INTERNAL_ERROR

Er is een onverwachte fout opgetreden in de MCP-server.

Afhandeling: probeer het één keer opnieuw. Als de foutmelding aanhoudt, meld dit dan via Cryptohopper-ondersteuning met de details.trace_id indien aanwezig.

SERVICE_UNAVAILABLE

De MCP-service kan tijdelijk geen verzoeken verwerken. Meestal tijdens onderhoud of bij ongewone belasting.

Afhandeling: probeer het opnieuw na een vertraging. Controleer de Cryptohopper-statuspagina voor lopende incidenten.

Snelreferentietabel

Code	Categorie	Opnieuw proberen?	Oplossing
UNAUTHORIZED	Auth	Nee	Genereer sleutel opnieuw
FORBIDDEN	Auth	Nee	Neem contact op met ondersteuning
QUOTA_EXCEEDED	Quota	Bij reset	Upgrade niveau of verminder gebruik
RATE_LIMIT_EXCEEDED	Quota	Na vertraging	Vertraag client
HISTORY_LIMIT_EXCEEDED	Niveau	Nee	Verklein terugkijkperiode / upgrade niveau
EXCHANGE_NOT_SUPPORTED	Niveau	Nee	Controleer toegestane lijst van niveau
PAIR_NOT_FOUND	Verzoek	Nee	Verifieer paarsymbool
TIMEFRAME_NOT_SUPPORTED	Verzoek	Nee	Gebruik ondersteund tijdvenster
INVALID_PARAMETER	Verzoek	Nee	Corrigeer parameter
MISSING_PARAMETER	Verzoek	Nee	Voeg parameter toe
EXCHANGE_UNAVAILABLE	Upstream	Ja	Korte herpoging
DATA_UNAVAILABLE	Upstream	Ja	Vertraging en dan opnieuw proberen
INTERNAL_ERROR	Server	Eén keer	Meld als aanhoudend
SERVICE_UNAVAILABLE	Server	Ja	Vertraging en dan opnieuw proberen