Passer au contenu principal

Qu’est-ce que les limites de taux ?

Les limites de taux contrôlent combien de requêtes vous pouvez faire par seconde. Lorsque les limites de taux sont dépassées, vous recevrez une réponse HTTP 429. Pour savoir quoi faire lorsque vous atteignez un 429 ou une autre défaillance transitoire, consultez Reprises et gestion des erreurs ci-dessous.

Limites de Taux Standard

Votre plan dispose de deux groupes de limites de taux standard : un pour les requêtes RPC et un pour les requêtes API DAS. Voici les limites de taux de base pour chaque plan Helius :
PlanLimite de Taux RPCDAS & Enhanced APIs
Gratuit10 requêtes/s2 requêtes/s
Développeur50 requêtes/s10 requêtes/s
Entreprise200 requêtes/s50 requêtes/s
Professionnel500 requêtes/s100 requêtes/s
EntreprisePersonnaliséPersonnalisé

Augmenter les limites de débit

Les équipes disposant d’un forfait Professional peuvent acheter 100 RPS supplémentaires pour 100 USD par mois. Si vous avez besoin de limites de taux personnalisées avant les lancements, contactez notre équipe commerciale. Si vous êtes sur le niveau Développeur ou Entreprise, veuillez mettre à niveau votre plan pour augmenter vos limites de taux.

Limites de Taux Spéciales

Certains points de terminaison et produits spécialisés Helius ont des limites de taux spéciales en raison de leurs exigences computationnelles.

Envoi de Transactions

Point de terminaisonGratuitDéveloppeurEntrepriseProfessionnel
Sender50/sec50/sec50/sec50/sec
sendTransaction1/sec5/sec50/sec100/sec
sendBundle——5/sec5/sec
simulateBundle10/sec50/sec200/sec500/sec
Les requêtes /fast sans clé de Sender sont limitées à 1 requête par seconde et par adresse IP de sortie, dans chaque région. Les appelants situés derrière le même NAT partagent cette limite. Les requêtes 429 rejetées sont comptabilisées dans la limite, contrairement à /ping. Ajoutez la clé API de votre projet Helius existant pour bénéficier d’une limite de 50 requêtes par seconde, par clé et par région.
Si vous disposez d’un forfait Professional et devez augmenter vos limites de débit sendTransaction, contactez notre équipe commerciale. Les utilisateurs du forfait Professional peuvent également demander une augmentation des limites de débit et des modalités de pourboire personnalisées pour Sender afin de prendre en charge les applications de trading à plus haut débit.

Appels RPC complexes

Point de terminaisonGratuitDeveloperBusinessProfessional
getProgramAccounts5/s25/s50/s75/s

Données historiques

Lors de l’envoi de requêtes par lots pour les méthodes de données historiques, les limites suivantes s’appliquent :
MéthodeTaille maximale du lot
getTransaction100 éléments par requête
getTransactionsForAddressRequêtes par lots non autorisées
getTransfersByAddressRequêtes par lots non autorisées
Toutes les autres méthodes de données historiques10 éléments par requête
Le dépassement des limites de lots génère une réponse d’erreur. Pour getTransactionsForAddress et getTransfersByAddress, chaque adresse doit faire l’objet d’une requête distincte.

LaserStream

RessourceGratuitDeveloperBusinessProfessional
Réseaux—DevnetDevnet, MainnetDevnet, Mainnet
Nombre maximal de clés publiques—10M10M10M
Connexions actives——10100

API Wallet

L’API Wallet applique les mêmes limites de débit que DAS et les API Enhanced. Tous les points de terminaison partagent ces limites :
Point de terminaisonGratuitDeveloperBusinessProfessional
Tous les points de terminaison de l’API Wallet2/s10/s50/s100/s
Cela inclut les points de terminaison pour les recherches d’identité, les soldes, l’historique, les transferts et les sources de financement. Pour en savoir plus, consultez notre documentation de l’API Wallet.

Flux analysés

RessourceGratuitDeveloperBusinessProfessional
Connexions simultanées5105050
Abonnements par connexion25252525
Les connexions sont comptabilisées par projet, pour l’ensemble de ses clés API. Un projet qui atteint sa limite de connexions reçoit un code HTTP 429. Consultez les limites des flux analysés pour connaître les limites par filtre et par message.

WebSocket LaserStream

RessourceGratuitDeveloperBusinessProfessional
Connexions simultanées51502501,000
Abonnements par connexion1,0001,0001,0001,000
Types de WebSocketStandardStandard, EnhancedStandard, EnhancedStandard, Enhanced

Webhooks

RessourceGratuitDeveloperBusinessProfessional
Nombre maximal de webhooks5505050
Adresses par webhook100k100k100k100k

Compression ZK

ServiceGratuitDeveloperBusinessProfessional
API Photon2/s10/s50/s100/s
getValidityProof1/s5/s10/s20/s

Nouvelles tentatives et gestion des erreurs

Lorsque votre application reçoit une réponse 429 Too Many Requests, 503 Service Unavailable ou une réponse transitoire 5xx, attendez un moment avant de réessayer. Ne réessayez pas immédiatement. Les nouvelles tentatives immédiates accumulent les requêtes et ralentissent le rétablissement après une limitation de débit au lieu de l’accélérer.

Stratégie recommandée

  • Attendez environ 1 seconde avant la première nouvelle tentative.
  • Doublez le temps d’attente à chaque nouvelle tentative, jusqu’à un maximum de 30 secondes.
  • Ajoutez une petite variation aléatoire de ±25 % à chaque attente afin que plusieurs applications ne réessaient pas toutes au même instant.
  • Abandonnez après 5 tentatives et renvoyez l’erreur au code appelant.

Erreurs pour lesquelles réessayer

Exemple

Format de la réponse d’erreur

Toutes les API Helius renvoient un corps JSON structuré en cas d’erreur. Les points de terminaison JSON-RPC (RPC Solana, DAS, Sender, Priority Fee, compression ZK) renvoient l’enveloppe JSON-RPC 2.0 standard :
Les points de terminaison REST (API Wallet, API Admin) renvoient :
Consultez les codes d’erreur courants pour obtenir la liste complète des codes d’erreur et leur signification.