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