Tempo de leitura: … min

Runtime nativo de IA para estratégias de trading na BitMEX

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.

Pela equipe de engenharia da TradingHost

Seção 01 · Visão rápida

Visão rápida

Plataforma
BitMEX
Tipo de plataforma
Exchange de cripto (pioneira em futuros perpétuos)
Classe de ativos
Derivativos de cripto (perpetual swaps e futuros)
Produtos suportados
Contrato perpétuo inverso XBTUSD (cada contrato com valor nocional de 1 USD), perpetual swaps cotados em USDT e BTC, dated futures e contratos estilo mercado de previsão em ativos selecionados. Testnet disponível em testnet.bitmex.com. Usuários dos EUA são bloqueados via IP geolocation nas chaves de API.
Modelo de runtime
Runtime de estratégia em container
Origem do deploy
GitHub
Linguagens
Qualquer linguagem compatível com containers
Integrações comuns
REST e WebSocket nativos da BitMEX, 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 BitMEX
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 BitMEX.

Seção 02 · O que BitMEX oferece

O que BitMEX oferece

A BitMEX foi pioneira no perpetual swap de cripto e continua sendo uma plataforma exclusiva de derivativos. O XBTUSD é o principal contrato perpétuo inverso, com cada contrato valendo 1 USD nocional e liquidado em Bitcoin. Contratos perpétuos cotados em USDT e BTC, além de dated futures, completam a oferta. Todas as quantidades de Bitcoin são denominadas em XBt (satoshis) e todas as quantidades de USD em USDt; a conversão no lado do cliente é obrigatória. As especificidades dos endpoints mudam com o tempo. A estrutura geral é estável; as especificações exatas dos contratos, limites de requisições (rate limits) e faixas de taxas estão disponíveis na documentação da BitMEX.

Mercados e padrões de estratégia

  • Market making no contrato perpétuo inverso XBTUSD
  • Estratégias de perpetual swap cotadas em BTC
  • Estratégias de perpetual swap cotadas em USDT
  • Trading de base e calendar spread com dated futures
  • Operações de carry com funding rate em perpétuos inversos
  • Deploys validados em testnet antes do lançamento em produção (mainnet)
  • Streams de ordens e posições via canais privados de WebSocket
  • Arbitragem entre plataformas pareada com mercados spot ou de derivativos fora da BitMEX

Superfície da API

Superfícies de produtos
Perpetual swaps (XBTUSD inverso, cotados em USDT, cotados em BTC), dated futures e contratos estilo mercado de previsão em ativos selecionados. A testnet em testnet.bitmex.com espelha a API de produção com chaves e saldos distintos.
Métodos de conexão
REST em https://www.bitmex.com/api/v1 para envio de ordens e consultas de conta. Streams de WebSocket para dados de mercado em tempo real, profundidade do livro e negociações. Canais privados de WebSocket para eventos de conta, posições e ordens.
Autenticação
Chave de API permanente e segredo por estratégia. Requisições privadas são assinadas com HMAC-SHA256 contra verb + path + nonce + body. O nonce pode ser um timestamp em microssegundos da época Unix ou um valor de cabeçalho api-expires. Usuários dos EUA são bloqueados via IP geolocation nas chaves de API; a criação da chave funciona, mas os endpoints de negociação recusam o acesso.
Denominação
Todas as quantias de Bitcoin são denominadas em XBt (satoshis, 1 XBt = 0.00000001 XBT). Todas as quantias de USD são denominadas em USDt (1 USDt = 0.000001 USDT). Os contratos perpétuos XBTUSD possuem valor nocional de 1 USD cada e são liquidados em Bitcoin. A conversão no lado do cliente é necessária para exibir ou processar valores em unidades padrão de BTC ou USD.

Para detalhes específicos, consulte BitMEX

Endpoints específicos, especificações de contratos, limites de requisições, faixas de taxas e histórico de versões estão na documentação da BitMEX. Considere-os como a fonte única da verdade.

Seção 03 · Desenvolva com IA

Desenvolva sua estratégia para BitMEX 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 BitMEX

    Controle direto sobre comportamentos específicos da BitMEX, denominações em XBt e USDt e lógica de execução de ordens.

  • CCXT

    Interface unificada entre a BitMEX e outras plataformas de derivativos de cripto.

  • Hummingbot

    Deploys baseados em framework utilizando a estrutura de estratégia e o modelo de configuração do Hummingbot.

  • Conector personalizado

    Seu próprio motor de trading interno ou integração proprietária com a BitMEX.

Suporte de frameworks para produtos BitMEX

A BitMEX é uma plataforma exclusiva de derivativos: não há coluna de mercado spot na matriz. O CCXT expõe contratos perpétuos e dated futures por meio da classe unificada bitmex; o Hummingbot cobre perpetual swaps via bitmex_perpetual; o Freqtrade não lista a BitMEX como uma exchange suportada. O acesso à API nativa da BitMEX alcança todos os contratos listados pela plataforma.

