Onze API's bieden een manier om programmatisch met onze platforms te communiceren, maar beide platforms bieden twee verschillende interfaces: op Spot, REST en WebSocket (v1 en v2), en op Futures worden ook zowel REST- als WebSocket-API's aangeboden. Soms kan het kiezen van de meest geschikte interface voor een specifieke taak een moeilijke beslissing zijn.
Op Spot, hoewel beide exact dezelfde marktgegevens (orderboeken, handelsgeschiedenis, enz.) en exact dezelfde accountgegevens (accountsald's, order-/handelsstatus, enz.) leveren, doen REST en WebSocket dit op significant verschillende manieren.
REST biedt een call/response (vraag/antwoord) type interface en geeft een momentopname van de huidige gegevens, terwijl WebSocket een live streaming type interface biedt en real-time updates levert.
Een analogie zou het verschil zijn tussen een foto en een video: op verzoek geeft een foto een momentopname van het onderwerp, maar geen verdere updates, terwijl een video een real-time weergave van het onderwerp biedt met live streaming updates.
Hoewel noch REST noch WebSocket moeilijk te implementeren zijn, wordt algemeen aanvaard dat REST minder complex is, wat de ontwikkeltijd verkort en eventuele latere problemen sneller oplost.
REST is gebaseerd op standaard HTTPS-verzoeken die zijn opgenomen in de standaardbibliotheken van alle moderne programmeertalen (en gemakkelijk vanaf nul kunnen worden gecodeerd indien niet), terwijl WebSocket is gebaseerd op een WSS-upgrade van HTTPS, wat meestal extra bibliotheken van derden vereist (zoals onze aanbevolen WebSocket-bibliotheek voor Python).
Onze API-ondersteuningspagina's bieden kant-en-klare voorbeeldcode voor zowel REST als WebSocket, vandaar dat de keuze van de interface kan worden gemaakt op basis van kritischere criteria in plaats van het gemak van implementatie.
Afhankelijk van de taak, zou ofwel alleen REST, ofwel alleen WebSocket, of waarschijnlijker een combinatie van zowel REST als WebSocket de optimale keuze zijn.
Voor taken die slechts af en toe marktgegevensupdates vereisen, zou REST de voorkeur hebben. Een dagelijkse cost averaging bot die bijvoorbeeld slechts eens per 24 uur marktgegevens nodig heeft, zou geen behoefte hebben aan real-time streaming marktgegevens, vandaar dat de REST-marktgegevensendpoints meer dan geschikt zouden zijn.
Voor taken die de meest actuele beschikbare marktgegevens vereisen, zou WebSocket de voorkeur hebben. Een arbitrage bot zou bijvoorbeeld real-time marktgegevens van meerdere markten nodig hebben om te profiteren van tijdelijke prijsverschillen, vandaar dat de WebSocket-marktgegevensfeeds de ideale keuze zouden zijn.
In de meeste gevallen (zoals de meerderheid van de trading bots) zou een combinatie van REST en WebSocket de meest effectieve implementatie mogelijk maken. Een mobiele app zou bijvoorbeeld real-time marktgegevens nodig kunnen hebben voor zijn grafieken, terwijl accountgegevens slechts af en toe nodig zijn (bijvoorbeeld bij het plaatsen van een trade of een financieringstransactie), vandaar dat het gebruik van de WebSocket-marktgegevensfeeds naast de REST-order-/trade-/financieringsstatusendpoints de meest efficiënte combinatie zou zijn.
Ons API-ondersteuningsteam bespreekt graag je API-implementatie met je en doet suggesties voor de optimale manier om onze API te gebruiken op basis van je beoogde gebruiksscenario.