Rendi solido il livello di connessione prima ancora di scrivere una sola riga di codice per l’inserimento degli ordini, perché l’API socket di IBKR non è mai stata progettata per funzionare senza supervisione ininterrottamente.
Ferdinand è una skill per sviluppatori senior dell’API di Interactive Brokers, progettata per l’intero ciclo di vita dell’API IBKR: configurare correttamente le connessioni TWS API/IB Gateway, scegliere tra ib_insync/ib_async e ibapi nativa, instradare gli ordini su azioni, opzioni, futures e forex tramite oggetti Contract qualificati correttamente, mantenere realmente separati gli account demo e live, verificare se i dati di mercato sono in tempo reale o ritardati e creare una logica di riconnessione con backoff e risincronizzazione dello stato in grado di sopravvivere alle fragili connessioni di IBKR.
A chi è rivolta
agli sviluppatori che creano sistemi di trading programmatico basati su Interactive Brokers e hanno bisogno di configurare correttamente fin dal primo tentativo i dettagli di connessione, dei contratti e dei tipi di ordine.
Funzionalità principali
- Imposta come predefinito IB Gateway invece di TWS per i progetti di automazione e conferma le impostazioni API esatte (porta socket, modalità di sola lettura, IP attendibili) prima di scrivere una sola riga di Python.
- Integra fin dall’inizio in ogni script a esecuzione prolungata un ciclo di riconnessione con backoff esponenziale, un ID client univoco e monitorato e una risincronizzazione completa dello stato alla riconnessione, invece di aggiungerli dopo la prima interruzione.
- Imposta e registra in modo esplicito l’ambiente demo o live previsto in ogni script che invia ordini reali, trattando il passaggio al live come una modifica deliberata della configurazione seguita da un nuovo deployment, mai come un flag di runtime.
- Verifica quale tipo di dati di mercato una connessione sta effettivamente ricevendo prima di considerare attendibile una quotazione, poiché i dati ritardati possono essere restituiti silenziosamente come se fossero in tempo reale.
- Qualifica ogni oggetto Contract (azioni, opzioni, futures, forex) con IBKR prima di inviare un ordine e crea ordini bracket con collegamenti parent/child e sequenza di trasmissione corretti.
Come utilizzarlo
Incolla il file SKILL.md di Ferdinand nelle istruzioni del progetto Claude (o nel prompt di sistema di qualsiasi sistema AI), quindi sottoponigli il tuo problema di connessione, la necessità di instradare un ordine o un bug di riconnessione. Funziona con Claude, ChatGPT e qualsiasi chat AI. Si installa in meno di 2 minuti.