Deixe a camada de conexão sólida antes de escrever uma única linha de código de envio de ordens, porque a API de socket da IBKR nunca foi criada para operação ininterrupta sem supervisão.
Ferdinand é uma skill de Desenvolvedor Sênior da API da Interactive Brokers criada para todo o ciclo de vida da API da IBKR: configurar corretamente as conexões da TWS API/IB Gateway, escolher entre ib_insync/ib_async e a ibapi nativa, encaminhar ordens de ações, opções, futuros e forex por meio de objetos Contract devidamente qualificados, manter as contas de simulação e reais genuinamente separadas, confirmar dados de mercado em tempo real versus atrasados e criar uma lógica de reconexão com backoff e ressincronização de estado capaz de resistir às conexões frágeis da IBKR.
Para quem é
desenvolvedores que criam sistemas de trading programático sobre a Interactive Brokers e precisam acertar de primeira os detalhes de conexão, contratos e tipos de ordem.
Principais recursos
- Define o IB Gateway como padrão dos projetos de automação em vez da TWS e confirma as configurações exatas da API (porta do socket, modo somente leitura, IPs confiáveis) antes de escrever uma linha de Python.
- Cria um loop de reconexão com backoff exponencial, um client ID exclusivo e rastreado e uma ressincronização completa do estado na reconexão em todo script de longa duração desde o início, em vez de adicionar isso depois da primeira indisponibilidade.
- Define e registra explicitamente o ambiente de simulação ou real pretendido em todo script que envia ordens reais, tratando a mudança para o ambiente real como uma alteração deliberada de configuração e um novo deploy, nunca como uma flag em tempo de execução.
- Confirma qual tipo de dados de mercado uma conexão está realmente recebendo antes de confiar em uma cotação, pois dados atrasados podem ser retornados silenciosamente como se fossem dados em tempo real.
- Qualifica todos os objetos Contract (ações, opções, futuros e forex) junto à IBKR antes de enviar uma ordem e cria ordens bracket com vinculação correta entre ordem principal e ordens filhas e com a sequência adequada de transmissão.
Como usar
Cole o SKILL.md do Ferdinand nas instruções do seu projeto Claude (ou no prompt de qualquer sistema de AI) e, em seguida, informe seu problema de conexão, sua necessidade de encaminhamento de ordens ou seu bug de reconexão. Funciona com Claude, ChatGPT e qualquer chat de AI. Instalação em menos de 2 minutos.