Openbare (marktdata) rate limits
Privé (accountbeheer) rate limits
Trading (plaatsen/annuleren van orders) rate limits
Onze REST en WebSocket API's hebben rate limits die van invloed zijn op het aantal aanroepen dat binnen korte tijd kan worden gedaan. De rate limits zijn ontworpen om de API's te beschermen tegen aanvallen (zoals DDoS-aanvallen) en om manipulatie van onze orderboeken te voorkomen (zoals door snel grote orders te plaatsen en te annuleren).
De Spot API rate limits zijn verdeeld in drie secties (openbaar, privé, trading), afhankelijk van de gebruikte API-interface (REST of WebSocket) en het type aanroep dat wordt gedaan (marktdata, accountbeheer, plaatsen/annuleren van orders). Voor Request Limits die zijn gekoppeld aan Futures (REST) API-aanroepen, raadpleegt u ons ondersteuningsartikel hier.
Openbaar (REST Marktdata)
De openbare Spot-endpoints hebben rate limits per IP-adres en valutapaar voor aanroepen naar Trades en OHLC, en alleen per IP-adres voor aanroepen naar alle andere openbare endpoints.
Het aanroepen van de openbare endpoints met een frequentie van 1 per seconde (of minder) valt binnen de rate limits, maar het overschrijden van deze frequentie kan ertoe leiden dat de aanroepen worden beperkt. Als de rate limits worden bereikt, worden extra aanroepen enkele seconden beperkt (of mogelijk langer als er aanroepen blijven worden gedaan terwijl de rate limits actief zijn).
Privé (REST Accountbeheer)
De privé Spot-endpoints hebben rate limits per API-sleutel en zijn gebaseerd op een teller die begint bij 0, toeneemt bij elke aanroep en afneemt na verloop van tijd. De teller van elke API-sleutel is afzonderlijk, en als de teller de maximale waarde overschrijdt, worden volgende aanroepen met die API-sleutel beperkt. Als de rate limits worden bereikt, worden extra aanroepen enkele seconden beperkt (of mogelijk langer als er aanroepen blijven worden gedaan terwijl de rate limits actief zijn).
API-endpoint | Tellerverhoging (per verzoek) |
|---|---|
Accountgeschiedenis-endpoints (Ledgers, TradesHistory, ClosedOrders) | +4 |
Staking-endpoints (Stake, Unstake) | +1 |
Alle andere endpoints (Balance, TradeBalance, etc.) | +1 |
Trading-endpoints (AddOrder, CancelOrder, etc.) | 0 (geen effect op teller) |
Accountverificatieniveau | Maximale tellerwaarde | Tellervermindering (per seconde) |
|---|---|---|
Geverifieerd | 20 | -0.5 |
Geverifieerd met hogere limieten | 20 | -1 |
Trading (REST en WebSocket plaatsen/annuleren van orders)
De Spot trading-endpoints (REST AddOrder/CancelOrder en WebSocket addOrder/cancelOrder) hebben rate limits per account en per valutapaar, en zijn gebaseerd op hoe orders interageren met het orderboek.
Kortom (de TLDR-versie), elk account en valutapaar heeft een maximaal aantal punten dat elke seconde kan worden gebruikt zonder de trading rate limits te bereiken. Het plaatsen, uitvoeren en annuleren van orders gebruikt deze punten, terwijl de tijd deze punten aanvult. Het gebruiken van meer punten dan toegestaan (op basis van uw accounttype) zou ertoe leiden dat volgende aanroepen worden beperkt.
Volledige details van de trading rate limits worden verstrekt, zodat onze traders het precieze aantal orders kunnen berekenen dat zij kunnen plaatsen/uitvoeren/annuleren op basis van hun tradingstrategie (order fill rate, order lifetime op het orderboek, etc.). Voorbeelden voor verschillende accounttypes en basis tradingstrategieën worden ter gemak aangeboden, samen met een rate limit-calculator om de rate limits voor complexere strategieën te bepalen.