FrameworkPerpFuturosOpções
Native BitMEX APISuportadoSuportadoNão documentado como suportado
CCXTSuportadoSuportadoNão documentado como suportado
HummingbotSuportadoNão documentado como suportadoNão documentado como suportado
FreqtradeNão documentado como suportadoNão documentado como suportadoNão documentado como suportado

✓ 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 BitMEX fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à BitMEX é 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 à BitMEX.

TradingHost

  • Mantém o runtime online.
  • Exibe logs e health checks.
  • Seleção de região.
  • Superfície de deploy controlada.

Fluxo de deploy

  1. PASSO 01

    Conecte o GitHub

    Autorize a TradingHost a acessar sua conta do GitHub.

  2. PASSO 02

    Vincule um repositório ou comece a partir de um framework

    Aponte a TradingHost para o repositório existente da sua estratégia ou faça um fork de um runtime de framework da TradingHost (CCXT ou Hummingbot) para obter uma base funcional.

  3. 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 (chave de API e segredo da BitMEX, etc.) e faça o deploy. A TradingHost gera seu contêiner a partir do repositório e executa sua estratégia em uma infraestrutura gerenciada de Kubernetes. Não é necessário instalar o Docker localmente.

  4. 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ê.

  5. 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 BitMEX

Problemas práticos que surgem ao executar uma estratégia da BitMEX em um runtime de nuvem em container — detalhes que não estão na documentação da BitMEX nem nos READMEs de frameworks. Cada ponto abaixo é citado ou parafraseado da própria documentação da BitMEX; as orientações de implantação vêm da experiência de rodar essas estratégias na TradingHost.

  1. 01 · Denominação em XBt

    Todas as quantias de Bitcoin são em satoshis (1 XBt = 0.00000001 XBT); USD em USDt (1 USDt = 0.000001 USDT)

    As respostas da API da BitMEX utilizam denominações não padronizadas. Saldos em Bitcoin, campos walletBalance, margem de posição e valores nocionais de ordens são todos expressos em XBt (satoshis), não em XBT. Valores cotados em USD são expressos em USDt, seis casas decimais abaixo de USDT. Estratégias que exibem ou processam posições em unidades legíveis para o usuário precisam realizar a conversão no lado do cliente. O bug mais comum no dia de lançamento é uma estratégia que tenta dimensionar uma posição de 0.1 BTC e, em vez disso, dimensiona 0.1 XBt porque a conversão foi esquecida.

  2. 02 · Contrato XBTUSD

    Cada contrato perpétuo XBTUSD tem valor nocional de 1 USD, liquidado em Bitcoin (inverso)

    O XBTUSD é um inverse perpetual: cada contrato representa 1 USD de exposição nocional, com PnL e margem liquidados em Bitcoin. Os cálculos do preço de liquidação são em USD. Isso difere de um perp linear com margem em USDT, onde o tamanho do contrato escala com a quantidade da moeda subjacente. Estratégias que misturam diferentes exchanges devem codificar o multiplicador do contrato e a moeda de liquidação por instrumento, em vez de assumir um formato único para todo o book.

  3. 03 · Geofence dos EUA

    Usuários dos EUA são bloqueados por meio de IP geolocation nas chaves de API

    A BitMEX proíbe traders baseados nos EUA. A aplicação dessa regra ocorre no nível da chave de API por IP geolocation: uma chave cujo tráfego recente seja geolocalizado nos EUA terá o acesso a endpoints privados recusado, independentemente do status de verificação da conta. Um runtime da TradingHost na região US-East com saída de rede nos EUA será bloqueado de operar na BitMEX. Escolha uma região da TradingHost cuja geografia de saída seja consistente tanto com o contrato de usuário da BitMEX quanto com as suas próprias diretrizes de conformidade.

  4. 04 · Assinatura de nonce

    Assinatura HMAC-SHA256 sobre verb + path + nonce + body; api-expires é preferível ao nonce bruto

    As assinaturas REST da BitMEX são um HMAC-SHA256 da concatenação de verb + path + nonce + body, assinada com o seu secret. O nonce pode ser um timestamp Unix em microssegundos ou, de preferência, um cabeçalho api-expires que define um timestamp de expiração futuro para a requisição. O uso de api-expires evita a exigência estrita de nonce estritamente crescente (monotonic-nonce) e é mais robusto contra desvios de relógio (clock skew) entre containers. A maioria dos SDKs da BitMEX usa api-expires por padrão; verifique o seu e fixe essa configuração.

  5. 05 · Chaves permanentes

    As chaves de API são permanentes até serem revogadas manualmente; as chaves de testnet são isoladas

    As chaves de API da BitMEX não expiram automaticamente. A rotação é uma responsabilidade manual: rotacione suas chaves periodicamente em vez de depender de uma expiração automática da plataforma. A testnet em testnet.bitmex.com emite chaves separadas, mantém saldos separados e atende a endpoints separados; uma falha de autenticação silenciosa comum é enviar código validado na testnet para a produção sem trocar o conjunto de chaves, ou vice-versa. Mantenha os secrets de testnet e produção em entradas separadas no Secrets da TradingHost; nunca reutilize o mesmo secret em ambientes diferentes.

  6. 06 · Limites de requisições

    Limite de requisições REST por minuto em endpoints privados; WebSocket é fortemente recomendado para loops rápidos (hot loops)

    A BitMEX limita as requisições de endpoints REST privados em uma janela por minuto. O padrão recomendado para estratégias ativas é obter dados de mercado e o estado da conta a partir de conexões WebSocket, utilizando o REST apenas para ações que o WebSocket não pode realizar (envio e cancelamento de ordens). Fazer polling via REST em loops rápidos para atualizações de orderbook ou estado de posições esgotará sua cota e gerará erros 429.

