Implantação de estratégias de trading integrada ao GitHub
Conecte o GitHub, escolha seu próprio repositório ou crie um a partir de um template do TradingHost e implante estratégias de trading em runtimes de nuvem sempre ativos.
O TradingHost usa o GitHub como a única fonte de verdade para o código do seu robô. Cadastre-se com o GitHub, conecte um repositório existente ou crie um novo a partir de um template de código aberto ou do TradingHost, e inicie uma implantação que executa a estratégia selecionada em um runtime do TradingHost.
Ciclo de vida integrado ao GitHub
- Cadastro via GitHub
- Suporte a repositórios existentes
- Criação de repositório com um clique
- Implantações no nível da estratégia
- Controles de iniciar e parar
- Redeploy automático a partir da branch main
- Sem lock-in de estado
Seção 01 · Conceito
O que é um deploy no TradingHost?
Um deploy é uma instância ativa de uma estratégia de trading no TradingHost.
O seu repositório do GitHub contém o código. O TradingHost lê esse código, prepara o runtime, injeta as variáveis secretas configuradas e inicia a estratégia selecionada dentro de um ambiente em contêiner.
Um único repositório pode conter uma ou várias estratégias. Ao criar um deploy, você escolhe qual estratégia o TradingHost deve executar, onde ela deve rodar e qual configuração de runtime deve usar.
- Repositório
- equivale ao código-fonte.
- Estratégia
- equivale à lógica de trading que você escolhe executar.
- Deploy
- equivale à instância de runtime ativa que executa essa estratégia.
Seção 02 · Integração
Cadastre-se e faça o deploy com o GitHub
O TradingHost começa com o GitHub porque código de trading sério precisa de controle de versão, histórico de alterações revisável e uma fonte de verdade limpa.
Ao se cadastrar no TradingHost, você se autentica com o GitHub. A partir daí, pode conectar seu próprio repositório ou criar um novo usando um template compatível.
- PASSO 01
Cadastre-se com o GitHub
Use sua conta do GitHub para criar uma conta no TradingHost e autorizar as permissões de repositório necessárias.
- PASSO 02
Escolha o caminho do seu repositório
Conecte um repositório existente, crie um a partir de um template de framework de código aberto ou inicie um projeto em branco do TradingHost.
- PASSO 03
Configure o deploy
Escolha a estratégia, a região do runtime, as credenciais secretas, o perfil de recursos e as configurações de deploy.
- PASSO 04
Inicie
O TradingHost inicia a estratégia em um runtime gerenciado e transmite os logs diretamente para o seu painel.
Seção 03 · Caminhos de repositório
Traga seu próprio repositório ou crie um a partir de um template
O TradingHost suporta três maneiras de iniciar um deploy.
Traga seu próprio repositório
Já tem um projeto de trading no GitHub? Conecte o repositório ao TradingHost, escolha o ponto de entrada da estratégia, adicione as secrets, selecione uma região e faça o deploy.
Crie a partir de um template de framework open-source
Use uma estrutura de projeto pronta para deploy para frameworks open-source suportados, como CCXT ou Freqtrade. O TradingHost cria o repositório na sua conta do GitHub, e depois você personaliza o código e faz o deploy.
Crie um template em branco do TradingHost
Comece com uma estrutura de projeto limpa e pronta para o TradingHost. Isso é útil se você quiser criar sua própria estratégia em Python do zero, mantendo claras a configuração de runtime, a estrutura de pastas e o ponto de entrada do deploy.
Templates são estruturas iniciais de projeto (scaffolds), não estratégias lucrativas. Eles fornecem estrutura, exemplos de configuração e compatibilidade de runtime. Você entra com a lógica de trading, controles de risco e configuração da corretora ou exchange.
Seção 04 · Propriedade do template
Ao escolher um template, o repositório é seu
Se você escolher um template de framework open-source ou um template em branco do TradingHost, o TradingHost criará um novo repositório na sua conta do GitHub.
Esse repositório pertence a você. Você pode editá-lo, criar branches, fazer commits, revisá-lo e gerenciá-lo como qualquer outro projeto do GitHub. O TradingHost usa o repositório como origem do deploy, mas seu código permanece na sua conta do GitHub.
Um template inclui
- Estrutura do projeto
- Configuração de runtime
- Exemplos de nomes de variáveis de ambiente
- Um ponto de entrada da estratégia
- Exemplos de logs
- Arquivos de dependências
- Configuração de deploy do TradingHost
- Instruções básicas no README
Templates são estruturas iniciais de projeto (scaffolds), não estratégias lucrativas. Eles fornecem estrutura, exemplos de configuração e compatibilidade de runtime. Você entra com a lógica de trading, controles de risco e configuração da corretora ou exchange.
Seção 05 · Controles da estratégia
Faça o deploy da estratégia que você quer executar
Um repositório pode conter mais de uma estratégia, script ou ponto de entrada de runtime. O TradingHost trata o deploy como a instância de execução ativa, e não apenas como o repositório em si.
Ao iniciar um deploy, você escolhe a estratégia ou o ponto de entrada que deseja que o TradingHost execute. Depois, você pode iniciar, parar, reiniciar ou atualizar esse deploy diretamente pelo painel do TradingHost.
Iniciar a estratégia
Parar a estratégia
Reiniciar o runtime
Visualizar logs
Atualizar secrets
Alterar configuração de runtime
Fazer novo deploy do código mais recente
Revisar status do deploy
- O repositório
- é a sua base de código.
- O deploy
- é a estratégia em execução.
- O painel
- é a sua interface de controle.
Seção 06 · Redeploy automático
Push para a main, novo deploy em segundos
O TradingHost foi projetado para iterações rápidas. Quando você atualiza a branch main do repositório conectado, o TradingHost pode puxar as alterações mais recentes e refazer o deploy automaticamente.
Isso permite manter seu fluxo de trabalho de desenvolvimento centrado no GitHub. Faça uma alteração, envie um push para a main, e o deploy em execução receberá a versão mais recente sem a necessidade de reconstruir seu ambiente manualmente.
- Edite sua estratégia localmente ou no seu ambiente de desenvolvimento de IA
- Faça o commit e o push das alterações para a branch main
- O TradingHost detecta a atualização
- O deploy puxa o código mais recente
- O runtime é reiniciado com a nova versão
- Os logs mostram o comportamento atualizado do runtime
Seção 07 · Responsabilidade pelo estado
A TradingHost faz o redeploy do código. Você é o responsável pelo estado da estratégia.
A TradingHost não armazena o estado da sua estratégia para você.
Quando um deployment é reinstalado, reiniciado ou movido para um novo runtime, seu código deve ser projetado para se recuperar com segurança. Qualquer estado de estratégia, rastreamento de posição, monitoramento de ordens abertas, persistência em banco de dados, checkpointing ou lógica de reconciliação é de sua responsabilidade, a menos que seja fornecido explicitamente pela sua própria aplicação ou por serviços externos.
Exemplos de estado
- Estado das posições abertas
- Último candle ou trade processado
- IDs de ordens
- Níveis de grid
- Valores de trailing stop
- Contadores de risco
Orientações
Para operações em conta real, sua estratégia deve ser capaz de reconstruir seu estado atual a partir das APIs da corretora ou exchange, de dados externos armazenados ou de sua própria camada de persistência. Não dependa de estados em memória para sobreviver a um redeploy, reinicialização ou falha.
Limite claro
A TradingHost fornece controles de deployment, runtime e observabilidade. Ela não garante a continuidade do estado da estratégia em memória criado pelo usuário.
Seção 08 · Assistido por IA
Desenvolvido para fluxos de trabalho com IA
Os deployments da TradingHost foram projetados para funcionar com fluxos de desenvolvimento assistidos por IA. Você pode criar e editar estratégias em ferramentas como Cursor ou Claude Code, enviar as alterações para o GitHub e deixar que a TradingHost faça o redeploy da versão mais recente.
Com o suporte a MCP, ferramentas compatíveis também podem interagir com funções da TradingHost, como listar deployments, inspecionar logs e acionar novos redeploys.
Seção 09 · Ciclo de vida
O ciclo de vida do deployment
Cada deployment segue um ciclo de vida simples, desde o repositório até a estratégia em execução.
Criado
O deployment está configurado, mas ainda não está em execução.
Iniciando
A TradingHost está preparando o runtime e iniciando o processo da estratégia.
Em execução
A estratégia está ativa dentro do runtime selecionado.
Parado
O deployment foi interrompido intencionalmente e nenhum processo de estratégia está em execução.
Reiniciando
A TradingHost está reiniciando o runtime ou o processo da estratégia.
Fazendo redeploy
A TradingHost está baixando o código mais recente e iniciando o deployment novamente.
Falhou
O runtime ou o processo da estratégia falhou ao iniciar ou continuar em execução. Os logs devem ser analisados.
Os status de deployment ajudam você a entender o que a TradingHost está fazendo e onde olhar em seguida. Se um deployment falhar, os logs são o primeiro lugar a ser verificado.
Seção 10 · Divisão de responsabilidades
Onde termina a TradingHost e onde você começa
A TradingHost gerencia a camada de deployment em torno do seu código de trading. Você continua sendo o responsável pelo sistema de trading em si.
A TradingHost gerencia
A camada de deployment
- Conexão com o GitHub
- Seleção ou criação de repositório
- Configuração do deployment
- Inicialização do runtime
- Injeção de segredos
- Seleção de região
- Estado básico de integridade
- Streaming de logs brutos
- Controles de inicialização e parada
- Fluxo de redeploy
Você é responsável por
O sistema de trading
- Lógica da estratégia
- Permissões de corretoras e exchanges
- Criação de chaves de API
- Controles de risco
- Reconciliação de posições
- Tratamento de ordens
- Tratamento de erros
- Persistência externa
- Testes antes de operar em produção
- Monitoramento do comportamento em produção
- Conformidade com os termos da corretora ou exchange
Declaração direta
O TradingHost facilita o deploy e a operação de códigos de trading. Ele não torna o código de trading seguro, lucrativo ou correto por padrão.
Seção 11 · Padrões de repositório
Padrões de repositório suportados
O TradingHost foi projetado para suportar diferentes estruturas de repositório, desde que o ponto de entrada do deploy e a configuração de runtime estejam claros.
Repositório de estratégia única
Um repositório contém uma estratégia e um ponto de entrada de deploy.
Repositório multiestratégia
Um repositório contém várias estratégias. Cada deploy do TradingHost seleciona a estratégia que deve ser executada.
Projeto de framework
Um repositório contém um projeto de framework suportado, como CCXT ou Freqtrade.
Projeto em branco
Um repositório começa com uma estrutura em branco pronta para o TradingHost e evolui para a sua própria base de código de estratégia.
Para deploys previsíveis, mantenha os pontos de entrada, variáveis de ambiente e configurações de runtime explícitos.
FAQ
Perguntas frequentes
Sim. A versão 1 do TradingHost usa o GitHub como a fonte da verdade para o código da estratégia e atualizações de deploy.
Sim. Você pode conectar um repositório existente do GitHub e fazer o deploy de uma estratégia a partir dele.
Sim. Se você escolher um template de framework de código aberto ou um template em branco do TradingHost, o TradingHost poderá criar um novo repositório na sua conta do GitHub.
Não. Os templates são estruturas de projeto prontas para deploy. Eles podem incluir código de exemplo, configurações e pontos de entrada, mas não são estratégias lucrativas, sinais de trading ou recomendações financeiras.
Quando os redeploys automáticos estão ativados, o TradingHost pode fazer o pull das alterações mais recentes da branch main e realizar o redeploy do runtime associado em segundos.
Não. O TradingHost não armazena o estado da estratégia do usuário. Seu código deve gerenciar a persistência, a reconciliação com o broker e a lógica de recuperação caso sua estratégia dependa de estado entre reinicializações ou redeploys.
Sim. Um deploy pode ser iniciado, parado, reiniciado e sofrer redeploy a partir do painel do TradingHost.
Sim, desde que a estrutura do seu repositório e a configuração do deploy deixem claro o ponto de entrada de cada estratégia. Cada deploy deve especificar o que ele deve executar.
Não. O código da sua estratégia se conecta ao broker ou exchange e envia ordens de acordo com a sua lógica. O TradingHost fornece o runtime e a camada de deploy.
Sim. O TradingHost foi projetado para fluxos de trabalho compatíveis com MCP, permitindo que as ferramentas de desenvolvimento de IA suportadas inspecionem deploys, visualizem logs e disparem redeploys quando autorizadas.
Faça o deploy da sua estratégia a partir do GitHub
Conecte um repositório existente ou crie um a partir de um template do TradingHost, configure seu deploy e lance sua estratégia em um runtime que roda 24/7.