Runtime nativo de IA para estratégias de trading na Bybit
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
- Bybit
- Tipo de plataforma
- Exchange de cripto (focada em derivativos)
- Classe de ativos
- Cripto (spot, perpétuos lineares e inversos, futuros de USDC, opções, spread)
- Produtos suportados
- Spot, perpétuos de USDT, perpétuos de USDC, futuros de USDT, futuros de USDC, perpétuos inversos, futuros inversos, opções de USDC de estilo europeu, Spread Trading, estratégias de cópia, demo trading. Disponível via UTA 2.0 (padrão para contas registradas a partir de 2025); UTA 1.0 ainda em operação para usuários legados. Contas Classic não são mais oferecidas.
- Modelo de runtime
- Runtime de estratégia em container
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem executável em container
- Integrações comuns
- REST e WebSocket nativos da Bybit v5, CCXT, Freqtrade, Hummingbot, personalizado
- 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, health checks, seleção de região, controle MCP
- Papel de Bybit
- Conta na exchange, acesso à API, acesso ao mercado, ambiente de execução
- Afiliação
- A TradingHost é independente e não possui afiliação com a Bybit
Seção 02 · O que Bybit oferece
O que Bybit oferece
A API v5 da Bybit unifica spot, perpétuos lineares e inversos, futuros de USDT e USDC, e opções de USDC de estilo europeu sob um único parâmetro `category`, com Spread Trading e Demo Trading como superfícies adicionais. Sob a UTA 2.0, cada category compartilha um único pool de margem cruzada entre produtos. As estratégias se autenticam com chaves HMAC-SHA256 (emitidas pelo sistema) ou RSA-SHA256 (autoemitidas) e se conectam à exchange via REST ou WebSocket. Mainnet, testnet e mainnet demo são três ambientes distintos com namespaces de chaves separados. Detalhes específicos dos endpoints mudam com o tempo. A estrutura geral é estável; os limites exatos de taxa (rate limits), faixas de taxas (fee tiers) e listas de símbolos estão disponíveis na documentação da Bybit.
Mercados e padrões de estratégia
- Market making de perpétuos de USDT
- Operações de basis e carry com perpétuos de USDC
- Hedge com margem em moeda (coin-margined) em perpétuos inversos
- Gamma scalping de opções (liquidadas em USDC, Portfolio Margin)
- Arbitragem de taxa de financiamento (funding rate) via livro de ofertas de Spread Trading
- Estratégias de cópia via automação de Master Trader
- Estratégias de margem de portfólio cruzada sob UTA 2.0
- Simulações em demo-trading antes do deploy em mainnet
Superfície da API
- Superfícies de produtos
- Categorias unificadas da v5 (`spot`, `linear`, `inverse`, `option`), além de endpoints de Spread Trading e Demo Trading. A UTA 2.0 unifica todas as categorias sob um único pool de margem. Mainnet, testnet (api-testnet.bybit.com) e mainnet demo (api-demo.bybit.com) são três ambientes distintos com namespaces de chaves separados.
- Métodos de conexão
- REST v5 (HTTPS), WebSocket público (dados de mercado), WebSocket privado (ordens, execuções, posições, carteira), WebSocket trade (envio de ordens via WS, apenas em mainnet).
- Autenticação
- HMAC-SHA256 (chaves emitidas pelo sistema) ou RSA-SHA256 (chaves autoemitidas). Headers obrigatórios: `X-BAPI-API-KEY`, `X-BAPI-TIMESTAMP`, `X-BAPI-SIGN`, `X-BAPI-RECV-WINDOW` (padrão de 5000 ms). Suporte a hierarquia de subcontas e liberação de IPs (IP whitelisting) por chave. O acesso à API a partir de IPs dos EUA ou da China Continental retorna HTTP 403.
Para detalhes específicos, consulte Bybit
Endpoints específicos, limites de taxa (rate limits), listas de símbolos, faixas de taxas (fee tiers) e histórico de versões estão disponíveis na documentação da Bybit. Considere-os como a fonte oficial de informações.
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para Bybit 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 IDE de IA. Cursor, Claude Code, GitHub Copilot e agentes de IA baseados em CLI funcionam com o mesmo fluxo de deploy nativo do GitHub. A superfície de produtos baseada em categorias da v5 da Bybit e a margem cruzada entre produtos da UTA 2.0 significam que uma única estratégia pode acessar spot, perpétuos, futuros e opções por meio de uma única conta unificada.
API nativa da Bybit
Controle direto sobre comportamentos específicos da Bybit, dados de conta e lógica de execução de ordens por meio da API unificada v5.
Freqtrade ou Hummingbot
Deploys baseados em frameworks utilizando 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 Bybit.
Suporte de frameworks para produtos Bybit
A cobertura varia de acordo com o framework. O CCXT e a v5 nativa abrangem toda a superfície da Bybit; o Freqtrade cobre spot e perpétuos lineares (recomenda-se uma subconta por bot); o Hummingbot cobre spot e perpétuos com suporte parcial a inversos (um modo por vez).
✓ suporte confirmado de acordo com as documentações oficiais dos frameworks. "parcial" indica suporte documentado, mas limitado (ex: um modo por vez). "não" indica que não há suporte oficialmente documentado.
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 Bybit fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à Bybit é 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 à Bybit.
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 (chaves de API da Bybit, etc.) e faça o deploy. A TradingHost constrói 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 Bybit
Problemas práticos que surgem ao executar uma estratégia da Bybit em um runtime de nuvem em container, que não estão na documentação da Bybit nem nos READMEs de frameworks. Cada ponto abaixo foi citado ou parafraseado da própria documentação da Bybit; as orientações de deploy vêm da experiência de rodar essas estratégias na TradingHost.
01 · Unificação v5
A API v5 unifica categorias; a v3 foi descontinuada em agosto de 2024
A API v5 da Bybit unifica spot, perpétuos lineares, perpétuos inversos e opções sob um único parâmetro `category`. A transição oficial da v3 para a v5 descontinuou os endpoints da v3 em 31 de agosto de 2024. Execute todo código novo na v5; a v3 retornará erros.
02 · Ambientes
Mainnet, testnet e mainnet demo são três hosts diferentes
A Mainnet usa api.bybit.com e stream.bybit.com. A Testnet usa api-testnet.bybit.com e stream-testnet.bybit.com. A demo da mainnet usa api-demo.bybit.com e wss://stream-demo.bybit.com para streams privados (os dados públicos de mercado ainda vêm da mainnet). As chaves não são compartilhadas entre ambientes; uma chave de demo usada no host da testnet retorna o erro 10003. O WS Trade (entrada de ordens via WebSocket) não está disponível na demo.
03 · Modo de conta
UTA 2.0 vs UTA 1.0 vs Classic legado
Três modos de conta já existiram: Classic (não oferecido mais), UTA 1.0 (spot unificado e derivativos e opções de USDT/USDC; inverse ainda separado) e UTA 2.0 (todas as categorias compartilhando uma única carteira de margem com margem cruzada ou de portfólio). Contas registradas em 2025 ou depois são UTA 2.0 por padrão. A atualização para a UTA é irreversível; na UTA 2.0, os futuros inverse não oferecem mais suporte ao modo hedge.
04 · Limites de taxa
Janela deslizante por UID e por categoria
Os limites da v5 são por janela deslizante por UID e divididos por categoria. A criação de ordens é de 20/s para spot e linear, 10/s para inverse e option; a alteração é de 10/s em todas as quatro; o cancelamento espelha a criação. O limite no nível de IP é de 600 requisições HTTP por janela de 5 segundos. Os endpoints em lote (batch) consomem por ordem, não por requisição, com limites de 10 (spot) e 20 (linear / inverse / option) por lote. Os cabeçalhos de resposta expõem o limite restante.
FonteBybit v5 rate limits05 · Histórico de segurança
Incidente do Lazarus Group em fevereiro de 2025, o que mudou
Em 21 de fevereiro de 2025, invasores ligados ao Lazarus Group (TraderTraitor) da Coreia do Norte roubaram cerca de US$ 1,5 bilhão em ETH de uma cold wallet da Bybit ao comprometer a estação de trabalho de um desenvolvedor no provedor terceirizado de multisig Safe{Wallet} e adulterar a interface do assinante. O FBI confirmou a autoria no IC3 PSA-250226. A Bybit continuou operacional: os saques prosseguiram, a auditoria de Proof of Reserves da Hacken confirmou reservas acima de 100% em BTC, ETH, SOL, USDT e USDC, e a Bybit declarou publicamente que os fundos dos usuários não foram afetados. Posteriormente, a Bybit isolou a infraestrutura de assinatura, redesenhou os fluxos de multisig, auditou ferramentas de terceiros, adicionou detecção de anomalias em transferências e continua a realizar a Merkle-tree PoR mensal com a Hacken. Para usuários de API, este é um contexto histórico: a postura mudou, mas a superfície da API permaneceu a mesma.
06 · Restrições de região
EUA e China continental bloqueados na borda da API
O guia da v5 afirma explicitamente que endereços IP localizados nos EUA ou na China continental retornam um erro 403 Forbidden. Existem hostnames regionais para Holanda, Turquia, Cazaquistão, Geórgia, Emirados Árabes Unidos, EEE e Indonésia. O KYC é obrigatório e identidades de residentes nos EUA são bloqueadas na verificação, mesmo que o IP passe. A seleção de região de runtime da TradingHost deve evitar regiões nos EUA ao operar na Bybit.
07 · Erros comuns
Códigos de autenticação e limite de taxa para monitorar
O erro 10003 invalid api_key geralmente significa ambiente incorreto (chave da mainnet acessando o host da testnet ou chave de demo acessando a mainnet). O erro 10004 invalid sign indica dessincronização do relógio além do `recv_window` ou que o payload da assinatura foi montado na ordem errada. O erro 10018 exceed IP rate limit sinaliza o limite de 600 req / 5 s; reduza o ritmo usando `X-Bapi-Limit-Reset-Timestamp`. Trate 10003 e 10004 como alertas para interromper a execução, e não para tentar novamente.
FonteBybit v5 error codes08 · Spread Trading
O Spread Trading possui um livro de ordens separado
O Spread Trading oferece suporte a combinações de Spot/Perp, Spot/Expiry, Perp/Expiry e Expiry/Expiry em BTC, ETH e SOL com seu próprio livro de ordens e taxas 50% menores em comparação com a execução manual de cada ponta. Ele é listado como uma funcionalidade nos documentos da v5, em vez de uma `category` documentada; direcione as requisições usando as referências de endpoint da central de ajuda ao configurar.
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a Bybit são ideais para:
- Desenvolvedores criando estratégias em IDEs de IA (Cursor, Claude Code)
- Traders sistemáticos de cripto
- Desenvolvedores quantitativos
- Usuários de CCXT, Freqtrade e Hummingbot
- 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 possui afiliação com a Bybit.
Não. O código da sua estratégia se conecta à Bybit 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 ambiente de execução (runtime) onde esse código é executado.
Não. O acesso à API da Bybit é fornecido pela própria Bybit. Você é responsável por sua conta na Bybit, permissões de API, credenciais e conformidade com os termos da Bybit.
Não. A TradingHost é o ambiente de execução em nuvem onde o código da sua estratégia roda. 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 GitHub e usa a TradingHost para executá-lo em produção. Produtos como o 3Commas, Cryptohopper e similares são proprietários da lógica da estratégia; a TradingHost apenas executa a sua estratégia.
A AWS e a DigitalOcean fornecem computação bruta. Você precisa gerenciar 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 por conta própria. A TradingHost oferece um ambiente de execução gerenciado e desenvolvido especificamente para estratégias de trading: implantação nativa do GitHub, controle via MCP a partir de IDEs de IA, além de interfaces integradas de logs e monitoramento de integridade. Se você prefere gerenciar a infraestrutura por conta própria, a AWS atende bem. Se prefere o ambiente de execução 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 a implantação do seu próprio repositório.
Sim. A TradingHost oferece suporte a qualquer linguagem que possa ser executada dentro de um contêiner.
Sim. A integração da CCXT com a Bybit cobre spot, perpétuos linear e inverse, futuros de USDT e USDC, além de opções de USDC na v5. Faça a implantação da sua estratégia CCXT a partir do GitHub em um runtime da TradingHost; nós a executamos e você mantém o controle das suas chaves. Consulte o runtime do framework CCXT para ver o guia completo de configuração.
Sim, caso seu projeto seja estruturado 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 runtimes da TradingHost para entender o modelo multiestratégia.
O caminho mais rápido é fazer um fork de um runtime de framework da TradingHost: CCXT, Freqtrade ou Hummingbot para obter 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 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 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 com escopo limitado e lista de permissões de IP por chave onde for apropriado, e mantenha o escopo de saque em uma chave separada e gerenciada manualmente.
Sim. A TradingHost oferece suporte ao 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 das operações. Consulte a interface de controle do MCP para obter uma visão completa.
Ambos. A interface de controle do MCP funciona igualmente bem em agentes baseados em CLI (Claude Code CLI, clientes MCP personalizados, chamadas de MCP via script) e 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 principal dispara 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 em execução no mesmo container. 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 seção de observabilidade para acessar os logs e a interface de integridade.
Três causas explicam quase todos os erros 10004: timestamp da requisição fora da janela recv_window (padrão de 5000 ms) devido ao desvio do relógio (clock drift), payload de assinatura montado com parâmetros na ordem errada ou o uso acidental do formato de payload HMAC com uma chave RSA (ou vice-versa). Sincronize o relógio do seu runtime ou consulte o horário do servidor da Bybit antes de assinar. Veja a seção de Notas operacionais acima para obter o guia completo.
A Bybit opera três ambientes com namespaces de chaves distintos: mainnet, testnet (api-testnet.bybit.com) e mainnet demo (api-demo.bybit.com). Uma chave gerada em um deles retornará 10003 nos outros dois. Gere uma nova chave a partir do painel correspondente.
Contas abertas em 2025 ou posteriormente usam a UTA 2.0 por padrão. Se você está na Classic ou na UTA 1.0 e deseja margem cruzada entre produtos, faça o upgrade. O upgrade é irreversível e os futuros inversos perdem o modo hedge. Teste no ambiente demo primeiro.
Não. A Bybit bloqueia IPs dos EUA e da China Continental na borda da API com uma resposta 403, e o KYC rejeita identidades de residentes dos EUA. O TradingHost não pode contornar isso; a restrição é definida pela Bybit.
O incidente foi real, de grande escala e bem documentado (FBI IC3 PSA-250226). As operações de hot wallet, saques e saldos dos clientes da Bybit não foram afetados; a auditoria de Proof of Reserves da Hacken, datada de 26 de fevereiro, confirmou reservas acima de 100% nos principais ativos. Desde então, a Bybit isolou a infraestrutura de assinatura, redesenhou os fluxos de multisig e continua realizando o Merkle-tree PoR mensalmente. Para quem opera estratégias algorítmicas, isso serve como contexto operacional, não como um impedimento atual para a API, mas trate o risco de custódia em corretoras como real e dimensione o tamanho de suas posições de acordo.
O TradingHost opera nas regiões EU e US-East. Escolha a região mais próxima do matching engine do qual sua estratégia depende. Note que a Bybit bloqueia IPs dos EUA na borda da API, de modo que as estratégias para a Bybit não devem ser roteadas a partir da região US-East. Consulte a página de regiões para obter detalhes de roteamento e proximidade.
Não. O TradingHost é focado em runtime de produção e deploy. O backtest deve ser feito em sua própria stack de pesquisa, framework ou no AlgoBuilder.