Limitation de débit et quotas
Comprenez les limites de débit de l'API Smart Money, les quotas quotidiens pour chaque niveau d'abonnement et les stratégies d'optimisation pour maximiser votre utilisation de l'API.
Aperçu
L'API Smart Money applique des quotas de requêtes quotidiennes pour garantir la qualité du service et l'équité entre tous les utilisateurs. Chaque niveau d'abonnement inclut une limite quotidienne différente. Si vous dépassez votre quota quotidien, vous recevez une erreur 429 Too Many Requests jusqu'à ce que votre quota soit réinitialisé à minuit UTC.
Les limites de débit sont appliquées par clé API. Chaque clé a son propre quota indépendant. Vous pouvez générer plusieurs clés pour différentes applications et surveiller l'utilisation de chacune séparément.
Quotas par niveau d'abonnement
| Niveau | Requêtes quotidiennes | Prix | Fonctionnalités |
|---|---|---|---|
| Gratuit | 20 requêtes/jour | $0 | BTC, ETH, SOL, taux de financement, liquidations |
| Trader | 400 requêtes/jour | 29 $/mois | Tous les symboles, positions des baleines, données OI |
| Pro | 4 000 requêtes/jour | 79 $/mois | Scores de confirmation, données on-chain, webhooks |
| Entreprise | Personnalisé | Personnalisé | Support dédié, intégrations personnalisées |
En-têtes de réponse de limitation de débit
Chaque réponse de l'API inclut des en-têtes indiquant l'état actuel de votre quota :
| En-tête | Description |
|---|---|
X-Requests-Limit |
Total de requêtes autorisées par jour (par exemple, 200 pour Trader) |
X-Requests-Remaining |
Requêtes restantes dans la journée en cours |
X-Requests-Reset |
Horodatage Unix de la réinitialisation du quota |
X-Requests-Reset-ISO |
Horodatage ISO 8601 de la réinitialisation du quota |
Vérification du quota avant de faire des requêtes
Fenêtre de limitation quotidienne
Les limites de débit fonctionnent sur une fenêtre glissante de 24 heures. Votre quota est réinitialisé quotidiennement à minuit UTC (00:00 UTC). L'heure exacte de réinitialisation est fournie dans l'en-tête X-Requests-Reset-ISO .
Exemple : Niveau Trader (400 requêtes/jour)
- Jour 1 (21 mars) : 200 requêtes disponibles à 00:00 UTC
- 10:30 UTC : 75 requêtes effectuées, 125 restantes
- 15:45 UTC : 100 requêtes supplémentaires effectuées, 25 restantes
- 23:59 UTC : Encore 25 requêtes restantes (ne peuvent pas être reportées)
- Jour 2 (22 mars, 00:00 UTC) : Quota réinitialisé à 200
Stratégies d'optimisation
1. Mettre en cache les réponses de l'API
Les positions des baleines ne changent pas chaque seconde. Mettez en cache les résultats pendant 30 à 60 secondes et servez les données mises en cache au lieu de faire de nouveaux appels API.
2. Utiliser WebSocket pour les données en temps réel
Les connexions WebSocket fournissent des mises à jour instantanées sans compter dans votre limite de débit. Abonnez-vous aux flux et recevez les mises à jour en temps réel, réduisant ainsi le nombre d'appels REST API nécessaires.
3. Regrouper les requêtes stratégiquement
Faites une seule requête avec plusieurs symboles lorsque cela est possible au lieu de faire des requêtes séparées pour chaque symbole. Cela réduit les appels API jusqu'à 10 fois.
4. Utiliser le filtrage au moment de la requête
Appliquez des filtres (symbole, échange, taille minimale de position) dans les paramètres de requête pour obtenir exactement les données dont vous avez besoin, évitant ainsi le post-traitement.
Gestion des erreurs de limitation de débit
Réessayer avec un délai exponentiel
Prêt à passer à la version supérieure ?
Le niveau gratuit ne suffit pas ? Passez à Trader ou Pro pour des quotas plus élevés et accéder à des fonctionnalités avancées comme les scores de confirmation et les données on-chain.
Voir les tarifsOptimisez votre utilisation de l'API dès aujourd'hui
Mettez en œuvre la mise en cache, utilisez WebSocket pour les données en temps réel et gérez les limites de débit avec élégance.
Lire la documentationObtenez les flux de baleines en direct, les taux de financement, les intérêts ouverts et les données on-chain sur 3 échanges via une seule API. Niveau gratuit, sans carte de crédit, passez à la version supérieure à tout moment.
Commencez gratuitement →Prêt à construire ? Obtenez une clé API gratuite (200 appels/jour, sans carte) et commencez à récupérer les données de baleines, de financement et on-chain en direct.
Obtenez votre clé API →