Bitsgap API: esegui il tuo algoritmo di trading su 17 exchange

Configurare la propria automazione di trading significava dedicare una settimana di lavoro. Leggere la documentazione API di un exchange, implementare il suo schema di firma, gestire le sue particolarità, poi ripetere tutto da capo per l’exchange successivo. Aggiungere un server, implementare la logica di riconnessione, trovare un modo per testare senza rischiare di perdere denaro.

L’API di Bitsgap elimina quella settimana. Una singola coppia di chiavi copre 17 exchange, le piattaforme demo sono già disponibili e la connessione al tuo exchange è la stessa che i tuoi bot utilizzano già. Tra gli account che l’hanno configurata, il tempo mediano dalla creazione della chiave alla prima richiesta firmata andata a buon fine è di 13 minuti. L’API è inclusa Free in ogni Piano, incluso quello Free.

Che cos’è realmente una trading API

Un'API è un elenco fisso di comandi che un programma può inviare a un altro. Un'API di trading è quell'elenco per un Market: leggere un Prezzo, leggere un Saldo, inserire un Ordine, annullare un Ordine, chiudere una Posizione. Il tuo programma invia un comando, il server esegue l'operazione e restituisce una risposta. Tutto ciò che puoi fare cliccando su Bitsgap, il tuo codice può farlo in modo autonomo e programmato.

La versione di Bitsgap si basa su un concetto chiamato topic — un elemento nominato che desideri monitorare. price, balance, orders, order_place. Dai un nome al topic, passi i suoi parametri e ricevi in risposta un’istantanea singola oppure un flusso continuo di aggiornamenti.

json

{"topic": "price", "params": {"em": 101, "pair": "BTC_USDT"}}

Il resto del protocollo riguarda quali argomenti esistono e quali parametri ciascuno di essi accetta. Non esiste un endpoint separato per ogni azione e non c’è un secondo formato da imparare quando si approfondisce.

Perché non andare direttamente sull’exchange

Puoi farlo, e per una singola piattaforma è una scelta ragionevole. Tuttavia, tre aspetti cambiano quando il numero supera uno.

Ogni exchange ha il proprio schema di firma, quindi aggiungere una seconda piattaforma significa dover implementare tutto da zero una seconda volta. Ogni exchange richiede una propria chiave, da conservare e ruotare separatamente. E la maggior parte non offre un ambiente di test realistico, quindi il nuovo codice si confronta subito con denaro reale al primo utilizzo.

Con Bitsgap hai una sola coppia di chiavi, un unico schema di firma e un ambiente demo che si comporta esattamente come quello reale. Inoltre, il tuo algoritmo opera nello stesso Account dei tuoi bot GRID, DCA e COMBO, così tutte le tue posizioni vengono visualizzate in un unico posto invece che su due sistemi separati che mostrano solo metà della situazione.

Tredici minuti, passo dopo passo

1. Crea un Account. Piano Free, nessuna carta richiesta. L’API è inclusa in ogni Piano, quindi non è necessario effettuare alcun upgrade qui.

2. Genera una chiave. Menu Account → API keys → Crea nuova chiave. Assegna un nome e una data di scadenza, quindi Genera. La durata predefinita è di tre anni.

3. Salva la chiave privata. Verrà visualizzata una sola volta, come file PEM. Scaricala e conservala come faresti con una chiave di exchange. Se viene persa, non può essere recuperata, ma solo sostituita.

4. Verifica che la firma funzioni offline. Gli esempi ufficiali includono un test signing_offline che non richiede né chiavi né connessione di rete. Eseguilo per primo. La maggior parte dei problemi di integrazione riguarda la firma, e questo test li individua prima che possano interferire altri fattori.

5. Esegui la procedura guidata sulla demo. Gli esempi sono disponibili per Go, Rust, Python e TypeScript e utilizzano di default exchange demo. Un solo comando ti guida attraverso connessione, dati di Market, saldi, un Ordine Spot, un Ordine Futures e la cronologia degli ordini. In nessun momento viene utilizzato denaro reale.

6. Collegalo a un exchange reale. Modifica un solo numero — l’ID dell’exchange em — e lo stesso codice funziona in tempo reale.

Come configurarlo senza dover scrivere il codice personalmente

Non è necessario creare l’integrazione manualmente.

L’intera documentazione del protocollo è pubblica e leggibile dalle macchine, e accanto ad essa sono disponibili quattro implementazioni di riferimento complete. Fornisci questa documentazione a qualsiasi assistente AI per la programmazione e descrivi ciò che desideri in linguaggio semplice: monitora il funding rate su tre coppie e, quando diventa negativo su tutte e tre, chiudi le mie posizioni long. Riceverai uno script funzionante già configurato per l’ambiente demo, che potrai eseguire e modificare prima che abbia accesso a un vero saldo.

Questa mediana di 13 minuti si mantiene perché le parti più complesse esistono già in quattro lingue, inclusi la firma Ed25519, le stringhe di richiesta canoniche e la logica di riconnessione, il che ti lascia solo da scrivere la regola di trading e nient’altro.

Il Market continua a espandersi più rapidamente di quanto qualsiasi processo manuale possa tenere il passo, quindi il tempo dedicato alle attività operative è diventato la parte più costosa della configurazione.

Due canali, un unico elenco di argomenti

Entrambi i canali trattano gli stessi argomenti con gli stessi parametri. REST è pensato per un programma che si attiva, fa una domanda e poi torna in standby. WebSocket invece è adatto a chi resta attivo e reagisce in tempo reale.

