Mitä ovat API-käyttörajat?

Viimeksi päivitetty: 1. lokakuuta 2026

REST- ja WebSocket-rajapinnoillamme 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ä) sekä estävät tarjouskirjojen manipuloinnin (esimerkiksi suurten toimeksiantojen nopealla asettamisella ja peruuttamisella).

Spot-rajapinnan käyttörajat on jaettu kolmeen osioon (julkinen, yksityinen, kaupankäynti) käytetyn rajapintatyypin (REST tai WebSocket) ja kutsutyypin (markkinadata, tilinhallinta, toimeksiantojen asettaminen/peruuttaminen) mukaan. Futuurien (REST) API-kutsujen pyyntörajoista on lisätietoja tukiartikkelissamme täällä.

Julkinen (REST-markkinadata)

Spot-rajapinnan julkisten päätepisteiden käyttörajat määräytyvät IP-osoitteen ja valuuttaparin mukaan Trades- ja OHLC-kutsuille sekä pelkästää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ätä tiheämpi kutsuväli voi johtaa käyttörajan ylittymiseen. Jos käyttörajat ylittyvät, lisäkutsut estetään muutamaksi sekunniksi (tai mahdollisesti pidemmäksi ajaksi, jos kutsuja tehdään edelleen käyttörajojen ollessa aktiivisena).

Yksityinen (REST-tilinhallinta)

Spot-rajapinnan yksityisten päätepisteiden käyttörajat perustuvat API-avainkohtaiseen laskuriin, joka alkaa nollasta, kasvaa jokaisen kutsun myötä ja pienenee ajan kuluessa. Jokaisen API-avaimen laskuri on erillinen, ja jos laskuri ylittää enimmäisarvon, kyseistä API-avainta käyttävät lisäkutsut rajoitetaan. Jos käyttörajat ylittyvät, lisäkutsut estetään muutamaksi sekunniksi (tai mahdollisesti pidemmäksi ajaksi, jos kutsuja tehdään edelleen käyttörajojen ollessa aktiivisena).

API-päätepiste	Laskurin kasvu (per pyyntö)
Tilihistorian päätepisteet (Ledgers, TradesHistory, ClosedOrders)	+4
Steikkauspäätepisteet (Stake, Unstake)	+1
Kaikki muut päätepisteet (Balance, TradeBalance jne.)	+1
Kaupankäyntipäätepisteet (AddOrder, CancelOrder jne.)	0 (ei vaikutusta laskuriin) Katso kaupankäynnin käyttörajat

Tilitaso	Laskurin enimmäisarvo	Laskurin väheneminen (sekunnissa)
Vakio	20	-0,5
Korkeammat rajat	20	-1

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

Spot-kaupankäynnin päätepisteet (REST AddOrder/CancelOrder ja WebSocket addOrder/cancelOrder) ovat tilikohtaisten ja valuuttaparikohtaisten käyttörajojen alaisia, ja ne perustuvat siihen, miten toimeksiannot vaikuttavat tarjouskirjaan.

Lyhyesti (TLDR) jokaisella tilillä ja valuuttaparilla on enimmäispistemäärä, jota voidaan käyttää sekunnissa ylittämättä kaupankäynnin käyttörajoja. Toimeksiantojen asettaminen, toteuttaminen ja peruuttaminen kuluttaa näitä pisteitä, ja aika kartuttaa niitä. Jos pisteitä käytetään enemmän kuin tilityyppi sallii, myöhemmät kutsut rajoitetaan.

Kaupankäynnin käyttörajojen kattavat tiedot on julkaistu, jotta treidaajat voivat laskea tarkasti, kuinka monta toimeksiantoa he voivat asettaa, toteuttaa tai peruuttaa oman kaupankäyntistrategiansa mukaan (toimeksiantojen toteutusaste, elinaika tarjouskirjassa jne.). Eri tilityyppejä ja peruskaupankäyntistrategioita käsitteleviä esimerkkejä on tarjolla helpottamaan laskelmia, ja monimutkaisempia strategioita varten saatavilla on käyttörajalaskin.