Runtime nativo de IA para estratégias de trading na KuCoin
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 MCP de primeira classe, logs e seleção de região.
Seção 01 · Visão rápida
Visão rápida
- Plataforma
- KuCoin
- Tipo de plataforma
- Exchange de criptomoedas (spot, margem, futuros, opções)
- Classe de ativos
- Cripto
- Produtos suportados
- Spot, margem cruzada/isolada (até 10x), contratos perpétuos com margem em USDT/USDC e margem em moedas (inversos) em futures.kucoin.com, opções de estilo europeu de BTC/ETH (liquidadas em USDT, apenas para compradores, apenas no app).
- Modelo de runtime
- Runtime de estratégia em container
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem executada em container
- Integrações comuns
- REST + WebSocket nativos da KuCoin, CCXT (kucoin, kucoinfutures), Freqtrade (spot confirmado pela comunidade), Hummingbot (kucoin, kucoin_perpetual), personalizado
- Integração com fluxo de IA
- Superfície de controle MCP
- Papel da TradingHost
- Runtime, deploy, logs, verificações de integridade, seleção de região, controle MCP
- Papel de KuCoin
- Conta na exchange, acesso à API, acesso ao mercado, ambiente de execução
- Afiliação
- O TradingHost é independente e não possui afiliação com a KuCoin. A KuCoin está permanentemente proibida para pessoas dos EUA conforme ordem de consentimento da CFTC (março de 2026) após o acordo de confissão de US$ 297 milhões da Peken Global com o DOJ em janeiro de 2025.
Seção 02 · O que KuCoin oferece
O que KuCoin oferece
A KuCoin oferece spot, margem cruzada e isolada (até 10x), perpétuos com margem em USDT/USDC e margem em moedas (inversos) em futures.kucoin.com, além de opções de estilo europeu de BTC/ETH via APIs REST e WebSocket. As estratégias se autenticam com uma credencial de 3 partes (chave, segredo e frase secreta) assinada com HMAC-SHA256. Spot e futuros são pilhas de API separadas com chaves distintas. Os detalhes dos endpoints mudam com o tempo. A estrutura geral é durável; os pesos exatos de limites de taxa, níveis de taxas e listas de símbolos estão disponíveis na documentação da KuCoin.
Mercados e padrões de estratégia
- Market making no mercado spot em pares de altcoins com alta liquidez
- Contratos perpétuos com margem em USDT em futures.kucoin.com
- Contratos perpétuos com margem em moedas (inversos) em futures.kucoin.com
- Trading com margem cruzada e isolada de até 10x
- Hierarquia de sub-accounts para isolamento de estratégias
- Cópia de estratégias através do programa de lead trader da KuCoin
- Trading de demonstração via sandbox (apenas spot)
- Estratégias de faixas de desconto de taxas por staking de KCS
Superfície da API
- Superfícies de produtos
- Spot em api.kucoin.com, futuros em api-futures.kucoin.com, sandbox em openapi-sandbox.kucoin.com (apenas spot).
- Métodos de conexão
- REST mais WebSocket. O WebSocket exige um padrão de duas etapas: POST para /api/v1/bullet-public ou /api/v1/bullet-private para buscar um token e o endpoint wss:// real a partir de instanceServers. A lógica de reconexão deve buscar o token novamente (ele expira). Respeite o pingInterval (~18000ms) e o pingTimeout (~10000ms) retornados.
- Autenticação
- Credencial de 3 partes (chave de API + segredo de API + frase secreta), assinatura HMAC-SHA256. Cabeçalhos obrigatórios: KC-API-KEY, KC-API-SIGN (base64 do HMAC-SHA256 sobre timestamp + método + endpoint + corpo), KC-API-TIMESTAMP (ms desde a época), KC-API-PASSPHRASE (para chaves v2, este é o base64 do HMAC-SHA256 da frase secreta bruta, não o valor bruto), KC-API-KEY-VERSION ("2" para chaves v2 atuais). Spot e futuros usam chaves de API separadas criadas em painéis distintos.
Para detalhes específicos, consulte KuCoin
Endpoints específicos, pesos de limites de taxa, listas de símbolos, faixas de taxas e histórico de versões estão disponíveis na documentação da KuCoin. Considere-os como a fonte da verdade.
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para KuCoin 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.
REST + WebSocket nativos da KuCoin
Controle direto sobre o comportamento específico da KuCoin, dados da conta, roteamento de sub-accounts e lógica de execução de ordens.
CCXT
Interface comum entre a KuCoin e outras exchanges de criptomoedas. Spot e futuros são modelados como duas classes de exchange: kucoin e kucoinfutures.
Freqtrade ou Hummingbot
Deploys baseados em frameworks usando suas respectivas estruturas de estratégia e modelos de configuração.
Conector personalizado
Seu próprio motor de trading interno ou integração proprietária com a KuCoin.
Suporte de frameworks para produtos KuCoin
A cobertura varia de acordo com o framework. A API nativa e o CCXT abrangem a maior parte da KuCoin; o Hummingbot cobre spot e futuros perpétuos; o Freqtrade cobre apenas spot (confirmado pela comunidade, campo de frase secreta obrigatório na configuração).
✓ suporte confirmado de acordo com a documentação oficial do framework. "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 KuCoin fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à KuCoin é 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 à KuCoin.
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 as variáveis de ambiente que sua estratégia precisa (as credenciais de 3 partes da KuCoin: chave, segredo e senha, além do requisito KC-API-KEY-VERSION: 2 para chaves v2 atuais) e faça o deploy. A TradingHost compila 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 KuCoin
Problemas práticos que surgem ao executar uma estratégia da KuCoin em um runtime de nuvem em container, que não estão na documentação da KuCoin nem nos READMEs dos frameworks. Cada afirmação abaixo foi citada ou parafraseada da própria documentação da KuCoin (ou do processo da CFTC para a nota sobre acesso nos EUA); as orientações de deploy vêm da experiência de execução dessas estratégias no TradingHost.
01 · Credencial de 3 partes
Chave, segredo e frase secreta, além do cabeçalho de versão
Tanto spot quanto futuros exigem chave + segredo + frase secreta. Para chaves v2, o cabeçalho da frase secreta deve ser o base64 do HMAC-SHA256 da frase secreta bruta, não o valor bruto. O cabeçalho KC-API-KEY-VERSION deve ser definido como "2" para chaves atuais; omiti-lo em uma chave v2 gera um erro de assinatura.
02 · Erros comuns
400003 e 400004 são falhas de frase secreta
A ausência ou formatação incorreta da frase secreta gera o erro 400003 KC-API-KEY not exists ou 400004 KC-API-PASSPHRASE error. O CCXT tem um histórico documentado de divergências em KC-API-KEY-VERSION que reproduzem esses erros.
03 · Pilhas separadas
Spot e futuros são APIs diferentes com chaves distintas
Chaves de spot não se autenticam em api-futures.kucoin.com. Estratégias que operam em ambas as frentes precisam de dois pares de chaves e dois clientes configurados. O CCXT modela isso como duas classes de exchange separadas (kucoin e kucoinfutures).
04 · WebSocket
Handshake de bullet-token, não uma URL estática
A KuCoin não expõe uma URL wss:// estática. Faça um POST para /api/v1/bullet-public (feeds públicos) ou /api/v1/bullet-private (feeds de conta/ordens) para receber um token de uso único e o endpoint wss:// real a partir de instanceServers. Os tokens expiram, portanto a lógica de reconexão deve buscar um novo token. Respeite os valores retornados de pingInterval (~18s) e pingTimeout (~10s).
05 · Sandbox
Apenas Spot, estado totalmente separado
O openapi-sandbox.kucoin.com cobre endpoints de spot e usa um login, conjunto de chaves de API e saldo fictício totalmente separados. Futuros, margem e opções não estão representados no sandbox, portanto estratégias que acessam api-futures.kucoin.com precisam testar em dry-run de outra forma (camada de execução simulada, tamanho real muito pequeno ou dry-run nativo do framework).
06 · Limites de taxa
Pools de recursos ponderados por nível VIP
Os pools de recursos ponderados por nível VIP são redefinidos em uma janela deslizante de 30 segundos. Retorna HTTP 429 com código de corpo 429000 em caso de esgotamento. Cada resposta carrega cabeçalhos com a cota do pool, cota restante e contagem regressiva para redefinição. Vários endpoints v1 (DELETE /api/v1/orders, GET /api/v1/hf/orders/active) foram descontinuados em favor das versões v2/v3 com limites mais altos.
07 · Disponibilidade nos EUA
Banimento permanente conforme termo de consentimento da CFTC de março de 2026
De acordo com o termo de consentimento do SDNY de 30 de março de 2026 contra a Peken Global Limited (operadora da KuCoin), a KuCoin está permanentemente proibida de aceitar clientes dos EUA, a menos que a Peken Global se registre como um Foreign Board of Trade junto à CFTC. O banimento se aplica à conta da KuCoin, não ao local onde o código da estratégia é executado; as regiões de runtime e a conectividade da TradingHost não alteram essa restrição.
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a KuCoin são ideais para:
- Desenvolvedores de algoritmos executando estratégias de spot na ampla lista de pares de altcoins da KuCoin
- Traders de perpétuos executando contratos com margem em USDT ou perpétuos inversos no futures.kucoin.com
- Equipes quantitativas usando sub-accounts para isolar estratégias ou gerenciar pods de capital
- Usuários de CCXT, Freqtrade e Hummingbot
- Desenvolvedores de IA / Cursor / Claude gerenciando deploys via MCP e GitHub
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 é afiliada à KuCoin.
Não. O código da sua estratégia se conecta à KuCoin 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 KuCoin é fornecido pela própria KuCoin. Você é responsável por sua conta KuCoin, permissões de API, credenciais e conformidade com os termos da KuCoin.
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 com o Cursor ou Claude Code), mantém o código no GitHub e usa a TradingHost para executá-lo em produção. Produtos como 3Commas, Cryptohopper e similares são donos da lógica da estratégia; a 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. A TradingHost oferece um runtime gerenciado e desenvolvido especificamente para estratégias de trading: deploy nativo via GitHub, controle via MCP a partir de IDEs de IA, além de interfaces de logs e status de saúde prontas para uso. Se você quer gerenciar a infraestrutura por conta própria, a AWS atende. Se prefere o runtime como um serviço gerenciado, a TradingHost é o caminho mais curto.
Sim. A TradingHost executa estratégias em Python; escolha o runtime de framework que corresponda à sua stack ou faça o deploy do seu próprio repositório.
Sim. A TradingHost suporta qualquer linguagem que possa ser executada dentro de um container.
Os ambientes de spot e futuros da KuCoin possuem APIs separadas (api.kucoin.com versus api-futures.kucoin.com) com chaves de API distintas. No CCXT, isso corresponde a duas classes de exchange: kucoin para spot e margem, e kucoinfutures para futures.kucoin.com. Instancie ambas com suas respectivas credenciais (key + secret + passphrase), direcione as ordens para o cliente correto de acordo com o símbolo e armazene os dois conjuntos de credenciais como segredos separados na TradingHost.
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 runtime, ou separá-los em diferentes runtimes para obter isolamento e clareza operacional. Consulte a página de runtime da TradingHost para conhecer o modelo multiestratégia.
O caminho mais rápido é fazer um fork de um runtime de framework da TradingHost: CCXT, Freqtrade ou Hummingbot para ter 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 runtime estão listados na página de preços.
No seu fluxo de trabalho de segredos controlado pelo GitHub. A 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 homologado de gerenciamento de segredos. A TradingHost não precisa da custódia de sua chave de API, segredo ou senha. 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. Use permissões com escopo limitado (leitura, negociação) e IP whitelisting quando apropriado.
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 deploys, revisar logs, reiniciar estratégias e gerar fluxos de trabalho de runtime. O MCP é uma interface de controle e observabilidade, não o caminho de execução das operações. Consulte a interface de controle MCP para obter detalhes completos.
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 git push comum para a sua branch principal dispara um novo deploy.
O runtime detecta a falha e expõe os logs e informações de saúde 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 conhecer a interface de logs e status de saúde.
Quase sempre é uma de três coisas. (1) O cabeçalho da senha para uma chave v2 deve ser o base64 do HMAC-SHA256 da senha bruta, e não a senha bruta em si. (2) O cabeçalho KC-API-KEY-VERSION deve ser definido como "2" para chaves v2. (3) O payload da assinatura é timestamp + UPPERCASE_METHOD + endpoint_with_query + body, com o body como uma string vazia em requisições GET/DELETE. A ausência de qualquer um desses elementos reproduz a mesma classe de erro.
A KuCoin não expõe uma URL wss:// estática. Antes de conectar, faça uma requisição POST para /api/v1/bullet-public (feeds públicos) ou /api/v1/bullet-private (feeds de conta/ordens). A resposta fornece um token de uso único, além de instanceServers[0].endpoint, o pingInterval e o pingTimeout. Conecte-se a esse endpoint usando ?token=...&connectId=... e, em seguida, envie pings no intervalo retornado. Como os tokens expiram, a lógica de reconexão precisa buscar um novo token.
Não. Após uma ordem de consentimento da CFTC emitida em 30 de março de 2026 contra a Peken Global Limited (operadora da KuCoin), a KuCoin está permanentemente impedida de aceitar pessoas dos EUA, a menos que se registre como uma Foreign Board of Trade. Essa restrição se aplica à conta da KuCoin, e não ao local onde o código da estratégia está hospedado, portanto, fazer o deploy na TradingHost não altera essa elegibilidade.
Apenas Spot. O openapi-sandbox.kucoin.com cobre endpoints de spot e utiliza um login, conjunto de chaves de API e saldo fictício totalmente separados. Contratos futuros, margem e opções não estão representados no sandbox, portanto, qualquer estratégia que acesse o api-futures.kucoin.com precisa ser testada em paper trading de outra forma (camada de execução simulada, tamanho real muito pequeno ou dry-run nativo do framework) antes de aumentar a escala.
A TradingHost opera nas regiões EU e US-East. Escolha a região mais próxima do mecanismo de correspondência de ordens do qual sua estratégia depende. Consulte a página de regiões para obter detalhes sobre roteamento e proximidade.
Não. O foco da TradingHost é o runtime de produção e o deploy. O backtest deve ser feito em sua stack de pesquisa, framework ou AlgoBuilder.