Erreurs

Chaque erreur porte un code, le même en REST et sur le WebSocket. Basez votre logique sur ce code : le texte du message peut évoluer, le code jamais.

En REST

{
  "type": "https://fathomcharts.com/docs/errors#invalid-parameters",
  "title": "Invalid parameters",
  "status": 400,
  "detail": "Invalid indicator parameters",
  "code": "INVALID_PARAMETERS",
  "instance": "req-1b",
  "errors": [
    { "path": "/minimum", "message": "must be >= 1" }
  ]
}

• code : le code de l’erreur, listé ci-dessous ;
• detail : une explication lisible ;
• errors : pour INVALID_PARAMETERS, la liste des problèmes, avec l’emplacement du champ fautif (path) ;
• instance : l’identifiant de la requête, à communiquer au support si besoin.

Quand une requête historique ou un export dépasse votre budget, la réponse indique aussi son coût (computeUnits) et ce qu’il vous reste (remainingComputeUnits). Les réponses 429 portent un header Retry-After : le nombre de secondes à attendre.

Sur le WebSocket

Une subscription refusée ou interrompue reçoit un message error avec son sub. Seule cette subscription est fermée : la connexion et les autres subscriptions continuent.

{"sub":"bt","t":"error","code":"UNKNOWN_INDICATOR","message":"unknown indicator `big-trade`"}

Un message que le serveur ne comprend pas (JSON invalide, type inconnu…) reçoit un error sans sub.

Avec le SDK, l’erreur d’une subscription arrête son itération avec une FathomChartsError qui porte le code reçu.

Les problèmes qui ferment toute la connexion (clé refusée, trop de connexions, client trop lent) ne passent pas par un message error mais par un close code.

Liste des codes