Le nostre API offrono un modo per interagire programmaticamente con le nostre piattaforme, ma entrambe le piattaforme offrono due interfacce diverse: su Spot, REST e WebSocket (v1 e v2), e su Futures, sono fornite anche API REST e WebSocket. A volte scegliere l'interfaccia più appropriata per un compito specifico può essere una decisione difficile.
Su Spot, pur fornendo entrambi gli stessi dati di mercato (order book, cronologia di trading, ecc.) e gli stessi dati dell'account (saldi dell'account, stato degli ordini/trade, ecc.), REST e WebSocket lo fanno in modi significativamente diversi.
REST offre un'interfaccia di tipo chiamata/risposta (domanda/risposta) e fornisce un'istantanea dei dati attuali, mentre WebSocket offre un'interfaccia di tipo streaming live e fornisce aggiornamenti in tempo reale.
Un'analogia sarebbe la differenza tra una fotografia e un video, in quanto su richiesta una fotografia fornisce un'istantanea del soggetto ma nessun ulteriore aggiornamento, mentre un video fornisce una visione in tempo reale del soggetto con aggiornamenti in live streaming.
Sebbene né REST né WebSocket siano difficili da implementare, è generalmente accettato che REST sia meno complesso, il che consente di ridurre i tempi di sviluppo e di risolvere più rapidamente eventuali problemi successivi.
REST si basa su richieste HTTPS standard incluse nelle librerie standard di tutti i moderni linguaggi di programmazione (e potrebbe essere facilmente codificato da zero se non lo fosse), mentre WebSocket si basa su un aggiornamento WSS da HTTPS che di solito richiede librerie di terze parti aggiuntive (come la nostra libreria WebSocket consigliata per Python).
Le nostre pagine di supporto API forniscono codice di esempio pronto all'uso sia per REST che per WebSocket, quindi la scelta dell'interfaccia può essere fatta utilizzando criteri più critici piuttosto che la facilità di implementazione.
A seconda del compito da svolgere, la scelta ottimale sarebbe solo REST, solo WebSocket o, più probabilmente, una combinazione di entrambi REST e WebSocket.
Per i compiti che richiedono solo aggiornamenti occasionali dei dati di mercato, REST sarebbe la scelta preferita. Ad esempio, un bot di costo medio giornaliero che richiede dati di mercato solo una volta ogni 24 ore non avrebbe bisogno di dati di mercato in streaming in tempo reale, quindi gli endpoint dei dati di mercato REST sarebbero più che adatti.
Per i compiti che richiedono i dati di mercato più aggiornati disponibili, WebSocket sarebbe la scelta preferita. Ad esempio, un bot di arbitraggio avrebbe bisogno di dati di mercato in tempo reale da più mercati per sfruttare le discrepanze di prezzo momentanee, quindi i feed di dati di mercato WebSocket sarebbero la scelta ideale.
Nella maggior parte dei casi (come la maggior parte dei bot di trading), una combinazione di REST e WebSocket consentirebbe l'implementazione più efficace. Ad esempio, un'app mobile potrebbe richiedere dati di mercato in tempo reale per i suoi grafici, pur avendo bisogno di dati dell'account solo occasionalmente (quando si effettua un trade o una transazione di finanziamento, ad esempio), quindi l'utilizzo dei feed di dati di mercato WebSocket insieme agli endpoint di stato di ordine/trade/finanziamento REST sarebbe la combinazione più efficiente.
Il nostro team di supporto API sarà lieto di discutere con voi la vostra implementazione API e di fornirvi suggerimenti sul modo ottimale di utilizzare la nostra API in base al vostro scenario di utilizzo previsto.