Runtime nativo de IA para estratégias da Interactive Brokers
Desenvolva no Cursor, Claude Code ou em qualquer IDE de IA. Faça o deploy a partir do GitHub em um runtime de nuvem gerenciado com controle de primeira classe via MCP, logs e seleção de região.
Seção 01 · Resumo
Resumo
- Corretora
- Interactive Brokers LLC (Interactive Brokers Group, NASDAQ: IBKR)
- Tipo de corretora
- Corretora multiprodutos regulada nos EUA, varejo e institucional
- Classe de ativos
- Ações dos EUA e internacionais, opções, contratos futuros, FX, títulos, ETFs, fundos mútuos, cripto, CFDs (fora dos EUA)
- Cobertura de ativos
- Ações dos EUA (NYSE, NASDAQ, NYSE ARCA, BATS, IEX) e ações internacionais em mais de 150 mercados em 33 países. Opções dos EUA (ações e índices compensados pela OCC) e opções sobre futuros. Futuros e FOPs na CME Group, ICE, Eurex, HKEX, OSE, SGX e outros. FX spot (mais de 100 pares, rede IDEAL FX). Títulos: US Treasuries, títulos municipais dos EUA, corporativos dos EUA, governamentais e corporativos internacionais. ETFs e fundos mútuos. Negociação de cripto (clientes dos EUA) em plataforma parceira; clientes fora dos EUA via entidades separadas da IBKR. CFDs e warrants em entidades fora dos EUA. Produtos estruturados.
- Modelo de runtime
- Runtime de estratégia em container
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem executável em container
- Integrações comuns
- TWS API (Python oficial ibapi, ib_insync, ib_async), Client Portal API (REST + OAuth2), Web API, FIX (institucional), NautilusTrader, Backtrader, conectores personalizados
- Integração com fluxo de IA
- Superfície de controle MCP para Cursor, Claude Code, GitHub Copilot e agentes de CLI
- Papel da TradingHost
- Runtime, deploy, logs, monitoramento de integridade, seleção de região, controle via MCP
- Papel da Interactive Brokers
- Conta da corretora, acesso à API, dados de mercado, ambiente de execução, custódia, liquidação, relatórios fiscais, gestão de margem
- Reguladores
- Interactive Brokers LLC: corretora registrada na SEC e FINRA (CRD 36418), Futures Commission Merchant e Forex Dealer Member registrada na CFTC/NFA (NFA ID 0258600). Membro da SIPC com seguro adicional via Lloyds. As entidades do grupo são adicionalmente reguladas pela FCA (Reino Unido), CIRO (Canadá), ASIC (Austrália), SFC (Hong Kong), MAS (Singapura), CBI (Irlanda) e outras.
- Varejo dos EUA
- Sim. Conta de paper trading inclusa.
- Afiliação
- A TradingHost é independente e não é afiliada à Interactive Brokers LLC ou ao Interactive Brokers Group, Inc.
Seção 02 · O que a IBKR oferece
O que Interactive Brokers oferece
A Interactive Brokers expõe três superfícies de API distintas (TWS API, Client Portal API, Web API) além de FIX institucional. A mesma credencial de conta acessa ações dos EUA e internacionais, opções, futuros, FX, títulos, ETFs, fundos mútuos, cripto e CFDs em entidades fora dos EUA. As três superfícies de API possuem limites de capacidade materialmente diferentes; a escolha faz parte do design da estratégia.
Mercados e padrões de estratégia
- Portfólios multiativos em ações, opções e futuros
- Estratégias de ações internacionais em mais de 150 mercados via SmartRouting
- Automação de futuros e opções sobre futuros da CME, ICE e Eurex
- Estratégias de spot FX na IDEAL FX em mais de 100 pares
- Estratégias de opções dos EUA baseadas em superfície de volatilidade e gregas
- Fluxos de trabalho de margem de portfólio e margem cruzada entre ativos
- Conta de paper trading para testes paralelos sem risco
Superfície da API
- Superfícies de produtos
- Três superfícies de API distintas da Interactive Brokers: TWS API (protocolo de socket, requer um processo local do Trader Workstation ou IB Gateway em execução), Client Portal API (REST + WebSocket, autenticado via OAuth 2.0) e Web API (superfície REST mais recente). O FIX é oferecido para clientes institucionais. Cada superfície possui capacidades materialmente diferentes; escolha de acordo com a estratégia.
- Métodos de conexão
- A TWS API usa sockets TCP para uma instância em execução do TWS ou IB Gateway nas portas 7496/7497 (real/paper) para o TWS ou 4001/4002 (real/paper) para o IB Gateway. A Client Portal API é HTTPS REST mais WebSocket em api.ibkr.com. A Web API é HTTPS REST. Wrappers: ibapi oficial (Python), o comunitário ib_insync e o fork ib_async que mantém o suporte ativo.
- Autenticação
- TWS API: a estratégia se conecta a um gateway em execução local que foi autenticado de forma interativa pelo titular da conta. Client Portal API: OAuth 2.0 com chave de consumidor e tokens de atualização. Web API: tokens REST. O paper trading usa credenciais e um número de conta separados da conta real.
Para detalhes específicos, consulte a Interactive Brokers
Endpoints específicos, limites de taxa, mínimos de conta, níveis de aprovação de opções, assinaturas de dados de mercado e tabelas de comissão por mercado estão na documentação da Interactive Brokers. Considere-os como a fonte da verdade.
- interactivebrokers.com/productsCobertura de produtos e mercados
- ibkrcampus.com/ibkr-api-pagePortal de API da IBKR
- interactivebrokers.github.io/tws-apiRepositório oficial da TWS API
- brokercheck.finra.org/firm-summary/36418FINRA BrokerCheck para Interactive Brokers LLC
- nfa.futures.org BASIC (NFA ID 0258600)Registro CFTC/NFA
Seção 03 · Desenvolva com IA
Construa sua estratégia da IBKR com IA
Escolha um método de integração (TWS API para capacidade máxima, Client Portal API para nuvem pura sem gateway local), faça um fork de um starter e desenvolva sua estratégia em uma IDE de IA. Cursor, Claude Code, GitHub Copilot e agentes de CLI funcionam com o mesmo fluxo de deploy nativo do GitHub.
TWS API (socket)
A principal API da IBKR. Oferece a maior gama de recursos, mas requer um processo local do TWS ou IB Gateway em execução para a conexão da estratégia. Use ibapi (oficial) ou ib_async (fork assíncrono comunitário da ib_insync) para Python.
Client Portal API (REST)
Superfície REST mais WebSocket autenticada via OAuth 2.0. Menos recursos que a TWS API, mas dispensa um gateway local, facilitando deploys puramente em nuvem.
Web API (REST)
Superfície REST mais recente da IBKR. Atualmente possui um subconjunto de recursos em comparação com a TWS API e a Client Portal; a cobertura está sendo expandida.
Framework ou conector personalizado
NautilusTrader, Backtrader, QuantConnect e motores proprietários encapsulam a superfície da TWS API. Escolha de acordo com o framework que você já utiliza.
Suporte de bibliotecas e frameworks para produtos da IBKR
A ibapi e a ib_async cobrem toda a superfície da TWS API, que é o conjunto de recursos mais amplo da IBKR. A Client Portal API abre mão de alguns tipos de ordens avançadas em troca de uma arquitetura REST + OAuth2 ideal para a nuvem. Adaptadores de framework (NautilusTrader, Backtrader) encapsulam uma das superfícies subjacentes; os recursos são herdados da superfície que eles utilizam.
✓ suporte confirmado de acordo com a documentação da biblioteca ou do adaptador. "parcial" indica cobertura parcial; verifique a documentação atual da integração antes de utilizá-la.
O TradingHost não impõe o uso de nenhuma biblioteca. Ele executa o seu projeto.
Desenvolva com IA
Os clientes REST ibapi, ib_async e Client Portal API funcionam perfeitamente com IDEs de IA. A interface de controle do TradingHost MCP fecha o ciclo: as ferramentas de IA podem inspecionar implantações, revisar logs e gerenciar o runtime junto com você, sem nunca interferir no caminho de execução das ordens.
Seção 04 · Execute no TradingHost
Execute seu código no TradingHost
A Interactive Brokers fornece a conta na corretora, o acesso à API e o ambiente de execução. O TradingHost fornece o ambiente de produção onde sua estratégia conectada à IBKR é executada.
Em vez de rodar o código da estratégia em um notebook, computador desktop, VPS genérico ou servidor configurado manualmente, você faz o deploy a partir do GitHub em um runtime de container gerenciado pelo TradingHost.
Você
- Seu repositório contém seu código.
- Seu deploy define como ele é executado.
- Sua estratégia se conecta à Interactive Brokers.
TradingHost
- Mantém o runtime online.
- Exibe logs e health checks.
- Seleção de região.
- Superfície de deploy controlada.
Fluxo de deploy
- PASSO 01
Conecte o GitHub
Autorize o TradingHost a acessar sua conta do GitHub.
- PASSO 02
Vincule um repositório ou use um template inicial
Aponte o TradingHost para o repositório existente da sua estratégia da IBKR ou faça um fork de um modelo inicial de ibapi ou ib_async para ter uma base funcional.
- PASSO 03
Faça o deploy em um container do TradingHost
Escolha uma região (US-East fica mais próxima dos mecanismos de correspondência de ações dos EUA e futuros da CME; EU é a escolha natural para estratégias da sessão europeia e futuros da Eurex), informe suas credenciais da IBKR e a configuração do gateway como variáveis de ambiente, e faça o deploy. O TradingHost compila seu container a partir do repositório e executa sua estratégia em uma infraestrutura gerenciada de Kubernetes. Estratégias de TWS API que exigem um processo local do IB Gateway podem rodar esse gateway como um sidecar; estratégias de Client Portal API e Web API não precisam de gateway.
- PASSO 04
Monitore logs e integridade
Acompanhe logs em tempo real, integridade e o estado do runtime diretamente pelo painel do TradingHost. Essa mesma interface pode ser acessada via MCP a partir de qualquer AI IDE, permitindo que o Cursor, Claude Code ou um agente de CLI leiam o estado do deploy e gerenciem o runtime junto com você. A execução dos trades permanece no caminho do código da estratégia, não no MCP.
- PASSO 05
Atualize e faça um novo deploy
Envie as alterações para a branch principal do seu GitHub e o TradingHost realiza o redeploy de forma automática. Uma implantação configurada com uma conta paper é o ambiente de testes ideal antes de migrar para as credenciais de produção (live).
Seção 05 · Notas operacionais
Notas operacionais para a Interactive Brokers
Obstáculos que você enfrenta ao executar uma estratégia da Interactive Brokers em um runtime de nuvem em contêiner, detalhes que nem sempre estão na documentação da IBKR ou nos READMEs dos frameworks. Cada afirmação abaixo foi citada ou parafraseada da própria documentação da Interactive Brokers ou de uma fonte regulatória primária; as orientações de implantação vêm da experiência de rodar essas estratégias no TradingHost.
01 · Três interfaces de API
TWS API, Client Portal API e Web API não são intercambiáveis
A Interactive Brokers expõe três interfaces de programação distintas. A TWS API é um protocolo de socket usado por ibapi e ib_async; ela exige a execução local de um processo do TWS ou do IB Gateway ao qual a estratégia se conecta. A Client Portal API é baseada em REST e WebSocket com OAuth 2.0; ela não precisa de um gateway local. A Web API é uma interface REST mais recente e com cobertura mais limitada atualmente. Escolha a interface ideal durante o design da estratégia; mudar no meio do caminho exige reescrever o código, não apenas alterar uma configuração.
02 · Gateway local do TWS
A TWS API exige um processo local do TWS ou do IB Gateway para conexão da estratégia
A TWS API é um protocolo de socket que se conecta a uma instância local do TWS (Trader Workstation) ou do IB Gateway nas portas 7496 ou 7497 para o TWS, ou 4001 ou 4002 para o IB Gateway (produção e paper, respectivamente). Para implantações exclusivamente em nuvem, execute o IB Gateway como um contêiner sidecar junto com a estratégia ou utilize a Client Portal API. O gateway "local" pode rodar no mesmo contêiner do TradingHost ou em um contêiner adjacente no mesmo pod do Kubernetes.
03 · Conta paper
O paper trading utiliza um número de conta e credenciais separados
O paper trading na Interactive Brokers é disponibilizado por meio de um número de conta separado, e não por uma URL de ambiente distinta. O usuário faz login no TWS ou no IB Gateway com as credenciais de simulação (paper) e o gateway se conecta ao serviço de simulação. O código da estratégia não muda entre os ambientes de simulação (paper) e produção (live), mas a configuração do gateway e a conexão da API (porta e ID da conta) mudam. Mantenha as credenciais de simulação e produção em entradas separadas no Secrets do TradingHost.
04 · Pattern Day Trader
A regra de PDT se aplica a contas de margem com saldo inferior a $25,000, conforme a FINRA Rule 4210
A FINRA Rule 4210 classifica uma conta de margem como Pattern Day Trader após a realização de quatro ou mais day trades em um período de cinco dias úteis, restringindo novas operações de day trade até que o patrimônio líquido atinja $25,000. A Interactive Brokers aplica essa regra rigorosamente em contas de margem. Contas de caixa (cash accounts) não estão sujeitas à regra de PDT, mas ficam sujeitas aos prazos do ciclo de liquidação (T+1 para ações dos EUA desde 2024-05-28). Planeje sua implantação considerando essas restrições.
05 · Aprovação para opções
A aprovação para operar opções é por conta e independente da aprovação para ações
A negociação de opções na IBKR exige uma etapa de aprovação separada, além do cadastro inicial na corretora. O nível aprovado determina quais estratégias de opções a corretora aceita: lançamentos cobertos (covered calls) e puts garantidas por caixa (cash-secured puts) no nível mais baixo, e opções vendidas a descoberto (uncovered short options) no nível mais alto. Ordens que excedem o nível aprovado são rejeitadas na corretora, não no TradingHost. Desenvolva suas estratégias de acordo com o seu nível aprovado ou solicite um upgrade de permissão junto à IBKR antes de realizar o deploy.
06 · Dados de mercado
As assinaturas de dados de mercado são por mercado e não vêm inclusas por padrão
A Interactive Brokers cobra assinaturas de dados de mercado por mercado específico (profundidade de livro da NASDAQ dos EUA, NYSE OpenBook, opções OPRA dos EUA, futuros da CME, profundidade da LSE, entre outros). Uma estratégia que consulta dados de mercado sem uma assinatura ativa receberá cotações atrasadas ou respostas vazias. Configure suas assinaturas de dados no portal do usuário antes de implantar uma estratégia que dependa de dados em tempo real para um mercado específico.
07 · SmartRouting
O SmartRouting é o padrão; o roteamento direto é definido por ordem
A Interactive Brokers roteia ordens via SmartRouting por padrão, selecionando o ambiente de execução com o melhor preço disponível líquido de comissões. Para usar o roteamento direto, especifique o parâmetro da bolsa (exchange) diretamente na ordem. O SmartRouting afeta a execução, a latência e os rebates de taxas de bolsa; estratégias que dependem da interação com um ambiente de execução específico devem optar pelo roteamento direto.
Seção 06 · Desenvolvido para
Desenvolvido para
Os runtimes do TradingHost para Interactive Brokers são ideais para:
- Desenvolvedores que criam estratégias em IDEs de IA (Cursor, Claude Code)
- Traders sistemáticos de múltiplos ativos
- Operadores de estratégias de opções e futuros
- Desenvolvedores quantitativos migrando de notebooks para produção
- Criadores de estratégias de ações globais e FX
Conectar o GitHub e criar sua primeira estratégia é grátis.
Seção 08 · FAQ
Perguntas frequentes
Não. O TradingHost é independente e não possui qualquer afiliação com a Interactive Brokers LLC ou com a Interactive Brokers Group, Inc.
Não. O TradingHost é um ambiente de execução (runtime) para códigos de estratégias de trading. A Interactive Brokers LLC é a corretora (broker-dealer), registrada na SEC e na FINRA (CRD 36418), na CFTC e na NFA (NFA ID 0258600), além de ser membro da SIPC com cobertura de seguro adicional via Lloyds. Sua conta, custódia, acesso ao mercado, liquidação, margem e relatórios fiscais ficam todos sob a responsabilidade da Interactive Brokers.
Não. O código da sua estratégia se conecta à Interactive Brokers e envia as instruções de ordens de acordo com a sua própria lógica, permissões de conta e método de integração. O TradingHost fornece apenas o ambiente de execução (runtime) onde esse código roda.
Não. O acesso à API da IBKR é fornecido pela própria Interactive Brokers. Você é o único responsável pela sua conta na IBKR, permissões de API, credenciais e conformidade com os termos de uso da IBKR.
A TWS API (via ibapi ou ib_async) possui a cobertura de recursos mais ampla, mas exige a execução local de um processo do TWS ou do IB Gateway. A Client Portal API é baseada em REST e OAuth 2.0 e dispensa o uso de um gateway local, sendo mais simples para implantações puramente em nuvem. Se a sua estratégia exige tipos de ordens avançados, gregas de opções em tempo real ou recursos que apenas o protocolo de socket do TWS oferece, utilize a TWS API e execute o IB Gateway como um sidecar. Se uma arquitetura REST for suficiente, prefira a Client Portal API pela facilidade de implantação.
Sim, caso opte pela TWS API. O IB Gateway é uma aplicação leve em Java que realiza a autenticação junto à IBKR e expõe um socket local ao qual a estratégia se conecta. No TradingHost, você executa o IB Gateway como um processo sidecar no mesmo pod do Kubernetes que a estratégia, ou pode optar pela Client Portal API, eliminando a necessidade do gateway.
Sim, desde que tenha a aprovação para opções na IBKR. A aprovação para opções é por conta e independente da aprovação para ações; o nível aprovado define quais estratégias a corretora aceita. O TradingHost não contorna as regras de aprovação de opções.
Sim, desde que tenha a aprovação para operar futuros na IBKR. A negociação de futuros exige uma etapa de aprovação separada, além do cadastro na corretora, devido aos requisitos da CFTC e da NFA.
A ibapi é a biblioteca Python oficial da Interactive Brokers e reflete diretamente o protocolo de socket. A ib_insync era uma biblioteca da comunidade compatível com asyncio, mas seu autor original a marcou como não mantida ativamente. A ib_async é o fork comunitário da ib_insync que continua recebendo atualizações. Para novas estratégias, utilize ibapi ou ib_async; para códigos existentes em ib_insync, planeje uma migração para ib_async, já que a API é amplamente compatível.
Conecte seu repositório do GitHub que contém o código da estratégia, vincule-o ao TradingHost e faça o deploy. Use um deploy configurado com chaves de paper account como ambiente de teste e mude para chaves de conta real assim que a estratégia estiver estável. Vincular o GitHub e criar uma estratégia é gratuito; os planos de runtime estão listados na página de preços.
No seu fluxo de trabalho de secrets controlado pelo GitHub. O TradingHost as lê em tempo de execução (runtime) por meio de secrets de repositório do GitHub, secrets de ambiente ou do seu próprio processo homologado de gerenciamento de secrets. O TradingHost não precisa da custódia do seu nome de usuário, senha ou tokens OAuth do Client Portal API. Consulte a seção de secrets da plataforma para entender o modelo completo de tratamento.
Não. As estratégias nunca devem precisar de permissões de saque ou de movimentação de fundos. As credenciais precisam apenas dos escopos necessários para envio de ordens e acesso a dados de mercado.
Sim. O TradingHost oferece suporte a controle baseado em MCP para IDEs de IA, incluindo Cursor, Claude Code, GitHub Copilot e agentes de IA baseados em CLI. As ferramentas de IA podem inspecionar deploys, analisar logs, reiniciar estratégias e gerenciar fluxos de trabalho de runtime. O MCP é uma interface de controle e observabilidade, não o caminho de execução de ordens. Consulte a página sobre a interface de controle MCP para obter mais detalhes.
Não. A regra de PDT (FINRA Rule 4210) é aplicada pela Interactive Brokers, não pelo TradingHost. Contas de margem com saldo inferior a $25.000 estão sujeitas às restrições de PDT para day trading. Sua estratégia deve respeitar a sinalização (flag) de PDT da corretora na conta.
Não. Seus formulários 1099 são emitidos pela Interactive Brokers no fim do ano, não pelo TradingHost. O TradingHost fornece o runtime; a IBKR cuida dos relatórios fiscais da corretora.
Não. O SIPC cobre sua conta de corretagem na IBKR em até $500.000 (incluindo $250.000 em dinheiro) sob a proteção de membro do SIPC, com seguro adicional excedente oferecido pela IBKR via Lloyds. O runtime do TradingHost não possui seguro do SIPC porque o TradingHost não é uma corretora.
O TradingHost roda nas regiões EU e US-East. A região US-East fica mais próxima dos mecanismos de correspondência de ações dos EUA e de futuros da CME, sendo a escolha natural para a maioria das estratégias da IBKR voltadas para os EUA. A região EU é ideal para estratégias da sessão europeia e futuros da Eurex. Consulte a página de regiões para mais detalhes sobre roteamento e proximidade.
Não. O TradingHost é focado em runtime de produção e deploy. O backtest deve ser feito na sua stack de pesquisa, framework ou no AlgoBuilder.