Mitä ovat API-nopeusrajoitukset?

Viimeksi päivitetty: 27.3.2026

Julkiset (markkinadata) nopeusrajoitukset

Yksityiset (tilinhallinta) nopeusrajoitukset

Kaupankäynnin (toimeksiantojen asettaminen/peruminen) nopeusrajoitukset

REST- ja WebSocket-rajapinnoillamme on nopeusrajoituksia, jotka vaikuttavat lyhyen ajan sisällä tehtävien kutsujen määrään. Nopeusrajoitukset on suunniteltu suojaamaan rajapintoja hyökkäyksiltä (kuten DDoS-hyökkäyksiltä) ja estämään toimeksiantokirjojemme manipulointia (kuten suurten toimeksiantojen nopeaa asettamista ja perumista).

Spot API -nopeusrajoitukset on jaettu kolmeen osaan (julkinen, yksityinen, kaupankäynti) riippuen käytettävästä API-rajapinnasta (REST tai WebSocket) ja tehtävän kutsun tyypistä (markkinadata, tilinhallinta, toimeksiantojen asettaminen/peruminen). Lisätietoja Futures (REST) API -kutsuihin liittyvistä pyyntörajoituksista (Request Limits) löydät tukisivustoltamme täältä.

Julkinen (REST-markkinadata)

Spot-rajapinnan julkisia päätepisteitä rajoitetaan IP-osoitteen ja valuuttaparin mukaan Trades- ja OHLC-kutsuissa, ja pelkän IP-osoitteen mukaan kaikissa muissa julkisissa päätepisteissä.

Julkisten päätepisteiden kutsuminen kerran sekunnissa (tai harvemmin) pysyy nopeusrajoitusten puitteissa, mutta tämän tiheyden ylittäminen voi johtaa kutsujen rajoittamiseen. Jos nopeusrajoitukset saavutetaan, lisäkutsuja rajoitetaan muutaman sekunnin ajan (tai mahdollisesti pidempään, jos kutsuja jatketaan nopeusrajoitusten ollessa aktiivisia).

Yksityinen (REST-tilinhallinta)

Spot-rajapinnan yksityisiä päätepisteitä rajoitetaan API-avaimen mukaan, ja ne perustuvat laskuriin, joka alkaa nollasta, kasvaa jokaisen kutsun myötä ja vähenee ajan myötä. Jokaisen API-avaimen laskuri on erillinen, ja jos laskuri ylittää enimmäisarvon, kyseisellä API-avaimella tehtäviä seuraavia kutsuja rajoitetaan. Jos nopeusrajoitukset saavutetaan, lisäkutsuja rajoitetaan muutaman sekunnin ajan (tai mahdollisesti pidempään, jos kutsuja jatketaan nopeusrajoitusten ollessa aktiivisia).

API-päätepiste

Laskurin kasvu (per pyyntö)

Tilihistorian päätepisteet (Ledgers, TradesHistory, ClosedOrders)

+4

Staking-päätepisteet (Stake, Unstake)

+1

Kaikki muut päätepisteet (Balance, TradeBalance jne.)

+1

Kaupankäynnin päätepisteet (AddOrder, CancelOrder jne.)

0 (ei vaikutusta laskuriin)
Katso lisätietoja kaupankäynnin nopeusrajoituksista

Tilin vahvistustaso

Laskurin enimmäisarvo

Laskurin väheneminen (per sekunti)

Vahvistettu

20

-0,5

Vahvistettu korkeammilla rajoilla

20

-1

Kaupankäynti (REST- ja WebSocket-toimeksiantojen asettaminen/peruminen)

Spot-kaupankäynnin päätepisteitä (REST AddOrder/CancelOrder ja WebSocket addOrder/cancelOrder) rajoitetaan tili- ja valuuttaparikohtaisesti, ja ne perustuvat siihen, miten toimeksiannot vaikuttavat toimeksiantokirjaan.

Lyhyesti sanottuna jokaisella tilillä ja valuuttaparilla on tietty enimmäismäärä pisteitä, joita voidaan käyttää sekunnissa ilman kaupankäynnin nopeusrajoitusten saavuttamista. Toimeksiantojen asettaminen, toteuttaminen ja peruminen kuluttaa näitä pisteitä, kun taas aika palauttaa niitä. Sallittua suuremman pistemäärän käyttäminen (tilisi tyypistä riippuen) johtaa seuraavien kutsujen rajoittamiseen.

Kaupankäynnin nopeusrajoitusten täydelliset tiedot on annettu, jotta kaupankävijämme voivat laskea tarkan määrän toimeksiantoja, joita he voivat asettaa/toteuttaa/perua kaupankäyntistrategiansa perusteella (toimeksiantojen toteutumisaste, toimeksiannon elinikä toimeksiantokirjassa jne.). Esimerkkejä eri tilityypeille ja peruskaupankäyntistrategioille on annettu avuksi, samoin kuin nopeusrajoituslaskuri monimutkaisempien strategioiden nopeusrajoitusten määrittämiseen.

Tarvitsetko lisää apua?