Mitä ovat API:n käyttörajat?

Viimeksi päivitetty: 10. elokuuta 2026

Julkiset käyttörajat (markkinadata)

Yksityiset käyttörajat (tilinhallinta)

Kaupankäynnin käyttörajat (toimeksiantojen lisäys/peruutus)

REST- ja WebSocket-rajapinnoissamme on käyttörajat, jotka rajoittavat lyhyessä ajassa tehtävien kutsujen määrää. Käyttörajat suojaavat rajapintoja hyökkäyksiltä (kuten DDoS-hyökkäyksiltä) ja estävät tarjouskirjojemme manipuloinnin (esimerkiksi suurten toimeksiantojen nopean lisäyksen ja peruutuksen avulla).

Spot-rajapinnan käyttörajat jakautuvat kolmeen osioon (julkinen, yksityinen, kaupankäynti) käytetyn rajapinnan (REST tai WebSocket) ja kutsutyypin (markkinadata, tilinhallinta, toimeksiantojen lisäys/peruutus) mukaan. Futuurien (REST) API-kutsuihin liittyvät pyyntörajat löydät tukiartikkelistamme täältä.

Julkinen (REST-markkinadata)

Spot-rajapinnan julkisilla päätepisteillä on käyttörajat IP-osoitteen ja valuuttaparin mukaan Trades- ja OHLC-kutsuille, ja pelkän IP-osoitteen mukaan kaikille muille julkisille päätepisteille.

Julkisten päätepisteiden kutsuminen enintään kerran sekunnissa pysyy käyttörajojen sisällä, mutta tämän taajuuden ylittäminen voi johtaa kutsujen rajoittamiseen. Jos käyttörajat saavutetaan, lisäkutsut estetään muutamaksi sekunniksi (mahdollisesti pidempäänkin, jos kutsuja tehdään edelleen käyttörajojen ollessa aktiivisina).

Yksityinen (REST-tilinhallinta)

Spot-rajapinnan yksityisten päätepisteiden käyttörajat ovat API-avainkohtaisia ja perustuvat laskuriin, joka alkaa nollasta, kasvaa jokaisen kutsun myötä ja pienenee ajan myötä. Kullakin API-avaimella on oma laskurinsa. Jos laskuri ylittää enimmäisarvon, kyseistä API-avainta käyttävät lisäkutsut rajoitetaan. Jos käyttörajat saavutetaan, lisäkutsut estetään muutamaksi sekunniksi (mahdollisesti pidempäänkin, jos kutsuja tehdään edelleen käyttörajojen ollessa aktiivisina).

API-päätepiste

Laskurin kasvu (pyyntöä kohti)

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

+4

Steikkauspäätepisteet (Stake, Unstake)

+1

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

+1

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

0 (ei vaikutusta laskuriin)
Lisätietoja kaupankäynnin käyttörajoista

Tilitaso

Laskurin enimmäisarvo

Laskurin vähennys (sekunnissa)

Vakio

20

-0,5

Korkeammat rajat

20

-1

Kaupankäynti (REST ja WebSocket – toimeksiantojen asettaminen/peruuttaminen)

Spot-kaupankäynnin päätepisteiden (REST AddOrder/CancelOrder ja WebSocket addOrder/cancelOrder) käyttörajat määräytyvät tilin ja valuuttaparin mukaan, ja ne perustuvat siihen, miten toimeksiannot vaikuttavat tarjouskirjaan.

Lyhyesti: kullakin tilillä ja valuuttaparilla on enimmäispistemäärä, joka voidaan käyttää sekunnissa ilman, että kaupankäynnin käyttörajat ylittyvät. Toimeksiantojen asettaminen, toteuttaminen ja peruuttaminen kuluttaa näitä pisteitä, ja aika täydentää niitä. Jos pisteitä käytetään enemmän kuin tilityyppisi sallii, myöhemmät kutsut rajoitetaan käyttörajan nojalla.

Kaupankäynnin käyttörajojen täydelliset tiedot on annettu, jotta treidaajat voivat laskea tarkan toimeksiantojen määrän, jonka he voivat asettaa, toteuttaa tai peruuttaa kaupankäyntistrategiansa perusteella (toimeksiannon toteutusaste, toimeksiannon elinikä tarjouskirjassa jne.). Eri tilityyppejä ja peruskaupankäyntistrategioita varten on laadittu esimerkkejä, ja monimutkaisempien strategioiden käyttörajojen selvittämiseen on saatavilla käyttörajalaskuri.

Tarvitsetko lisää apua?