Runtime nativo de IA para estratégias de trading na Gemini
Desenvolva no Cursor, Claude Code ou em qualquer IDE de IA. Faça o deploy a partir do GitHub em um runtime em nuvem gerenciado com controle MCP nativo, logs e seleção de região.
Seção 01 · Visão rápida
Visão rápida
- Plataforma
- Gemini
- Tipo de plataforma
- Exchange de cripto e empresa fiduciária autorizada pelo NYDFS
- Classe de ativos
- Cripto (spot), perpétuos de cripto em jurisdições selecionadas fora dos EUA
- Produtos suportados
- Spot (web e mobile), ActiveTrader (interface avançada de livro de ofertas), Gemini Perpetuals (fora dos EUA, via Gemini Artemis Pte. Ltd., alavancagem de até 100x; pares como ETHGUSDPERP), Gemini Custody (custodiante qualificado, independente mas integrável), ambiente sandbox
- Modelo de runtime
- Runtime de estratégia em contêineres
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem compatível com contêineres
- Integrações comuns
- REST, WebSocket e FIX 4.4 nativos da Gemini, CCXT (gemini), clientes HMAC-SHA384 personalizados. Freqtrade e Hummingbot não possuem suporte oficial à Gemini.
- 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, health checks, seleção de região, segredos, controle MCP
- Papel de Gemini
- Conta na exchange, acesso à API, acesso ao mercado, local de execução, custodiante qualificado para usuários institucionais
- Afiliação
- O TradingHost é independente e não possui afiliação com a Gemini. A Gemini Trust Company, LLC é uma empresa fiduciária de propósito limitado de Nova York, autorizada pelo NYDFS (outubro de 2015). A controladora da Gemini foi listada na Nasdaq como GEMI em setembro de 2025.
Seção 02 · O que Gemini oferece
O que Gemini oferece
A Gemini é uma empresa fiduciária autorizada pelo NYDFS que oferece negociação spot por meio de seus aplicativos web e móveis, ActiveTrader para uma interface avançada de livro de ofertas, e Gemini Perpetuals para contas elegíveis fora dos EUA (operada pela Gemini Artemis Pte. Ltd.). A conectividade é feita via REST, WebSocket e FIX 4.4, com assinatura HMAC-SHA384. O Hummingbot e o Freqtrade possuem suporte limitado ou inexistente para a Gemini, portanto, a maior parte do código das estratégias é baseada na API nativa ou no CCXT. Símbolos específicos, limites de taxa (rate limits) e elegibilidade de mercado estão disponíveis na documentação da Gemini.
Mercados e padrões de estratégia
- Execução unificada no livro de ofertas do ActiveTrader
- Arbitragem combinada de livros de ofertas GUSD / USDC / RLUSD
- Deploys validados em sandbox antes do lançamento em produção
- Distribuição de chave master- entre subcontas institucionais
- Isolamento de nonce por sessão para instâncias de estratégia paralelas
- Kill switch Cancel All Session Orders ao parar a estratégia
- Rebalanceamento de tesouraria integrado à custódia
- Execução co-alocada via FIX 4.4 para mesas institucionais
Superfície da API
- Superfícies de produtos
- Exchange spot, ActiveTrader, Gemini Derivatives / Perpetuals (onde elegível), Sandbox (ambiente de testes independente).
- Métodos de conexão
- REST (HTTPS), WebSocket (público + privado), FIX 4.4 Order Entry, FIX 4.4 Market Data, FIX Drop Copy. O FIX exige uma conexão direta (cross-connect) a partir de um data center ou extranet homologada para a infraestrutura da Gemini na Costa Leste dos EUA; não está disponível via internet pública.
- Autenticação
- HMAC-SHA384 sobre um payload JSON codificado em base64. Assinatura em X-GEMINI-SIGNATURE, chave de API em X-GEMINI-APIKEY, payload em X-GEMINI-PAYLOAD. Prefixos de chave: master- (escopo de grupo, exige o parâmetro account) e account- (conta única). Cada chave provisionada é uma "sessão" com seu próprio fluxo de nonces.
Para detalhes específicos, consulte Gemini
Endpoints específicos, pesos de limite de taxa, listas de símbolos, faixas de taxas e histórico de versões estão na documentação da Gemini. Considere-os como a fonte oficial de informações.
- docs.gemini.comPortal de documentação da API da Gemini
- developer.gemini.com/authentication/api-keyAutenticação de chave de API e chaves de nível master- vs account-
- developer.gemini.com/get-started/sandboxAmbiente sandbox em api.sandbox.gemini.com
- developer.gemini.com/rate-limitLimites de taxa (120/min público, 600/min privado)
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para Gemini com IA
Escolha um método de integração, faça um fork de um starter de framework da TradingHost e desenvolva sua estratégia em uma AI IDE. Cursor, Claude Code, GitHub Copilot e agentes de IA baseados em CLI funcionam com o mesmo fluxo de deploy nativo do GitHub.
API nativa da Gemini
Controle direto sobre comportamentos específicos da Gemini (REST, WebSocket, FIX 4.4), dados de conta e lógica de execução de ordens.
CCXT
Interface comum entre a Gemini e outras exchanges de cripto por meio do conector gemini.
Freqtrade ou Hummingbot
O Hummingbot não possui conector para a Gemini. O Freqtrade é suportado apenas pela comunidade via CCXT e não é homologado oficialmente. A maior parte do código em produção usa a API nativa ou o CCXT.
Conector personalizado
Seu próprio motor de trading interno ou integração proprietária com a Gemini, geralmente desenvolvida com assinatura HMAC-SHA384 e a interface FIX 4.4.
Suporte de frameworks para produtos Gemini
A Gemini é uma empresa fiduciária autorizada pelo NYDFS com negociação spot via web e ActiveTrader, além de um ambiente separado para perpétuos operado pela Gemini Artemis em jurisdições selecionadas. O Hummingbot não possui conector para a Gemini e o Freqtrade só se conecta a ela via CCXT por meio de suporte da comunidade. Portanto, a maior parte do código de estratégias em produção é baseada em REST / WebSocket / FIX 4.4 nativos ou no CCXT.
✓ suporte confirmado de acordo com a documentação oficial do framework. "parcial" indica cobertura incompleta ou dependente da versão. "não" indica que não há suporte documentado oficialmente.
A TradingHost não impõe nenhum framework. Ela executa o seu projeto.
Desenvolva com IA
Os starters de framework acima combinam perfeitamente com AI IDEs. A interface de controle MCP da TradingHost fecha o ciclo: as ferramentas de IA podem inspecionar deploys, analisar logs e gerenciar o runtime junto com você, sem nunca interferir no caminho de execução das ordens.
Seção 04 · Execute na TradingHost
Execute seu código na TradingHost
A Gemini fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à Gemini é executada.
Em vez de executar 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 pela TradingHost.
Você
- Seu repositório contém seu código.
- Seu deploy define como ele é executado.
- Sua estratégia se conecta à Gemini.
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 a TradingHost a acessar sua conta do GitHub.
- PASSO 02
Vincule um repositório ou comece a partir de um framework
Aponte o TradingHost para o repositório da sua estratégia existente ou faça um fork de um runtime de framework do TradingHost (CCXT ou um starter nativo da Gemini) para ter uma base funcional.
- PASSO 03
Implante em um contêiner da TradingHost
Escolha uma região (EU ou US-East), forneça as variáveis de ambiente que sua estratégia precisa (chaves de API da Gemini, prefixo master- ou account-, segredo HMAC-SHA384) e faça o deploy. A TradingHost cria seu container a partir do repositório e executa sua estratégia em uma infraestrutura gerenciada de Kubernetes. Não é necessário instalar o Docker localmente.
- PASSO 04
Monitore logs e integridade
Acompanhe logs em tempo real, a integridade e o estado do runtime diretamente pelo painel da TradingHost. Essa mesma interface pode ser acessada via MCP a partir de qualquer AI IDE — assim, o Cursor, o Claude Code ou um agente de CLI podem ler o estado do deploy e gerenciar o runtime junto com você.
- PASSO 05
Atualize e faça o redeploy
Faça push das alterações para a branch principal do seu GitHub e a TradingHost realiza o redeploy de forma automática.
Seção 05 · Notas operacionais
Notas operacionais para Gemini
Problemas práticos ao executar uma estratégia da Gemini em um runtime em nuvem conteinerizado, que não constam na documentação da Gemini nem nos READMEs de frameworks. Cada ponto abaixo foi citado ou parafraseado da própria documentação da Gemini; as orientações de deploy vêm da experiência de rodar essas estratégias no TradingHost.
01 · Autenticação
A Gemini assina com HMAC-SHA384, não SHA256
Cada requisição privada precisa de X-GEMINI-APIKEY, um payload JSON codificado em base64 em X-GEMINI-PAYLOAD e o HMAC-SHA384 em hexadecimal desse payload (usando o segredo da API como chave) em X-GEMINI-SIGNATURE. Bibliotecas copiadas de exemplos da Coinbase ou Kraken quase sempre usam SHA256 por padrão e falham silenciosamente com InvalidSignature. O payload assinado deve incluir o caminho da requisição e um nonce, além do parâmetro account ao usar uma chave master-.
02 · Modelo de chaves
Chaves master- atuam em um grupo, chaves account- atuam em uma única conta
A Gemini agrupa várias contas sob uma única estrutura institucional. Uma chave com o prefixo master- pode direcionar comandos para qualquer conta do grupo enviando o apelido da conta no campo account do payload da requisição; já uma chave com o prefixo account- rejeita esse parâmetro. Escolher o tipo incorreto de chave é a causa mais comum de erros MissingRole / 403. Mantenha as chaves específicas de cada implantação no nível de conta (account) e reserve as chaves master para automações de tesouraria.
03 · Nonces
Cada chave de API tem seu próprio fluxo de nonces dentro de ±30 segundos do horário Unix
A documentação da Gemini define os nonces como estritamente crescentes por sessão (por chave de API), o que significa que duas chaves podem rodar em containers diferentes sem necessidade de sincronização de relógio. O nonce deve ser estritamente maior que o anterior para aquela chave e estar dentro de ±30 segundos do Unix epoch atual; violar qualquer uma dessas regras retorna InvalidNonce. Executar a mesma chave em dois containers diferentes é a falha mais comum. Provisione uma chave separada para cada runtime de estratégia e trate a chave como a unidade de escala horizontal.
04 · Sandbox
Valide em api.sandbox.gemini.com antes de ir para a produção
O ambiente de Sandbox fica em https://exchange.sandbox.gemini.com (interface gráfica) e https://api.sandbox.gemini.com mais wss://api.sandbox.gemini.com (API). As contas são criadas com saldos de teste em USD, BTC, ETH, BCH, LTC, OXT, LINK, BAT e DAI; os preços divergem dos de produção. Chaves de produção não funcionam no sandbox e vice-versa. A autenticação de dois fatores pode ser ignorada em automações usando o código 9999999.
05 · Rate limits
Público: 120/min, privado: 600/min, com fila de burst de até 5 requisições
A documentação da Gemini indica 120 requisições por minuto em endpoints públicos e 600 em endpoints privados, com médias estáveis de 1 e 5 requisições por segundo, respectivamente. A exchange enfileira até cinco requisições excedentes antes de retornar HTTP 429 com o motivo RateLimit. Picos de envio de ordens na abertura do mercado ou durante períodos de alta volatilidade são as causas clássicas de erros 429 autoinfligidos; agrupe em lotes e escalone os cancelamentos.
FonteGemini rate limits06 · Risco
Cancel All Session Orders é o seu kill switch
Cada ordem é registrada vinculada à chave de API que a criou. O endpoint Cancel All Session Orders afeta apenas as ordens abertas daquela chave específica, permitindo interromper uma estratégia descontrolada sem afetar outras estratégias irmãs que rodam com chaves diferentes na mesma conta. Configure isso no manipulador de SIGTERM do seu container para evitar que as implantações deixem ordens órfãs ativas. Combine essa função com o Cancel All Active Orders para paradas de emergência em toda a conta.
07 · Hardening
Restrinja as chaves aos IPs de saída da TradingHost antes de ativar a permissão de saque
A Gemini suporta a criação de listas de permissões com Trusted IPs nas chaves de API; requisições fora dessa lista falham com RemoteAddressForbidden. As chaves também possuem permissões separadas para trading, gestão de fundos e saques; conceder permissão de saque em uma chave de estratégia é uma prática insegura. Trate saques usando uma chave operacional separada, vinculada ao IP de um host de controle, e deixe os runtimes das estratégias usarem chaves exclusivas para trading.
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a Gemini são ideais para:
- Desenvolvedores que criam estratégias em IDEs de IA (Cursor, Claude Code)
- Traders sistemáticos de cripto
- Mesas institucionais reguladas nos EUA
- Usuários do CCXT
- Equipes migrando de hospedagem VPS para implantação em containers
Conectar o GitHub e criar sua primeira estratégia é grátis.
Seção 08 · Perguntas frequentes
Perguntas frequentes
Não. A TradingHost é independente e não possui afiliação com a Gemini. A Gemini Trust Company, LLC é uma empresa fiduciária de propósito limitado de Nova York, autorizada pelo NYDFS em outubro de 2015; sua controladora foi listada na Nasdaq como GEMI em setembro de 2025. O status de trust regulado é independente da TradingHost.
Não. O código da sua estratégia se conecta à Gemini e envia instruções de acordo com sua própria lógica, permissões de conta e método de integração. A TradingHost fornece o runtime onde esse código é executado.
Não. O acesso à API da Gemini é fornecido pela própria Gemini. Você é o responsável por sua conta na Gemini, permissões de API, credenciais e conformidade com os termos da exchange.
Não. A TradingHost é o runtime em nuvem onde o código da sua estratégia é executado. Nós não fornecemos sinais, modelos de previsão de IA ou estratégias prontas. Com a TradingHost, você mesmo escreve ou gera a estratégia (geralmente usando o Cursor ou o Claude Code), mantém o código no seu GitHub e usa a TradingHost para executá-lo em produção. Produtos como o 3Commas e o Cryptohopper controlam a lógica da estratégia; a TradingHost apenas executa a sua estratégia.
A AWS e a DigitalOcean fornecem infraestrutura de computação bruta. Você precisa gerenciar atualizações de sistema operacional, orquestração de containers, envio de logs, rotação de segredos, failover de região e monitoramento de uptime por conta própria. A TradingHost oferece um runtime gerenciado e desenvolvido sob medida para estratégias de trading: implantação nativa via GitHub, controle via MCP a partir de IDEs de IA, além de painéis de logs e monitoramento de integridade integrados. Se você prefere gerenciar a infraestrutura por conta própria, a AWS atende bem. Se prefere o runtime como um serviço gerenciado, a TradingHost é o caminho mais rápido.
Sim. A TradingHost executa estratégias em Python; escolha o runtime de framework compatível com sua stack ou implemente a partir do seu próprio repositório.
Sim. A TradingHost suporta qualquer linguagem de programação que possa ser executada dentro de um container.
Sim. O CCXT inclui um conector gemini com suporte a spot e processamento de swaps perpétuos em seu código-fonte. Verifique a cobertura de símbolos e endpoints de margem na sua versão atual do CCXT antes de depender de recursos de derivativos; as APIs nativas REST e WebSocket da Gemini continuam sendo o caminho de menor risco para derivativos. Consulte o runtime do framework CCXT para ver as instruções de configuração.
Sim, caso seu projeto tenha sido projetado dessa forma. Você pode executar múltiplos processos ou serviços de estratégia dentro de um único runtime, ou separá-los em runtimes diferentes para maior isolamento e clareza operacional. O modelo de nonce por sessão da Gemini se alinha perfeitamente ao uso de uma chave de API por estratégia. Consulte a página de runtimes da TradingHost para entender o modelo de múltiplas estratégias.
O caminho mais rápido é fazer um fork de um runtime de framework da TradingHost, como o CCXT, ou conectar seu próprio repositório de estratégia do GitHub desenvolvido com as APIs nativas REST, WebSocket ou FIX 4.4 da Gemini. Vincular um repositório do GitHub e criar uma estratégia é gratuito; os planos de runtime estão detalhados na página de preços.
No seu fluxo de trabalho de segredos controlado pelo GitHub. A TradingHost lê essas chaves em tempo de execução por meio de secrets do repositório do GitHub, secrets de ambiente ou pelo seu próprio processo homologado de gerenciamento de segredos. A TradingHost não precisa da custódia da sua chave de API e segredo. Consulte a seção de segredos da plataforma para entender o modelo completo de tratamento.
Não. As estratégias nunca devem precisar de permissões de saque. A Gemini oferece permissões com escopos específicos para trading, gestão de fundos e saques, além de listas de permissões com Trusted IPs. Mantenha as chaves de estratégia limitadas ao escopo exclusivo de trading e vincule-as aos IPs de saída da TradingHost da região selecionada; reserve a permissão de saque para uma chave operacional separada em um host de controle com IP fixo.
A Gemini retorna MissingRole (HTTP 403) quando uma chave de API não tem permissão para o endpoint, e RemoteAddressForbidden quando a requisição vem de um IP que não está na lista de permissões de Trusted IPs da chave. InvalidSignature e InvalidNonce são as outras duas falhas de autenticação que devem ser integradas aos seus alertas.
Dois containers usando a mesma chave de API geram uma condição de corrida na sequência de nonces. A Gemini limita o fluxo de nonces por chave (sessão), e o valor deve ser estritamente crescente e estar dentro de ±30 segundos do horário Unix. Provisione uma chave de API separada para cada instância de runtime; utilize nonces baseados em tempo apenas com semântica de gravação única (single-writer).
Sim. O 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 deploys, revisar logs, reiniciar estratégias e gerenciar fluxos de trabalho do runtime. O MCP é uma interface de controle e observabilidade, não o caminho de execução de ordens. Veja a interface de controle MCP para entender o funcionamento completo.
Ambos. A interface de controle MCP funciona igualmente bem a partir de agentes baseados em CLI (Claude Code CLI, clientes MCP personalizados, chamadas MCP via script) e de dentro de uma IDE. O fluxo de deploy nativo do GitHub também funciona sem qualquer ferramenta de IA: um simples git push para a sua branch main aciona um novo deploy.
O runtime detecta o crash e expõe os logs e informações de integridade relevantes. Onde houver suporte, a estratégia afetada pode ser reiniciada sem interromper outras estratégias executadas no mesmo container. Configure o Cancel All Session Orders no seu manipulador SIGTERM para que os deploys não deixem ordens obsoletas ativas; o código da sua estratégia ainda é responsável pelo tratamento seguro de erros, proteção contra ordens duplicadas e controles de risco. Veja a seção de observabilidade para acessar a interface de logs e integridade.
A TradingHost opera nas regiões EU e US-East. A conectividade FIX 4.4 da Gemini exige uma conexão direta (cross-connect) a partir de um data center ou extranet homologada para a infraestrutura dela na Costa Leste dos EUA, tornando a região US-East a escolha natural para estratégias na Gemini sensíveis à latência. Consulte a página de regiões para obter detalhes de roteamento e proximidade.
Sim. A Gemini Trust Company LLC é uma empresa fiduciária de finalidade limitada de Nova York, autorizada pelo NYDFS em outubro de 2015, o que a torna uma fiduciária e custodiante qualificada sob a Lei Bancária de Nova York. A controladora da Gemini Trust foi listada na Nasdaq como GEMI em setembro de 2025. O status de trust regulado é independente do TradingHost.
Não. O Gemini Earn era um produto de rendimento (não a exchange spot ou a API) que foi encerrado devido à falência da Genesis. Os clientes receberam recuperação integral em ativos (in-kind) durante as distribuições de maio a junho de 2024; a SEC retirou voluntariamente o processo contra a Gemini Trust com prejuízo em 23 de janeiro de 2026. Isso não afeta o acesso à exchange, o comportamento da API ou as operações de custódia.
Onde houver elegibilidade, sim. O Gemini Perpetuals é operado pela Gemini Artemis Pte. Ltd. em jurisdições selecionadas fora dos EUA, com alavancagem de até 100x e contratos denominados em GUSD (por exemplo, ETHGUSDPERP) ou USDC. O acesso para o varejo dos EUA está sendo desenvolvido por meio do mercado de contratos designado Gemini Titan, aprovado pela CFTC. Verifique a jurisdição da sua conta e a plataforma de listagem do ativo antes de fazer o deploy.
Não. O TradingHost é focado em runtime de produção e deploy. O backtest deve ser feito na sua própria infraestrutura de pesquisa, framework ou no AlgoBuilder.