Aanvraaglimieten voor publieke endpoints (marktdata)
Aanvraaglimieten voor privé-endpoints (accountbeheer)
Aanvraaglimieten voor trading (orders plaatsen/annuleren)
Onze REST- en WebSocket-API's hebben aanvraaglimieten die het aantal calls beperken dat binnen korte tijd kan worden gedaan. De aanvraaglimieten beschermen de API's tegen aanvallen (zoals DDoS-aanvallen) en voorkomen manipulatie van onze orderboeken (bijvoorbeeld door snel grote orders te plaatsen en te annuleren).
De Spot API-aanvraaglimieten zijn onderverdeeld in drie secties (publiek, privé, trading), afhankelijk van de gebruikte API-interface (REST of WebSocket) en het type call (marktdata, accountbeheer, orders plaatsen/annuleren). Voor aanvraaglimieten die gelden voor futures (REST) API-calls, raadpleeg je ons Support-artikel hier.
Publiek (REST-marktdata)
Voor de publieke Spot-endpoints gelden aanvraaglimieten per IP-adres en valutapaar voor calls naar Trades en OHLC, en per IP-adres voor alle overige publieke endpoints.
Bij een frequentie van maximaal 1 call per seconde blijf je binnen de aanvraaglimieten; een hogere frequentie kan ertoe leiden dat calls worden beperkt. Als de aanvraaglimieten worden bereikt, worden extra calls een paar seconden geblokkeerd (mogelijk langer als er calls blijven binnenkomen terwijl de limieten actief zijn).
Privé (REST-accountbeheer)
De privé Spot-endpoints hebben een aanvraaglimiet per API-key en werken op basis van een teller die bij 0 begint, bij elke call oploopt en na verloop van tijd daalt. De teller van elke API-key staat los van andere keys. Als de teller de maximumwaarde overschrijdt, worden volgende calls met die API-key beperkt. Als de aanvraaglimieten worden bereikt, worden extra calls een paar seconden geblokkeerd (mogelijk langer als er calls blijven binnenkomen terwijl de limieten actief zijn).
API-endpoint | Tellertoename (per verzoek) |
|---|---|
Accountgeschiedenis-endpoints (Ledgers, TradesHistory, ClosedOrders) | +4 |
Staking-endpoints (Staken, Unstake) | +1 |
Alle overige endpoints (Balance, TradeBalance, enz.) | +1 |
Trading-endpoints (AddOrder, CancelOrder, enz.) | 0 (geen effect op de teller) |
Accountniveau | Maximale tellerwaarde | Tellerdaling (per seconde) |
|---|---|---|
Standaard | 20 | -0,5 |
Hogere limiets | 20 | -1 |
Trades (REST en WebSocket – Orders plaatsen/annuleren)
De Spot-trading endpoints (REST AddOrder/CancelOrder en WebSocket addOrder/cancelOrder) hebben een Aanvraaglimiet per Account en per valutapaar, gebaseerd op hoe Orders interacteren met het orderboek.
Kort samengevat: elk Account en valutapaar heeft een maximaal aantal punten dat per seconde gebruikt mag worden zonder de Aanvraaglimiet voor trades te bereiken. Het plaatsen, uitvoeren en annuleren van Orders verbruikt deze punten; met het verstrijken van de tijd worden ze aangevuld. Als je meer punten gebruikt dan toegestaan (op basis van je Accounttype), worden volgende aanvragen geblokkeerd door de Aanvraaglimiet.
Volledige details van de Aanvraaglimiet voor trades zijn beschikbaar zodat onze Traders het exacte aantal Orders kunnen berekenen dat ze kunnen plaatsen, uitvoeren of annuleren op basis van hun tradingstrategie (fill rate van Orders, levensduur van Orders in het orderboek, enzovoort). Voor het gemak zijn er voorbeelden opgenomen voor verschillende Accounttypen en basistrading-strategieën, samen met een Aanvraaglimiet-calculator voor complexere strategieën.