Runtime nativo para IA para estratégias de trading na WhiteBIT
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
- WhiteBIT
- Tipo de plataforma
- Exchange de cripto (global)
- Classe de ativos
- Cripto
- Produtos suportados
- Spot, futuros perpétuos, margem isolada. Limites de taxa em camadas por endpoint; sem testnet pública (testes de integração ocorrem na API real com tamanhos mínimos de ordem).
- Modelo de runtime
- Runtime de estratégia em container
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem compatível com containers
- Integrações comuns
- APIs nativas REST e WebSocket da WhiteBIT, CCXT, conectores personalizados
- 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, controle MCP
- Papel de WhiteBIT
- 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 WhiteBIT
Seção 02 · O que WhiteBIT oferece
O que WhiteBIT oferece
A WhiteBIT oferece spot, futuros perpétuos e margem isolada via APIs REST e WebSocket com limites de taxa em camadas por endpoint. Uma realidade operacional importante: não há testnet pública, portanto os testes de integração ocorrem diretamente na API de produção com tamanhos mínimos de ordem. Copy trading, auto-invest e staking estão disponíveis apenas na plataforma e não possuem acesso via API. As especificações dos endpoints mudam com o tempo. A estrutura geral é estável; os limites de taxa exatos, listas de símbolos e faixas de taxas estão disponíveis na documentação da WhiteBIT.
Mercados e padrões de estratégia
- Trading spot em pares cotados em USDT, BTC e ETH
- Estratégias de futuros perpétuos
- Estratégias de margem isolada
- Inscrição via WebSocket de até 200 mensagens por minuto por conexão
- Gerenciamento de limites de taxa em camadas por endpoint
- Testes de integração na API de produção (sem testnet pública disponível)
- Fluxo de transferência de saldo entre as contas Trade Balance e Main Balance
- Estratégias baseadas em API que evitam recursos exclusivos da plataforma (copy trading, auto-invest)
Superfície da API
- Superfícies de produtos
- Spot, futuros perpétuos e margem isolada. Recursos como copy trading, auto-invest e staking existem na WhiteBIT, mas são exclusivos da plataforma (sem acesso via API). Estratégias que dependem dessas funcionalidades exigem uma etapa de intervenção humana.
- Métodos de conexão
- API REST para envio de ordens e consultas de conta com limites de taxa em camadas por endpoint: Main Balance de 1.000 requisições por 10 segundos, Trade Balance de 12.000 por 10 segundos, criação de ordens de 10.000 por 10 segundos e mercados públicos de 2.000 por 10 segundos. O WebSocket permite até 1.000 conexões simultâneas por minuto com 200 mensagens por minuto por conexão individual.
- Autenticação
- Chave de API e segredo por estratégia com requisições assinadas por HMAC. As permissões podem ser limitadas por chave. As inscrições de WebSocket em canais privados exigem um fluxo de atualização de token (token-refresh) que deve ser gerenciado pelo cliente.
Para detalhes específicos, consulte WhiteBIT
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 WhiteBIT. Utilize-os como a fonte oficial de informações.
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para WhiteBIT 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 WhiteBIT
Controle direto sobre comportamentos específicos da WhiteBIT, fluxos de transferência de saldo e limites de taxa em camadas.
CCXT
Interface comum entre a WhiteBIT e outras exchanges de cripto. A CCXT expõe a WhiteBIT por meio da classe unificada `whitebit` para trading spot.
Freqtrade ou Hummingbot
Nenhum dos frameworks lista a WhiteBIT como uma exchange com suporte nativo de primeira classe atualmente. Implementações personalizadas ou baseadas em CCXT são o caminho documentado.
Conector personalizado
Seu próprio motor de trading interno ou integração proprietária com a WhiteBIT usando as APIs REST e WebSocket.
Suporte de frameworks para produtos WhiteBIT
A cobertura varia de acordo com o framework. A CCXT expõe o mercado spot da WhiteBIT por meio de sua classe unificada `whitebit`; a cobertura de futuros e margem na CCXT é parcial. Nem o Freqtrade nem o Hummingbot listam a WhiteBIT como uma exchange com suporte de primeira classe atualmente. O acesso direto via API nativa alcança todos os recursos publicados pela WhiteBIT, incluindo futuros e margem isolada.
✓ suporte confirmado de acordo com os documentos oficiais do framework. "não" indica que não está documentado oficialmente como suportado. "parcial" indica cobertura limitada. Os links de fluxo de trabalho apontam 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 WhiteBIT fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à WhiteBIT é 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 à WhiteBIT.
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) para obter uma base funcional integrada às APIs REST e WebSocket da WhiteBIT.
- PASSO 03
Implante em um contêiner da TradingHost
Escolha uma região (EU ou US-East), informe as variáveis de ambiente necessárias para a sua estratégia (chave de API e segredo da WhiteBIT, configurações de transferência de saldo) e faça o deploy. A TradingHost constrói o container a partir do repositório e executa sua estratégia em 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 WhiteBIT
Problemas práticos que surgem ao executar uma estratégia da WhiteBIT em um runtime de nuvem em container — detalhes que não estão na documentação da WhiteBIT nem nos arquivos README dos frameworks. Cada ponto abaixo foi adaptado da própria documentação da WhiteBIT; as orientações de implantação baseiam-se na execução dessas estratégias no TradingHost.
01 · Sem testnet
A WhiteBIT não possui testnet pública; os testes de integração ocorrem na API real
A WhiteBIT não disponibiliza uma testnet pública. Todos os testes de integração ocorrem diretamente na API de produção real, com ativos reais e tamanhos mínimos de ordem. Essa é uma lacuna operacional significativa em comparação com a Binance, Coinbase ou Bybit, que oferecem ambientes de sandbox para validação segura antes do deploy. O padrão correto é reservar uma conta separada com saldo reduzido ou uma subconta para testes iniciais de deploy, utilizar o menor tamanho de ordem permitido e publicar o código com as proteções padrão (chaves de idempotência, verificações de posição máxima, kill switch) desde o primeiro dia, em vez de esperar pelo primeiro incidente.
02 · Limites de taxa em camadas
Limites de taxa por endpoint: Main Balance 1k/10s, Trade Balance 12k/10s, criação de ordens 10k/10s, público 2k/10s
A WhiteBIT aplica limites de taxa por endpoint em vez de um orçamento global único. Endpoints de Main Balance: 1.000 requisições por 10 segundos. Endpoints de Trade Balance: 12.000 por 10 segundos. Endpoint de criação de ordens: 10.000 por 10 segundos. Endpoints de mercado público: 2.000 por 10 segundos. Uma estratégia que sobrecarrega uma família de endpoints não esgota o orçamento de outra, mas esgota seu próprio limite rapidamente. Codifique o orçamento de cada classe de endpoint no wrapper do seu cliente em vez de rastrear um único contador global.
03 · Limites de WebSocket
1.000 conexões simultâneas por minuto; 200 mensagens por minuto por conexão única
A camada de WebSocket da WhiteBIT limita a taxa de transferência geral a 1.000 tentativas de conexões simultâneas por minuto e 200 mensagens por minuto por conexão aberta individual. Uma estratégia que assina muitos canais privados em uma única conexão pode atingir o limite por conexão antes mesmo que o livro de ofertas esteja totalmente assinado. O padrão correto para implantações multiestratégia é uma conexão WebSocket por estratégia com seu próprio orçamento de mensagens, em vez de uma conexão compartilhada roteada para vários consumidores. A atualização de token em canais privados é de responsabilidade do cliente; se você perder o token, a assinatura cairá silenciosamente.
04 · Códigos de transferência de saldo
Erro 1 = disabled from-trade, 2 = disabled from-main, 3 = insufficient
A WhiteBIT divide os saldos entre as contas Main Balance e Trade Balance. Estratégias que enviam ordens contra o saldo de Trade Balance, mas leem o saldo de Main Balance para financiamento, precisam chamar o endpoint de transferência de saldo. O endpoint de transferência retorna três códigos de erro específicos que vale a pena conhecer de cor: o error 1 significa que as transferências a partir de Trade estão desativadas (geralmente por uma configuração de nível de conta), o error 2 significa que as transferências a partir de Main estão desativadas e o error 3 significa saldo insuficiente. Nenhum dos três é recuperável por nova tentativa; eles exigem uma correção no nível da conta ou uma decisão de estratégia diferente.
05 · Recursos exclusivos da plataforma
Copy trading, auto-invest e staking não têm acesso via API
A WhiteBIT oferece copy trading, agendamentos de auto-invest e staking, mas todos os três são recursos exclusivos da plataforma, sem acesso via API. Estratégias que se integram à WhiteBIT não podem assinar programaticamente um líder de copy-trade, configurar um agendamento de auto-invest ou realizar staking de saldos. O padrão correto é tratar esses fluxos como processos manuais externos que humanos configuram na interface da WhiteBIT, fazendo com que o código da estratégia leia o saldo resultante e o estado das ordens por meio da API.
06 · Tamanho mínimo de ordem
Tamanhos mínimos por par se aplicam na integração em produção; consulte antes de testar
Como não há testnet, as primeiras ordens que uma estratégia envia envolvem dinheiro real contra liquidez real. Aplicam-se tamanhos mínimos de ordem por par, e implantar uma estratégia que envia ordens abaixo do mínimo fará com que todas as requisições sejam rejeitadas. Consulte o endpoint de tamanho mínimo na inicialização, armazene em cache os valores por símbolo e valide cada ordem de saída em relação ao mínimo armazenado em cache antes do envio. Atualize o cache periodicamente, pois a WhiteBIT altera os mínimos de acordo com as condições do mercado.
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a WhiteBIT são ideais para:
- Desenvolvedores criando estratégias em IDEs de IA (Cursor, Claude Code)
- Traders sistemáticos de cripto
- Desenvolvedores quantitativos
- Usuários do CCXT
- Equipes migrando de hospedagem VPS para implantação em contêineres
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 à WhiteBIT.
Não. O código da sua estratégia se conecta à WhiteBIT 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 WhiteBIT é fornecido pela própria WhiteBIT. Você é responsável por sua conta da WhiteBIT, permissões de API, credenciais e conformidade com os termos da WhiteBIT.
Não. A TradingHost é o runtime em nuvem onde o código da sua estratégia é executado. Não fornecemos sinais, modelos de previsão de IA ou bots pré-configurados. Com a TradingHost, você mesmo escreve ou gera a estratégia (geralmente com o Cursor ou o Claude Code), mantém o código no GitHub e usa a TradingHost para executá-lo em produção. O 3Commas, o Cryptohopper e produtos semelhantes são proprietários da lógica da estratégia; a TradingHost apenas executa a sua estratégia.
A AWS e a DigitalOcean oferecem computação bruta. Você mesmo precisa lidar com atualizações de sistema operacional, orquestração de contêineres, envio de logs, rotação de segredos, failover de região e monitoramento de uptime. A TradingHost oferece um runtime gerenciado projetado especificamente para estratégias de trading: implantação nativa do GitHub, controle via MCP a partir de IDEs de IA, além de interfaces de logs e integridade prontas para uso. Se você prefere operar a infraestrutura por conta própria, a AWS atende. Se você quer 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 implante seu próprio repositório.
Sim. A TradingHost suporta qualquer linguagem que possa ser executada dentro de um contêiner.
Sim. O CCXT disponibiliza uma classe unificada `whitebit` que cobre o trading spot. A cobertura de futuros e margem no CCXT é parcial. Coloque sua estratégia CCXT em um contêiner, aponte para o GitHub e a TradingHost a executará como qualquer outro projeto Python ou Node. Consulte o runtime do framework CCXT para ver o processo completo de configuração.
Sim. Os futuros perpétuos estão acessíveis por meio da API da WhiteBIT assim que sua conta estiver qualificada. A TradingHost é neutra em relação à corretora no nível do runtime: qualquer código que consiga se autenticar nos endpoints de futuros pode ser executado dentro de um contêiner. Observe que copy trading, auto-invest e staking são recursos exclusivos da plataforma sem acesso via API; as estratégias não podem assinar programaticamente um líder de copy-trade ou configurar um agendamento de auto-invest.
Sim, se o seu projeto for projetado dessa forma. Você pode executar vários processos ou serviços de estratégia dentro de um único runtime, ou separá-los em runtimes diferentes para fins de isolamento e clareza operacional. Especificamente para a WhiteBIT, prefira uma conexão WebSocket por estratégia para que cada uma tenha seu próprio limite de 200 mensagens por minuto por conexão, em vez de compartilhá-lo. 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 para um projeto pronto para implantação. 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 dos segredos do repositório do GitHub, segredos de ambiente ou do seu próprio processo aprovado de gerenciamento de segredos. A TradingHost não precisa da custódia da sua chave de API e do seu segredo. Consulte os segredos da plataforma para conhecer o modelo completo de tratamento.
Não. As estratégias nunca devem precisar de permissões de saque. Limite o escopo da sua chave de API apenas para operações de trading e leitura do estado da conta, mantendo a opção de saque totalmente desativada na chave.
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, revisar logs, reiniciar estratégias e gerenciar fluxos de trabalho de runtime. O MCP é uma interface de controle e observabilidade, não o caminho de execução de ordens. Consulte a interface de controle do MCP para obter uma visão completa.
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 ciclo de implantação nativo do GitHub também funciona sem qualquer ferramenta de IA: um push comum do git para a sua branch principal aciona uma nova implantação.
O runtime detecta a falha e expõe os logs e as 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 contêiner. O código da sua estratégia ainda é responsável pelo tratamento seguro de erros, proteção contra ordens duplicadas e controles de risco. Consulte a observabilidade para conhecer a interface de logs e integridade.
A WhiteBIT não disponibiliza uma testnet pública. Todos os testes de integração ocorrem diretamente na API de produção real, utilizando ativos reais com tamanhos mínimos de ordem. A abordagem correta é reservar uma conta ou subconta separada com saldo reduzido para os testes de primeira implantação, utilizar o menor tamanho de ordem permitido e implementar o código com proteções padrão (chaves de idempotência, verificações de posição máxima e kill switch) desde o primeiro dia, em vez de esperar pelo primeiro incidente. Consulte a seção de Notas operacionais acima para obter as orientações completas.
A 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 detalhes de roteamento e proximidade.
Não. A TradingHost é focada exclusivamente em runtime de produção e implantação. O backtesting deve ser realizado em seu ambiente de pesquisa, framework ou no AlgoBuilder.