Runtime nativo de IA para estratégias de trading na FOREX.com
Desenvolva estratégias REST para FOREX.com e StoneX GAIN Capital 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 MCP de primeira classe, logs e seleção de região.
Seção 01 · Visão rápida
Visão rápida
- Corretora
- FOREX.com (GAIN Capital, uma subsidiária do StoneX Group)
- Tipo de corretora
- Corretora de Forex e CFD, acessível nos EUA
- Classe de ativos
- Forex, CFDs de índices, CFDs de commodities, metais, CFDs de ações (por entidade)
- Produtos compatíveis
- Mais de 80 pares de moedas spot FX, CFDs de índices maiores e menores, metais (XAU/USD, XAG/USD), energias, soft commodities e CFDs de ações em entidades fora dos EUA. Clientes dos EUA acessam spot FX e os produtos de metais e índices no estilo futuros permitidos pelas regras de varejo da CFTC.
- Modelo de runtime
- Runtime de estratégia em container
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem que rode em um container
- Integrações comuns
- API REST da FOREX.com (infraestrutura compartilhada da StoneX em ciapi.cityindex.com), NautilusTrader, clientes REST nativos, conectores personalizados
- Integração com fluxos de IA
- Superfície de controle MCP para Cursor, Claude Code, GitHub Copilot e agentes de CLI
- Papel da TradingHost
- Runtime, deploy, logs, verificações de integridade, seleção de região, controle MCP
- Papel da FOREX.com
- Conta de corretora, acesso à API, acesso ao mercado, local de execução
- Reguladores
- GAIN Capital Group LLC (CFTC RFED, registrada na NFA, EUA); GAIN Capital UK Limited (referência de firma FCA 113942); StoneX Financial Pty Ltd (ASIC AFSL 345646, Austrália, FOREX.com); GAIN Global Markets Inc (CIMA, Ilhas Cayman).
- Limites de alavancagem para varejo
- EUA (GAIN Capital Group LLC, NFA Rule 2-43b): 50:1 em FX principal, 20:1 em FX secundário. Reino Unido (FCA, alinhado à ESMA), UE e Austrália (ASIC): 30:1 em FX principal, 20:1 em FX secundário e ouro, 10:1 em commodities que não sejam ouro e índices secundários, 5:1 em ações, 2:1 em CFDs de cripto. A entidade de Cayman pode permitir alavancagem maior conforme as regras da CIMA.
- Divulgação da controladora
- A GAIN Capital foi adquirida pela StoneX Group Inc. (NASDAQ: SNEX) em julho de 2020 e agora é uma subsidiária integral.
- Afiliação
- O TradingHost é independente e não é afiliado à FOREX.com, GAIN Capital, StoneX Group ou City Index (uma marca irmã sob a GAIN Capital)
Seção 02 · O que FOREX.com oferece
O que FOREX.com oferece
A FOREX.com oferece spot FX, CFDs de índices e commodities, metais preciosos e CFDs de ações (em entidades fora dos EUA) por meio de uma API REST hospedada na infraestrutura compartilhada da GAIN Capital / StoneX em ciapi.cityindex.com. Clientes dos EUA usam o subconjunto permitido pela CFTC. Detalhes de endpoints, identificadores de instrumentos e limites de taxa (rate limits) estão disponíveis na documentação para desenvolvedores da StoneX-GAIN.
Mercados e padrões de estratégia
- Estratégias REST em mais de 80 pares de moedas de FX
- Estratégias de FX principal acessíveis nos EUA (NFA Rule 2-43b)
- Breakout de CFDs de índices maiores e menores (apenas entidades dos EUA/Reino Unido)
- Estratégias de metais preciosos para XAU/USD e XAG/USD
- Estratégias de CFDs de energia em WTI e Brent
- Deploys validados em conta demo promovidos para conta real
Superfície da API
- Superfícies de produtos
- Mais de 80 pares de moedas spot FX, CFDs de índices maiores e menores, metais (XAU/USD, XAG/USD), energias (WTI, Brent) e soft commodities. Entidades fora dos EUA (Reino Unido, Austrália, CIMA) oferecem CFDs de ações. Clientes dos EUA veem o subconjunto permitido pela CFTC: spot FX mais os produtos de metais e índices no estilo futuros. As contas demo e real são separadas.
- Métodos de conexão
- API REST hospedada em ciapi.cityindex.com (a infraestrutura compartilhada da StoneX-GAIN usada pela FOREX.com e pela marca irmã City Index). A mesma superfície REST cobre gerenciamento de sessão, contas, ordens, posições, dados de mercado e preços históricos. O streaming via WebSocket está disponível para preços em tempo real e eventos de negociação.
- Autenticação
- Autenticação baseada em sessão com usuário e senha (ou AppKey, dependendo do processo de abertura de conta na entidade). A chamada inicial para /Session retorna um session token usado nas requisições subsequentes. O acesso à API em conta real geralmente exige o envio de um e-mail para a equipe de suporte da FOREX.com para habilitar o REST na conta real; as contas demo têm o REST habilitado por padrão para desenvolvimento.
Para detalhes específicos, consulte a FOREX.com e a StoneX-GAIN
Endpoints específicos, caminhos de host, fluxo de autenticação e limites de taxa (rate limits) estão disponíveis na documentação REST da GAIN Capital. Considere-os como a fonte única de verdade.
- forex.com/en/trading-tools/api-tradingVisão geral da API REST da FOREX.com
- docs.labs.gaincapital.comDocumentação da API REST da GAIN Capital / StoneX
- docs.labs.gaincapital.com (getting started)Autenticação REST e referências de host
- nfa.futures.org BASIC databaseVerificação de registro CFTC/NFA para GAIN Capital Group LLC
- stonex.comStoneX Group, controladora da FOREX.com (NASDAQ: SNEX)
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para FOREX.com com IA
Escolha um método de integração, faça um fork de um starter de framework do TradingHost e desenvolva sua estratégia em uma IDE de IA. A API REST da FOREX.com é o caminho canônico compatível com o TradingHost. Clientes dos EUA operam dentro do conjunto de produtos permitido pela CFTC.
REST nativo da FOREX.com
Controle direto sobre o comportamento da FOREX.com, session tokens, estado da conta e o modelo de ordens da StoneX-GAIN.
NautilusTrader
Framework em Python com integrações para corretoras de FX. Útil para estratégias baseadas em eventos que compartilham código com backtests.
MetaTrader 4 / 5 (dependente da entidade)
A FOREX.com oferece MT4 e MT5 em entidades selecionadas. Modelo de EA no terminal, não uma carga de trabalho em container do TradingHost.
Conector personalizado
Seu próprio cliente em Python, JavaScript, Java, .NET, Go ou Rust sobre a API REST da FOREX.com e o endpoint de streaming WebSocket.
Suporte de frameworks para produtos FOREX.com
A API REST da FOREX.com e a API REST compartilhada da StoneX-GAIN cobrem toda a gama de produtos, com CFDs de ações disponíveis apenas em entidades fora dos EUA. Clientes dos EUA operam dentro do subconjunto permitido pela CFTC. CFDs de cripto não fazem parte da oferta de varejo atual da FOREX.com.
✓ suporte confirmado de acordo com os documentos da API REST da FOREX.com e a documentação da StoneX-GAIN. "fora dos EUA" indica que o produto é oferecido fora do nível de varejo dos EUA. "limitado" indica cobertura parcial do adaptador do framework. Os links de fluxo de trabalho apontam para páginas em /workflows/ atualmente em desenvolvimento.
O TradingHost não impõe um framework. Ele executa o seu projeto.
Desenvolva com IA
Os templates de framework acima funcionam perfeitamente com AI IDEs. A interface de controle MCP do TradingHost fecha o ciclo: as ferramentas de IA podem inspecionar implantações, analisar logs e gerenciar o ambiente de execução 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 FOREX.com (GAIN Capital, uma subsidiária do StoneX Group) fornece a conta da corretora e a API REST. O TradingHost fornece o ambiente de produção onde sua estratégia conectada à FOREX.com é 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 a implantação a partir do GitHub em um ambiente de execução de containers gerenciado pelo TradingHost.
Você
- Seu repositório contém seu código.
- Sua implantação define como ele é executado.
- Sua estratégia se conecta à FOREX.com via REST.
TradingHost
- Mantém o ambiente de execução online.
- Disponibiliza logs e verificações de integridade.
- Seleção de região.
- Interface de implantação controlada.
Fluxo de implantação
- PASSO 01
Conectar ao GitHub
Autorize o TradingHost a acessar sua conta do GitHub.
- PASSO 02
Vincule um repositório ou comece com um framework
Aponte o TradingHost para o repositório da sua estratégia existente ou faça um fork de um starter REST da FOREX.com do TradingHost para ter uma base funcional.
- PASSO 03
Implante em um container do TradingHost
Escolha uma região (US-East para contas da GAIN Capital Group LLC acessíveis nos EUA e os locais de matching da StoneX, EU para a entidade GAIN Capital UK regulada pela FCA), forneça as variáveis de ambiente que sua estratégia precisa (usuário e senha da FOREX.com ou AppKey, identificador da conta, host demo ou live) e faça o deploy. O TradingHost constrói seu container a partir do repositório e executa sua estratégia em uma infraestrutura gerenciada de Kubernetes.
- PASSO 04
Monitore logs e integridade
Acompanhe logs em tempo real, a integridade e o estado do ambiente de execução diretamente no painel do TradingHost. Essa mesma interface pode ser acessada via MCP a partir de qualquer AI IDE, permitindo que o Cursor, o Claude Code ou um agente de CLI leiam o estado da implantação e gerenciem o ambiente de execução junto com você.
- PASSO 05
Atualize e reimplante
Envie as alterações para a branch principal do seu GitHub (main) e o TradingHost fará a nova implantação de forma automática.
Seção 05 · Notas operacionais
Notas operacionais para a FOREX.com
Detalhes importantes que podem causar problemas ao executar uma estratégia da FOREX.com em um ambiente de nuvem em contêiner. Cada afirmação é baseada na documentação da FOREX.com, da StoneX-GAIN ou do órgão regulador correspondente; as orientações de implantação vêm da experiência prática de rodar essas estratégias na TradingHost.
01 · Infraestrutura compartilhada
A API REST da FOREX.com roda no host compartilhado ciapi.cityindex.com da StoneX-GAIN
A API REST da FOREX.com utiliza a mesma plataforma StoneX-GAIN usada pela marca irmã City Index. A URL base é ciapi.cityindex.com/tradingapi/. Essa infraestrutura compartilhada significa que os endpoints de sessão, de conta e o modelo de ordens são idênticos; a documentação em docs.labs.gaincapital.com se aplica tanto à FOREX.com quanto à City Index. Use o host correspondente ao seu ambiente (real ou demonstração) e à entidade sob a qual sua conta está registrada.
02 · Autenticação de sessão
Autenticação por session token; a liberação da API em conta real exige solicitação manual
A API REST da FOREX.com autentica por meio de uma chamada /Session que retorna um session token usado nas requisições seguintes. As contas de demonstração têm o REST habilitado por padrão para desenvolvimento. Já as contas reais costumam exigir liberação explícita: envie um e-mail para o suporte da FOREX.com informando o número da sua conta para que eles ativem o acesso REST. Mantenha o session token na memória do processo; nunca o envie para o seu repositório.
03 · NFA Rule 2-43b
GAIN Capital Group LLC (EUA) exige correspondência de ordens FIFO e proíbe hedge no mesmo instrumento
Sob a NFA Rule 2-43b, clientes de varejo da GAIN Capital Group LLC nos EUA não podem manter posições de compra (long) e venda (short) simultâneas no mesmo instrumento e devem fechar posições opostas na ordem em que foram abertas (primeiro a entrar, primeiro a sair - FIFO). Uma estratégia que envie uma ordem de hedge no mesmo par resultará na compensação (netting) contra a posição existente. Essa regra não se aplica às entidades da FOREX.com fora dos EUA (GAIN Capital UK, StoneX Financial Pty Ltd). Para estratégias distribuídas entre diferentes entidades, o mesmo código pode gerar resultados de P&L distintos entre contas americanas e não americanas.
04 · Transferência de controle
FOREX.com herdou a carteira de varejo da FXCM nos EUA em 2017; StoneX adquiriu a GAIN em 2020
Dois eventos societários são importantes na história da FOREX.com. Primeiro, em fevereiro de 2017, a CFTC baniu permanentemente a FXCM do mercado de varejo de FX nos EUA, e a FXCM transferiu suas contas de clientes americanos para a GAIN Capital, que já operava a FOREX.com. Segundo, a StoneX Group Inc. (NASDAQ: SNEX) adquiriu a GAIN Capital em julho de 2020. Assim, a entidade atual da FOREX.com é uma corretora acessível nos EUA (via GAIN Capital Group LLC), respaldada por uma controladora listada na NASDAQ, sendo a sucessora formal da carteira de varejo da FXCM nos EUA.
05 · Oferta de produtos nos EUA
Clientes nos EUA têm acesso apenas ao subconjunto de varejo permitido pela CFTC, não ao catálogo internacional completo da FOREX.com
Sob as regras de varejo da CFTC, clientes da GAIN Capital Group LLC nos EUA podem negociar spot FX e os produtos de índices e metais permitidos pelo regulador. Muitos CFDs disponíveis nas entidades do Reino Unido, Austrália e Ilhas Cayman (como CFDs de ações) não são oferecidos ao varejo americano. Uma estratégia com instrumentos de CFD de ações fixados no código (hard-coded) falhará ao enviar ordens para a entidade dos EUA. Leia os instrumentos disponíveis via API na inicialização e crie desvios condicionais baseados na entidade se o seu código rodar em diferentes regiões.
06 · Relatórios regulatórios
O envio de relatórios Dodd-Frank, EMIR e ASIC é de responsabilidade da FOREX.com
A GAIN Capital Group LLC reporta sob as regras de envio de dados de swap do Dodd-Frank Title VII como uma CFTC RFED. A GAIN Capital UK Limited reporta sob as regras da FCA / MiFID II / EMIR. A StoneX Financial Pty Ltd reporta sob as regras de relatórios de transações de derivativos da ASIC. A TradingHost não realiza relatórios regulatórios em seu nome e não é um serviço de reporte. O código da estratégia que você executa na TradingHost é de sua inteira responsabilidade algorítmica; as obrigações de reporte estão vinculadas à entidade da FOREX.com que mantém a sua conta.
Seção 06 · Desenvolvido para
Desenvolvido para
Os runtimes do TradingHost para FOREX.com são mais adequados para:
- Desenvolvedores criando estratégias em IDEs de IA (Cursor, Claude Code)
- Traders algorítmicos de FX com acesso aos EUA (cientes da NFA Rule 2-43b)
- Desenvolvedores de estratégias quantitativas de FX que utilizam a infraestrutura StoneX-GAIN
- Traders sistemáticos de índices e metais
- Equipes migrando do MetaTrader e hospedagem VPS para implantação em contêineres
Conectar o GitHub e criar sua primeira estratégia é grátis.
Seção 08 · FAQ
Perguntas frequentes
Não. A TradingHost é independente e não possui qualquer afiliação com a FOREX.com, GAIN Capital, StoneX Group ou qualquer entidade da City Index.
Não. A TradingHost não é uma corretora e não é uma empresa de investimento registrada. A TradingHost é um ambiente de execução em nuvem (runtime) para o código da sua estratégia. O relacionamento com a corretora, a conta, a alavancagem, a execução e as proteções regulatórias pertencem exclusivamente à entidade da FOREX.com que mantém a sua conta.
Não. O código da sua estratégia se conecta à API REST da FOREX.com e envia instruções de acordo com a sua própria lógica. A TradingHost fornece apenas o ambiente de nuvem onde esse código é executado.
Não. O acesso à API REST da FOREX.com é fornecido pela própria FOREX.com (GAIN Capital / StoneX). Você deve solicitar a ativação da API em conta real diretamente ao suporte da FOREX.com, sendo o único responsável por sua conta, credenciais e conformidade com os termos da corretora.
Sim. A GAIN Capital Group LLC é registrada na CFTC e membro da NFA, e a FOREX.com US aceita clientes de varejo dos EUA. Estratégias executadas no TradingHost na região US-East conectam-se perfeitamente com a entidade dos EUA. A NFA Rule 2-43b se aplica: sem hedging em um único instrumento, execução de ordens por FIFO.
Sim. A API REST da FOREX.com utiliza HTTP, portanto qualquer cliente HTTP em Python funciona. O endpoint de streaming via WebSocket pode ser consumido com qualquer biblioteca WebSocket padrão do Python.
Sim. A TradingHost suporta qualquer linguagem que possa ser executada dentro de um contêiner. Como o REST da FOREX.com é HTTP e o endpoint de streaming é WebSocket, qualquer linguagem que possua clientes HTTP e WebSocket funcionará.
A FOREX.com oferece suporte ao MT4 e MT5 em algumas entidades. Se a sua estratégia for um Expert Advisor em MQL, esse EA roda dentro do terminal MetaTrader e tradicionalmente exige uma VPS Windows. Para usar a TradingHost, porte a lógica para a API REST da FOREX.com; esse é o formato compatível com a nossa plataforma.
Abra uma conta na FOREX.com, envie um e-mail para o suporte solicitando a ativação do REST em sua conta real (ou use uma conta de demonstração, onde o REST já vem habilitado por padrão). Faça um fork de um modelo inicial REST da FOREX.com na TradingHost ou conecte seu próprio repositório de estratégia do GitHub. Vincular um repositório do GitHub e criar uma estratégia é gratuito; os planos de execução estão listados na página de preços.
Sim. A alavancagem é definida pela entidade da FOREX.com que mantém a sua conta. A GAIN Capital Group LLC (EUA, sob a NFA Rule 2-43b) oferece 50:1 para pares principais e 20:1 para secundários. A GAIN Capital UK (FCA) e a StoneX Financial Pty Ltd (ASIC) aplicam limites alinhados à ESMA. A entidade das Ilhas Cayman pode permitir alavancagem maior conforme as regras da CIMA. A interface da API é a mesma em todas as entidades.
No seu fluxo de trabalho de segredos controlado pelo GitHub. A TradingHost lê o usuário, a senha (ou AppKey) da FOREX.com e gerencia o ciclo de vida do session token em tempo de execução por meio de segredos do repositório do GitHub, segredos de ambiente ou pelo seu próprio processo homologado de gerenciamento de segredos.
Sim. A TradingHost suporta 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 implantações, analisar logs, reiniciar estratégias e gerenciar fluxos de trabalho de execução. O MCP é uma interface de controle e observabilidade, não o caminho de execução das operações.
Não. O reporte de operações sob Dodd-Frank, EMIR e MiFID II é de responsabilidade da corretora. A GAIN Capital Group LLC realiza o reporte sob as regras de reporte de dados de swap do Dodd-Frank Title VII. A GAIN Capital UK reporta sob a MiFID II e EMIR. A StoneX Financial Pty Ltd reporta sob as regras da ASIC. O TradingHost executa o seu código; a entidade da FOREX.com que mantém a sua conta cuida do reporte regulatório.
Não. O TradingHost é focado em runtime de produção e implantação. O backtesting pertence à sua infraestrutura de pesquisa, em um framework como o NautilusTrader ou no AlgoBuilder.