Seção 06 · Indicado para

Indicado para

Os runtimes da TradingHost para a BitMEX são ideais para:

  • Desenvolvedores criando estratégias em IDEs de IA (Cursor, Claude Code)
  • Traders sistemáticos de cripto
  • Desenvolvedores quant
  • Usuários de CCXT e Hummingbot
  • Mesas focadas em derivativos e market makers de perpétuos
  • 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 é afiliada à BitMEX.

Não. O código da sua estratégia se conecta à BitMEX e envia instruções de acordo com a 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 BitMEX é fornecido pela própria BitMEX. Você é responsável por sua conta na BitMEX, permissões de API, credenciais e conformidade com os termos da BitMEX.

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 bots prontos. Com a TradingHost, você mesmo escreve ou gera a estratégia (frequentemente usando 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 detêm a lógica da estratégia; a TradingHost 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 secrets, failover de região e monitoramento de uptime. A TradingHost oferece um runtime gerenciado criado especificamente para estratégias de trading: implantação nativa via GitHub, controle via MCP a partir de IDEs de IA, além de interfaces prontas para logs e status de saúde da aplicação. Se você prefere operar 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 framework runtime compatível com a 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.

Sim. O CCXT expõe a BitMEX por meio da classe unificada `bitmex`, cobrindo perpétuos e dated futures. Não há produto spot para suportar. Consulte o framework runtime do CCXT para ver o processo completo de configuração.

Não. A BitMEX proíbe traders baseados nos EUA. A aplicação dessa regra ocorre no nível da chave de API por IP geolocation: uma chave cujo tráfego recente seja geolocalizado nos EUA terá o acesso a endpoints privados recusado, independentemente do status de verificação da conta. Um runtime da TradingHost na região US-East com saída de rede nos EUA será bloqueado de operar na BitMEX. Escolha uma região da TradingHost cuja geografia de saída seja consistente tanto com o contrato de usuário da BitMEX quanto com as suas próprias diretrizes de conformidade.

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 runtimes diferentes 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 framework runtime da TradingHost: CCXT ou Hummingbot 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 secrets controlado pelo GitHub. A TradingHost as lê em tempo de execução por meio de secrets de repositório do GitHub, secrets de ambiente ou seu próprio processo aprovado de gerenciamento de secrets. A TradingHost não precisa da custódia da sua chave de API e secret da BitMEX. Consulte secrets da plataforma para ver o modelo completo de manipulação.

Não. As estratégias nunca devem precisar de permissões de saque. Use permissões com escopo limitado (ordem, leitura de conta) e rotacione as chaves manualmente, pois as chaves da BitMEX não expiram automaticamente.

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 das operações. Consulte a interface de controle MCP para obter a visão completa.

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 ciclo de implantação nativo do GitHub também funciona sem qualquer ferramenta de IA: um git push comum para a sua branch principal dispara uma nova implantação.

O runtime detecta o crash e expõe os logs e as informações de integridade (health) 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 BitMEX denomina todos os valores em Bitcoin em XBt (satoshis). 1 XBt = 0,00000001 XBT, portanto, um saldo que você lê como 100.000.000 XBt equivale a 1 BTC. Os valores em USD são expressos em USDt, seis casas decimais abaixo do USDT. O bug mais comum no dia do deploy é uma estratégia que deveria definir o tamanho em BTC, mas acaba definindo em XBt porque a conversão foi esquecida. Os contratos perpétuos de XBTUSD têm valor nocional de 1 USD cada e são liquidados em Bitcoin. 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 de que sua estratégia depende. 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.