Περιορισμοί ρυθμού δημόσιας πρόσβασης (δεδομένα αγοράς)
Περιορισμοί ρυθμού ιδιωτικής πρόσβασης (διαχείριση λογαριασμού)
Περιορισμοί ρυθμού συναλλαγών (τοποθέτηση/ακύρωση εντολών)
Τα REST και WebSocket API μας διαθέτουν περιορισμούς ρυθμού που καθορίζουν τον αριθμό των κλήσεων που μπορούν να πραγματοποιηθούν σε σύντομο χρονικό διάστημα. Οι περιορισμοί ρυθμού έχουν σχεδιαστεί για να προστατεύουν τα API από επιθέσεις (όπως επιθέσεις DDoS) και να αποτρέπουν την παραποίηση των βιβλίων εντολών μας (π.χ. μέσω ταχείας τοποθέτησης και ακύρωσης μεγάλων εντολών).
Οι περιορισμοί ρυθμού του Spot API χωρίζονται σε τρεις ενότητες (δημόσια, ιδιωτική, συναλλαγές) ανάλογα με τη διεπαφή API που χρησιμοποιείται (REST ή WebSocket) και τον τύπο της κλήσης (δεδομένα αγοράς, διαχείριση λογαριασμού, τοποθέτηση/ακύρωση εντολών). Για τα όρια αιτημάτων που αφορούν κλήσεις futures (REST) API, ανατρέξτε στο άρθρο υποστήριξης εδώ.
Δημόσια πρόσβαση (REST — Δεδομένα Αγοράς)
Τα δημόσια endpoint του Spot υπόκεινται σε περιορισμό ρυθμού ανά Διεύθυνση IP και ζεύγος νομισμάτων για κλήσεις προς Trades και OHLC, και ανά Διεύθυνση IP μόνο για κλήσεις προς όλα τα υπόλοιπα δημόσια endpoint.
Η κλήση των δημόσιων endpoint με συχνότητα έως 1 ανά δευτερόλεπτο παραμένει εντός των περιορισμών ρυθμού· η υπέρβαση αυτής της συχνότητας ενδέχεται να προκαλέσει περιορισμό των κλήσεων. Εάν οι περιορισμοί ρυθμού επιτευχθούν, οι επιπλέον κλήσεις θα περιοριστούν για μερικά δευτερόλεπτα (ή και περισσότερο, εάν συνεχίζονται κλήσεις ενώ οι περιορισμοί παραμένουν ενεργοί).
Ιδιωτική πρόσβαση (REST — Διαχείριση Λογαριασμού)
Τα ιδιωτικά endpoint του Spot υπόκεινται σε περιορισμό ρυθμού ανά κλειδί API, βάσει ενός μετρητή που ξεκινά από 0, αυξάνεται με κάθε κλήση και μειώνεται σταδιακά με την πάροδο του χρόνου. Ο μετρητής κάθε κλειδιού API είναι ανεξάρτητος· εάν υπερβεί τη μέγιστη τιμή, οι επόμενες κλήσεις που χρησιμοποιούν το ίδιο κλειδί API θα υποστούν περιορισμό ρυθμού. Εάν οι περιορισμοί ρυθμού επιτευχθούν, οι επιπλέον κλήσεις θα περιοριστούν για μερικά δευτερόλεπτα (ή και περισσότερο, εάν συνεχίζονται κλήσεις ενώ οι περιορισμοί παραμένουν ενεργοί).
API endpoint | Αύξηση μετρητή (ανά αίτημα) |
|---|---|
Endpoint ιστορικού λογαριασμού (Ledgers, TradesHistory, ClosedOrders) | +4 |
Endpoint staking (Stake, Unstake) | +1 |
Όλα τα υπόλοιπα endpoints (Balance, TradeBalance κ.λπ.) | +1 |
Endpoint συναλλαγών (AddOrder, CancelOrder κ.λπ.) | 0 (χωρίς επίδραση στον μετρητή) |
Επίπεδο Λογαριασμού | Μέγιστη τιμή μετρητή | Μείωση μετρητή (ανά δευτερόλεπτο) |
|---|---|---|
Standard | 20 | -0,5 |
Υψηλότερα όρια | 20 | -1 |
Συναλλαγές (REST και WebSocket — Τοποθέτηση/Ακύρωση Εντολών)
Τα Spot endpoints συναλλαγών (REST AddOrder/CancelOrder και WebSocket addOrder/cancelOrder) υπόκεινται σε περιορισμό ρυθμού ανά λογαριασμό και ανά ζεύγος νομισμάτων, με βάση τον τρόπο αλληλεπίδρασης των εντολών με το βιβλίο εντολών.
Συνοπτικά (TLDR), κάθε λογαριασμός και ζεύγος νομισμάτων διαθέτει έναν μέγιστο αριθμό πόντων που μπορούν να χρησιμοποιηθούν ανά δευτερόλεπτο χωρίς να ενεργοποιηθούν οι περιορισμοί ρυθμού συναλλαγών. Η τοποθέτηση, εκτέλεση και ακύρωση εντολών καταναλώνει αυτούς τους πόντους, ενώ η πάροδος του χρόνου τους αναπληρώνει. Η χρήση περισσότερων πόντων από το επιτρεπόμενο όριο (με βάση τον τύπο λογαριασμού σας) θα επιφέρει περιορισμό ρυθμού στις επόμενες κλήσεις.
Πλήρεις λεπτομέρειες των περιορισμών ρυθμού συναλλαγών παρέχονται ώστε οι traders μας να μπορούν να υπολογίζουν τον ακριβή αριθμό εντολών που μπορούν να τοποθετήσουν, να εκτελέσουν ή να ακυρώσουν με βάση τη στρατηγική τους (ποσοστό εκτέλεσης εντολών, χρόνος παραμονής στο βιβλίο εντολών κ.λπ.). Για διευκόλυνσή σας, παρέχονται παραδείγματα για διαφορετικούς τύπους λογαριασμών και βασικές στρατηγικές συναλλαγών, καθώς και υπολογιστής περιορισμών ρυθμού για πιο σύνθετες στρατηγικές.