Runtime nativo de IA para estratégias de trading na Gate.io
Desenvolva no Cursor, Claude Code ou em qualquer IDE de IA. Faça o deploy a partir do GitHub em um runtime gerenciado na nuvem com controle MCP nativo, logs e seleção de região.
Seção 01 · Visão rápida
Visão rápida
- Plataforma
- Gate.io (também sob a marca Gate.com desde o rebranding de 2024, com Gate.io ainda em uso ativo para referências de API e SDK)
- Tipo de plataforma
- Exchange de cripto (spot, margem, perpétuos liquidados em USDT/BTC, futuros de entrega, opções, copy trading, empréstimos)
- Classe de ativos
- Cripto
- Produtos suportados
- Spot (mais de 4.600 ativos), margem cruzada e isolada (~470 ativos, até 10x), perpétuos liquidados em USDT, perpétuos liquidados em BTC, futuros de entrega, opções de BTC/ETH/principais ativos (curto prazo de 1h/4h/24h e vencimentos padrão), copy trading, empréstimos. Alavancagem máxima em derivativos de até 125x.
- Modelo de runtime
- Runtime de estratégia em container
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem compatível com containers
- Integrações comuns
- Gate API v4 nativa (REST + WebSocket), CCXT (ID de exchange `gate`), Freqtrade (spot + futuros perpétuos), Hummingbot (`gate_io` e `gate_io_perpetual`), personalizada
- Integração com fluxo de IA
- Interface 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, injeção de segredos, controle MCP
- Papel de Gate.io
- Conta na exchange, emissão de chaves de API, dados de mercado, roteamento de ordens, custódia, liquidação
- Afiliação
- O TradingHost é independente e não possui afiliação com a Gate.io. A Gate.io está bloqueada na China continental desde setembro de 2021 e não está disponível para pessoas dos EUA.
Seção 02 · O que Gate.io oferece
O que Gate.io oferece
A Gate.io oferece spot em mais de 4.600 ativos, margem cruzada e isolada, perpétuos liquidados em USDT e BTC, futuros de entrega, opções de BTC, ETH e principais ativos, copy trading e empréstimos por meio de uma única interface Gate API v4 (REST + WebSocket). As estratégias são autenticadas com chaves assinadas por HMAC-SHA512; a Futures TestNet roda em um host separado com chaves próprias, e o mercado spot não possui sandbox público. Detalhes dos endpoints mudam com o tempo. A estrutura é estável; os limites de taxa precisos, faixas de taxas e listas de símbolos estão disponíveis na documentação da Gate.io.
Mercados e padrões de estratégia
- Rotação spot de altcoins de cauda longa
- Arbitragem perpétua entre exchanges (liquidada em USDT)
- Captura de taxa de financiamento e base perpétua liquidada em BTC
- Opções de BTC e ETH (curto prazo de 1h/4h/24h ou vencimentos padrão)
- Operações com margem cruzada e isolada
- Espelhamento de sinais de copy trading
- Execuções em sandbox de demonstração (Futures TestNet)
- Hierarquia de subcontas para isolamento de estratégias
Superfície da API
- Superfícies de produtos
- REST de Spot em `https://api.gateio.ws/api/v4` (endpoints de spot em `/spot/*`, margem em `/margin/*`); REST de Futures ativo em `https://api.gateio.ws/api/v4/futures/{usdt,btc}` (host alternativo `https://fx-api.gateio.ws/api/v4`); REST de Options em `/api/v4/options`. Futures TestNet em `https://fx-api-testnet.gateio.ws/api/v4` com chaves de API separadas. O mercado spot não possui sandbox público.
- Métodos de conexão
- REST v4 (JSON via HTTPS), WebSocket v4 com sockets separados por mercado: Spot em `wss://api.gateio.ws/ws/v4/`, Futures USDT em `wss://fx-ws.gateio.ws/v4/ws/usdt`, Futures BTC em `wss://fx-ws.gateio.ws/v4/ws/btc`, TestNet em `wss://fx-ws-testnet.gateio.ws/v4/ws/{usdt,btc}`. A API v2 foi descontinuada em 1º de setembro de 2023.
- Autenticação
- Assinatura HMAC-SHA512 com três cabeçalhos obrigatórios em endpoints privados: `KEY` (chave de API), `Timestamp` (segundos Unix), `SIGN` (HMAC-SHA512 em hex da string de assinatura). String de assinatura: `Method + "\n" + URL_Path + "\n" + QueryString + "\n" + HexEncode(SHA512(Body)) + "\n" + Timestamp`. Hierarquia de subcontas com transferência de ativos apenas da conta principal para subcontas (sem transferência direta entre subcontas).
Para detalhes específicos, consulte Gate.io
Endpoints específicos, pesos de limite de taxa, listas de símbolos, faixas de taxas e histórico de versões estão disponíveis na documentação da Gate.io. Considere-os como a fonte oficial de informações.
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para Gate.io 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.
Gate API v4 nativa
Controle direto sobre comportamentos específicos da Gate.io, roteamento de subcontas e lógica de execução de ordens em spot, margem, perpétuos, futuros de entrega e opções.
CCXT
Interface comum entre a Gate.io e outras exchanges de cripto. Use o ID de exchange `gate` (a classe ativa; `gateio` ainda resolve e herda de `gate`).
Freqtrade ou Hummingbot
Deploys baseados em frameworks usando suas estruturas de estratégia e modelos de configuração. O Freqtrade cobre spot e perpétuos liquidados em USDT da Gate.io; o Hummingbot oferece os conectores `gate_io` e `gate_io_perpetual`.
Conector personalizado
Seu próprio motor de trading interno ou integração proprietária com a Gate.io.
Suporte de frameworks para produtos Gate.io
A cobertura varia de acordo com o framework. O CCXT abrange a maior parte dos produtos da Gate.io (spot, margem, perpétuos, opções parciais); o Freqtrade cobre spot e perpétuos liquidados em USDT; o Hummingbot oferece conectores para spot e perpétuos; o acesso nativo à Gate API v4 cobre tudo o que a Gate.io oferece, incluindo opções de BTC, ETH e principais ativos.
✓ suporte confirmado de acordo com a documentação oficial do framework. "parcial" indica cobertura limitada ou apenas para dados de mercado. "não" indica que não há suporte documentado oficialmente. "n/a" indica que o framework não modela essa área do produto. Os links de fluxo de trabalho direcionam para páginas em /workflows/ atualmente em desenvolvimento.
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 Gate.io fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à Gate.io é 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 à Gate.io.
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 a TradingHost para o seu repositório de estratégia existente ou faça um fork de um runtime de framework da TradingHost (CCXT, Freqtrade ou Hummingbot) para obter uma base funcional.
- PASSO 03
Implante em um contêiner da TradingHost
Escolha uma região (EU ou US-East), forneça os valores de ambiente que sua estratégia precisa (chaves da Gate.io API v4 mais o padrão de assinatura HMAC-SHA512) 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. Sem necessidade de instalação local do Docker.
- 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 Gate.io
Problemas práticos que surgem ao executar uma estratégia da Gate.io em um runtime na nuvem baseado em containers — detalhes que não estão na documentação da Gate.io nem nos READMEs dos frameworks. Cada ponto abaixo foi citado ou parafraseado da própria documentação da Gate.io; as orientações de deploy vêm da experiência de rodar essas estratégias no TradingHost.
01 · API v4
v2 descontinuada em setembro de 2023, v4 é o único caminho
A API v2 foi descontinuada em 1º de setembro de 2023; chaves legadas da v2 não autenticam mais, e quaisquer ordens ou cancelamentos feitos na v2 falham silenciosamente ou retornam erro 401. Toda integração atual com a Gate.io deve apontar para os endpoints da v4 em api.gateio.ws/api/v4.
02 · Assinatura
HMAC-SHA512, codificado em hex, com hash do corpo integrado
A maioria das exchanges concorrentes assina com SHA256. A string de assinatura da Gate intercala \n entre o método, caminho (path), query, o hex-SHA512 do corpo (body) e o timestamp, e o resultado é em hexadecimal (não base64). Componentes fora de ordem ou largura incorreta do hash são as causas mais comuns de erros 401. Cabeçalhos: KEY, Timestamp (segundos Unix), SIGN (hex).
03 · Subcontas
Apenas da conta principal para subcontas; chaves de API separadas recomendadas
As transferências de ativos só podem fluir da conta principal para as subcontas (sem transferências entre subcontas). O nível VIP e os créditos de volume de negociação são acumulados na conta principal. Emita chaves de API separadas por subconta para isolar estratégias e riscos, garantindo que uma chave comprometida ou uma estratégia fora de controle fique limitada a essa subconta específica, em vez de afetar toda a sua carteira.
04 · WebSocket
Canais privados exigem payloads de inscrição assinados
Canais privados exigem payloads de inscrição assinados (channel, event: "subscribe", auth). Spot, futuros de USDT, futuros de BTC, opções e entrega (delivery) têm, cada um, seu próprio socket; não faça multiplexação. Uma estratégia que abre um único socket esperando receber dados de todos os quatro tipos de mercado sofrerá com lacunas silenciosas de dados.
05 · Futures TestNet
Demonstração em fx-api-testnet, chaves separadas
A negociação de demonstração roda em fx-api-testnet.gateio.ws com chaves de API separadas (chaves de produção retornam erro 401 lá). O mercado spot não possui um sandbox público, portanto, simulações (dry-runs) no spot devem usar o dry_run do Freqtrade ou gravações do CCXT em vez de um sandbox da exchange. Mantenha as credenciais da TestNet e de produção em entradas separadas de Secrets do TradingHost; nunca reutilize a mesma credencial entre ambientes.
06 · Restrições geográficas
EUA e China continental bloqueados
Cidadãos dos EUA e residentes da China continental não podem negociar na Gate.io. Outras regiões restritas incluem Canadá, Singapura, Reino Unido, Malta e diversas jurisdições sob sanção. As estratégias não devem ser operadas em benefício de residentes dessas regiões. Confirme a entidade licenciada da sua conta antes de realizar o deploy.
07 · Erros comuns
INVALID_SIGNATURE, INVALID_PARAM_VALUE, apenas stop-loss limit
INVALID_SIGNATURE (ordenação da string de assinatura ou hash do corpo); INVALID_PARAM_VALUE em endpoints de saque (campo chain obrigatório); ordens stop-loss a mercado não são suportadas (use limit); taxas pagas com POINT quebram a inferência automática de taxas; chaves de API sem whitelist de IP expiram em 90 dias. Registre a string bruta antes do hash (pre-hash) em builds de não-produção para diagnosticar falhas de assinatura rapidamente.
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a Gate.io são ideais para:
- Traders de altcoins de cauda longa executando estratégias de momentum cross-section ou reversão à média em um vasto universo de ativos
- Traders de arbitragem de perpétuos e basis trading operando pontas de perpétuos com margem em USDT ou BTC
- Lançadores de opções e estratégias de dispersão negociando vencimentos de curto prazo e padrão de BTC/ETH
- Operadores de copy-trading gerenciando o fluxo de seguidores contra uma subconta master
- Desenvolvedores que utilizam IDEs de IA para criar estratégias no Cursor ou Claude Code usando CCXT `gate`, Freqtrade ou a API v4 nativa
Conectar o GitHub e criar sua primeira estratégia é grátis.
Seção 08 · Perguntas frequentes
Perguntas frequentes
Não. O TradingHost é independente e não possui afiliação com a Gate.io.
Não. O código da sua estratégia se conecta à Gate.io e envia instruções de acordo com a sua própria lógica, permissões de conta e método de integração. O TradingHost fornece o ambiente de execução (runtime) onde esse código roda.
Não. O acesso à API da Gate.io é fornecido pela própria Gate.io. Você é responsável por sua conta na Gate.io, permissões de API, credenciais e conformidade com os termos da Gate.io.
Não. O TradingHost é o ambiente de execução em nuvem onde o código da sua estratégia roda. Nós não fornecemos sinais, modelos de previsão de IA ou estratégias prontas. Com o TradingHost, você mesmo escreve ou gera a estratégia (geralmente com o Cursor ou Claude Code), mantém o código no GitHub e usa o TradingHost para executá-lo em produção. Produtos como 3Commas, Cryptohopper e similares são proprietários da lógica da estratégia; o TradingHost apenas executa a sua estratégia.
A AWS e a DigitalOcean fornecem computação bruta. Você mesmo precisa lidar com atualizações de sistema operacional, orquestração de containers, envio de logs, rotação de segredos, failover de região e monitoramento de uptime. O TradingHost oferece um ambiente de execução gerenciado e construído especificamente para estratégias de trading: deploy nativo via GitHub, controle baseado em MCP a partir de IDEs de IA, além de interfaces prontas para logs e monitoramento de integridade. Se você prefere operar a infraestrutura por conta própria, a AWS atende bem. Se deseja o ambiente de execução como um serviço gerenciado, o TradingHost é o caminho mais curto.
Sim. O TradingHost executa estratégias em Python; escolha o ambiente de execução de framework que corresponda à sua stack ou faça o deploy do seu próprio repositório.
Sim. O TradingHost suporta qualquer linguagem que possa ser executada dentro de um container.
Use `gate`. Essa é a classe ativa. O ID `gateio` ainda funciona e herda de `gate`, mas novos códigos devem usar `gate`. Inicialize com ccxt.gate({"apiKey": ..., "secret": ..., "options": {"defaultType": "swap"}}) para perpétuos com margem em USDT, "spot" para spot, "future" para entrega (delivery) e "option" para opções. Consulte a página do ambiente de execução do framework CCXT para ver o guia completo de configuração.
Sim, se o seu projeto for projetado dessa forma. Você pode executar múltiplos processos ou serviços de estratégia dentro de um único ambiente de execução, ou separá-los em diferentes ambientes para obter isolamento e clareza operacional. Consulte a página de ambientes de execução do TradingHost para entender o modelo de múltiplas estratégias.
O caminho mais rápido é fazer um fork de um ambiente de execução de framework do TradingHost: CCXT, Freqtrade ou Hummingbot para obter um projeto pronto para deploy. 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 ambiente de execução estão listados na página de preços.
No seu fluxo de trabalho de segredos controlado pelo GitHub. O TradingHost lê as chaves em tempo de execução por meio de segredos do repositório do GitHub, segredos de ambiente ou do seu próprio processo aprovado de gerenciamento de segredos. O TradingHost não precisa da custódia da sua chave de API e do seu segredo. Consulte a seção de segredos da plataforma para ver o modelo completo de tratamento.
Não. As estratégias nunca devem precisar de permissões de saque. Use permissões v4 com escopo limitado (Spot Trade, Perpetual Futures, etc.) e vincule a chave ao IP de saída do seu ambiente de execução usando a whitelist de IP da Gate.io. Chaves sem whitelist de IP expiram em 90 dias.
Sim, esse é o padrão recomendado na Gate. Crie subcontas sob a conta principal, emita uma chave de API v4 dedicada por subconta (com as permissões mínimas que a estratégia exige) e deixe o TradingHost injetar a chave como um segredo. O volume da subconta e o nível VIP ainda são consolidados na conta principal, mas o raio de impacto de uma chave comprometida ou de uma estratégia fora de controle fica limitado a essa subconta. Os ativos só podem ser transferidos da conta principal para as subcontas, nunca entre subcontas.
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, analisar logs, reiniciar estratégias e gerenciar fluxos de trabalho do ambiente de execução. O MCP é uma interface de controle e observabilidade, não o caminho de execução das operações de trading. Consulte a página da interface de controle MCP para obter detalhes completos.
Ambos. A interface de controle do 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 implantação nativo do GitHub também funciona sem qualquer ferramenta de IA: um simples git push para a sua branch principal dispara uma nova implantação.
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 em execução no mesmo container. O código da sua estratégia continua sendo responsável pelo tratamento seguro de erros, proteção contra ordens duplicadas e controles de risco. Consulte a seção de observabilidade para acessar os logs e a interface de integridade.
A Gate v4 assina com HMAC-SHA512 (não SHA256) e a string de assinatura é concatenada com \n literal: Method + "\n" + URL_Path + "\n" + QueryString + "\n" + HexEncode(SHA512(Body)) + "\n" + Timestamp. O retorno é em hex, não base64. Os três cabeçalhos obrigatórios são KEY, Timestamp e SIGN; não há passphrase (isso é na OKX). O hash do corpo deve ser o SHA512 em hex do corpo bruto da requisição, sendo que um corpo vazio resulta no hash SHA512 de uma string vazia. Consulte a seção de notas operacionais acima para obter o guia completo.
Sim, apenas para futuros. A Futures TestNet roda em https://fx-api-testnet.gateio.ws/api/v4 (REST) e wss://fx-ws-testnet.gateio.ws/v4/ws/{usdt,btc} (WebSocket). Você precisa gerar chaves de API específicas para a TestNet; as chaves de produção não autenticam no ambiente de teste. O mercado à vista (spot) não possui um sandbox público; teste suas estratégias de spot com o dry_run do Freqtrade ou com o CCXT no modo record-and-replay antes de ir para a produção.
Não. A Gate.io bloqueia cidadãos e residentes dos EUA. A TradingHost não pode rotear ordens para a Gate.io a partir de uma conta nos EUA; a restrição ocorre diretamente na exchange. Você também não pode usar a Gate a partir da China continental; a Gate deixou esse mercado após a proibição do Banco Popular da China em 24 de setembro de 2021. Outras jurisdições restritas incluem Canadá, Singapura e Reino Unido.
O TradingHost opera nas regiões EU e US-East. Escolha a região mais próxima do mecanismo de correspondência do qual sua estratégia depende. Consulte a página de regiões para obter detalhes de roteamento e proximidade.
Não. A TradingHost é focada em runtime de produção e implantação. O backtesting deve ser feito em sua própria infraestrutura de pesquisa, framework ou no AlgoBuilder.