Référence

Limites

Vos limites dépendent de vos offres et s’appliquent à tout votre compte, toutes clés confondues. Suivez votre consommation à tout moment avec GET /v1/usage.

Limites par offre

Live et Historique se cumulent : avec les deux, vous avez les droits des deux. Ce que comprend chaque offre et comment l’acheter : Offres et facturation.

Limite	Sandbox	Live	Historique	Live + Historique
Facturation	Gratuite	Abonnement mensuel	Achat unique, accès à vie	Abonnement mensuel + Achat unique, accès à vie
Stream	Différé de 10 min	Temps réel	Différé de 10 min	Temps réel
Connexions simultanées	1	5	1	5
Subscriptions simultanées	2	50	2	50
Configurations personnalisées	1	25	1	25
Historique	7 derniers jours	Non inclus	Toute la profondeur disponible	Toute la profondeur disponible
Compute budget par mois	50 000 000 compute units	Non inclus	20 000 000 000 compute units	20 000 000 000 compute units
Volume d’export par mois	Non inclus	Non inclus	20 Go	20 Go
Requêtes REST par clé	60 par minute	300 par minute	1 200 par minute	1 200 par minute

Comment les limites sont comptées

Par compte : connexions, subscriptions et budgets sont partagés entre toutes vos clés. Créer plus de clés n’augmente pas vos limites.
Configurations personnalisées : un indicateur utilisé sur un instrument avec des paramètres différents de ses valeurs par défaut. Par exemple, Fathom Trades avec un volume minimum de 50 au lieu de 30. Chaque combinaison compte une seule fois, même si plusieurs subscriptions l’utilisent.
Compute budget : chaque accès à l’historique (requête, export ou subscription qui démarre dans le passé) consomme des compute units : le nombre de trades lus, multiplié par le coût de l’indicateur indiqué dans le catalogue. Vous pouvez estimer ce coût à l’avance, gratuitement.
Volume d’export : la quantité de données téléchargées par vos exports.

Le compute budget et le volume d’export se renouvellent au début de chaque mois (UTC), y compris avec l’accès à vie de l’offre Historique. Une requête qui les dépasserait est refusée avant d’être lancée, avec 429 QUOTA_EXCEEDED.

Limites techniques

Elles sont identiques pour toutes les offres.

Élément	Limite	Si vous la dépassez
Requêtes REST	Selon votre offre, par minute et par clé	`429 RATE_LIMITED`
Taille d’une requête REST	16 Ko	`413`
Clés actives	10 par compte	`409 QUOTA_EXCEEDED`
Instruments et adresses IP autorisés par clé	32 de chaque	`400 INVALID_PARAMETERS`
Grace period lors de la rotation d’une clé	7 jours au plus	`400 INVALID_PARAMETERS`
Liens de connexion envoyés par e-mail	5 par heure et par adresse, valables 15 minutes	`429 RATE_LIMITED`
Stream token pour navigateur	Valable 60 s, utilisable une seule fois	Connexion fermée (`4001`)
Message `auth` après l’ouverture du WebSocket	5 s	Connexion fermée (`4001`)
Message envoyé sur le WebSocket	64 Ko	Connexion coupée
Nom de subscription (`sub`)	1 à 64 bytes, unique sur la connexion	`error` `INVALID_PARAMETERS`
Reprise par cursor	Coupure d’environ 15 minutes au plus	`reset` puis nouveau snapshot
Buffer d’envoi (client trop lent)	256 Ko, puis 1 Mo	Versions intermédiaires sautées, puis connexion fermée (`4008`)
Silence de votre client	30 s	Connexion fermée (`4008`)
Résultats par page d’historique	1 à 10 000 (1 000 par défaut)	Page suivante via `next`
Calcul conservé après le dernier `unsubscribe`	10 minutes	`warming` à la prochaine subscription

Requêtes par minute

Chaque clé peut envoyer un certain nombre de requêtes REST par minute, selon votre offre. Les requêtes non utilisées s’accumulent jusqu’à cette limite. Chaque réponse indique où vous en êtes :

HTTP

RateLimit-Limit: 1200
RateLimit-Remaining: 1197
RateLimit-Reset: 1

RateLimit-Remaining : les requêtes encore disponibles tout de suite ;
RateLimit-Reset : le nombre de secondes avant de retrouver la limite complète.

Au-delà, la requête est refusée avec 429 RATE_LIMITED ; le header Retry-After indique combien de secondes attendre. Le SDK attend et réessaie automatiquement.

Suivre votre consommation

BASH

curl https://api.fathomcharts.com/v1/usage -H "Authorization: Bearer $FATHOM_CHARTS_API_KEY"

JSON

{
  "period": "2026-10",
  "resetsAt": "1793491200000000000",
  "plan": "live_history",
  "limits": {
    "computeBudget": 20000000000,
    "exportBytes": 21474836480,
    "restPerMinute": 1200,
    "historyDays": 36500,
    "delaySeconds": 0,
    "maxConnections": 5,
    "maxSubscriptions": 50,
    "maxCustomConfigs": 25,
    "realtime": true
  },
  "used": { "computeUnits": 1840233, "historyItems": 51207, "exportBytes": 734003200, "restRequests": 412 },
  "remaining": { "computeUnits": 19998159767, "exportBytes": 20740833280 }
}

plan : vos offres, soit sandbox, live, history ou live_history (les deux) ;
period et resetsAt : le mois en cours et la date du prochain renouvellement ;
limits : les limites qui s’appliquent à vous. Avec une clé de test, ce sont celles de la Sandbox. historyDays vaut 0 sans historique, et 36500 pour toute la profondeur disponible ;
used et remaining : votre consommation du mois et ce qu’il vous reste.