Tramite REST, la risposta a un comando conferma che l’operazione è stata accettata, non completata. Il risultato dell’esecuzione arriva tramite una sottoscrizione WebSocket su orders, positions o balance, oppure richiedendo nuovamente questi topic. Il contatore del rate-limit è condiviso tra entrambi i canali, quindi cambiare trasporto non offre un budget aggiuntivo.

A cosa hai accesso

Chiama prima conf_enums. Restituisce le tabelle di riferimento che trasformano i nomi degli exchange nei relativi ID numerici em attesi da tutti gli altri topic — Binance è 2, Binance demo è 101. Il topic manual restituisce il catalogo aggiornato di tutti i topic con i relativi limiti di frequenza attuali, così il tuo codice può leggere questi limiti invece di inserirli manualmente.

Un campo che vale la pena utilizzare fin dal primo giorno: apiid. Si tratta di un tuo tag personale su un Ordine, fino a 250 caratteri, che verrà restituito in ogni futuro report relativo a quell’Ordine. Inserisci in questo campo il nome e la versione della strategia. Quando due dei tuoi programmi effettuano uno Scambio sullo stesso pair, quel tag è l’unico elemento che ti permette di sapere quale dei due ha eseguito cosa.

L’API di Bitsgap è sicura da collegare?

La connessione di Bitsgap al tuo exchange non cambia. È limitata esclusivamente alle operazioni di trading e non ha mai avuto diritti di prelievo. L’API aggiunge una connessione separata tra il tuo programma e Bitsgap, firmata con una coppia di chiavi Ed25519 che generi e controlli tu. Ed25519 è uno schema di firma, non una password: tu possiedi la chiave privata, Bitsgap conserva solo quella pubblica e il segreto non viene mai trasmesso sulla rete. Le richieste non possono essere ripetute, perché ciascuna include un nonce univoco e un timestamp che scade dopo dieci secondi. Se revochi la chiave, tutte le sessioni aperte vengono immediatamente interrotte.

I limiti, in numeri

Due di questi fattori influenzano il modo in cui costruisci. I contatori di rate sono condivisi tra REST e WebSocket per ogni topic, quindi un ciclo di polling consuma il budget necessario a una Sottoscrizione live. Inoltre, superare il limite di messaggi per connessione chiude il socket invece di rifiutare il messaggio, quindi la logica di riconnessione richiede un backoff, un nuovo frame di autenticazione e una nuova Sottoscrizione.

Tre cose mandano in errore i primi tentativi, in quest’ordine: un orologio non sincronizzato, un nonce riutilizzato e la ri-serializzazione del corpo della richiesta dopo averlo firmato. Il payload viene firmato byte per byte, quindi una chiave riordinata o uno spazio in più producono una firma diversa. Invia esattamente la stringa che hai firmato.

Provalo senza spendere nulla

Le demo exchange si comportano come quelle reali. Ordini, esecuzioni, posizioni, saldi: tutto senza denaro reale in gioco. demo_market_reset azzera l'Account riportandolo allo stato iniziale, così puoi portare una strategia al limite e ricominciare con un solo comando.

L’API è gratuita su ogni Piano, incluso il Piano Free da $0. Nessuna carta, nessun upgrade, nessun periodo di Prova. Crea un Account, genera una chiave e inizia subito a firmare le richieste.

FAQ

Cos’è l’API di Bitsgap? Un’API pubblica che consente al tuo programma di leggere i dati di Market e di eseguire operazioni su qualsiasi exchange collegato al tuo Account Bitsgap. I canali REST e WebSocket condividono un unico elenco di topic, autenticati tramite una coppia di chiavi Ed25519 che generi e gestisci personalmente.

L’API di Bitsgap è Free? Sì. È inclusa in ogni Piano, compreso quello Free, senza costi aggiuntivi.

Devo saper programmare? Devi essere in grado di eseguire uno script. Scriverlo è perlopiù facoltativo: la documentazione del protocollo e quattro implementazioni di riferimento complete sono pubbliche, quindi un assistente AI per la programmazione può generare un’integrazione funzionante partendo da una semplice descrizione in linguaggio naturale.

Quali linguaggi di programmazione sono supportati? Qualsiasi linguaggio in grado di effettuare una richiesta HTTPS e calcolare una firma Ed25519. Esempi ufficiali pronti all’uso sono disponibili in Go, Rust, Python e TypeScript.

L’API può prelevare i miei fondi? No. Bitsgap si collega al tuo exchange tramite una chiave API abilitata solo al trading, che non ha mai avuto i permessi di prelievo, e l’API non modifica questa impostazione. Viene aggiunto un canale firmato separato tra il tuo programma e Bitsgap, revocabile in qualsiasi momento.

REST o WebSocket — quale dovrei usare? REST per richieste singole e script programmati. WebSocket per tutto ciò che deve reagire ai movimenti di prezzo o monitorare lo stato degli Ordini in tempo reale.

Posso fare dei test senza soldi reali? Sì. Gli esempi ufficiali utilizzano di default gli exchange demo e l’Account demo può essere ripristinato ai saldi iniziali in qualsiasi momento.

Quanto tempo richiede la configurazione? Il tempo mediano che intercorre tra la creazione di una Chiave API e la prima richiesta firmata andata a buon fine è di 13 minuti, misurato su tutti gli account Bitsgap che ne hanno collegata una. [Aggiungere intervallo di misurazione prima della pubblicazione]