Tempo de leitura: … min

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

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 nativo, 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
AscendEX
Tipo de plataforma
Exchange de criptoativos (antiga BitMax)
Classe de ativos
Cripto
Produtos suportados
Conta à vista (spot), conta de margem e conta de futuros (v2); posições de futuros com margem isolada e cruzada
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 AscendEX, CCXT, Freqtrade, Hummingbot, conectores personalizados
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, controle via MCP
Papel de AscendEX
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 AscendEX

Seção 02 · O que AscendEX oferece

O que AscendEX oferece

A AscendEX (que mudou de nome após deixar de se chamar BitMax em março de 2021) divide cada conta em três objetos de conta (cashAccount, marginAccount, futuresAccount), e toda URL de requisição privada precisa conter o valor de `accountGroup` do usuário, retornado na primeira autenticação. A API de futures v2 possui sua própria documentação. Os domínios legados da BitMax (bitmax.io, btmx.com, btmx.io) foram desativados em maio de 2021 e não são mais roteáveis. As especificidades dos endpoints mudam com o tempo. A estrutura geral é estável; os limites de requisições exatos, as faixas de taxas e as listas de símbolos estão disponíveis na documentação da AscendEX.

Mercados e padrões de estratégia

  • Estratégias de spot em pares de USDT
  • Empréstimos de margem e spot com margem isolada
  • Futuros perpétuos com margem em USDT (API v2)
  • Transferências entre contas (cash, margin e futures)
  • Posições de futuros com margem isolada e cruzada
  • Chaves de API com escopo limitado por objeto de conta
  • Consumidores de order book e fluxo de negociações via WebSocket
  • Deploys de múltiplas estratégias isoladas por subcontas

Superfície da API

Superfícies de produtos
As contas da AscendEX contêm três objetos de conta distintos: cashAccount (spot), marginAccount (margem) e futuresAccount (futures v2). As transferências entre eles são explícitas. A API de futures v2 utiliza um conjunto próprio de documentação; os domínios legados da BitMax (bitmax.io, btmx.com, btmx.io) foram desativados em maio de 2021 e não são mais roteáveis.
Métodos de conexão
REST para envio de ordens e consultas de conta, exigindo o valor de `accountGroup` como prefixo no caminho da URL para requisições privadas (esse valor é obtido no endpoint de informações da conta na primeira autenticação). WebSocket para dados de mercado e eventos privados de conta. Os fluxos públicos de WebSocket são abertos; as inscrições privadas exigem autenticação.
Autenticação
Chave de API e segredo assinados com HMAC-SHA256. O endpoint de informações da conta na primeira autenticação retorna o valor de `accountGroup`, que deve ser usado como prefixo na URL de cada requisição privada. Uma chave é válida para uma associação específica de objeto de conta (cash, margin, futures); usar uma chave de conta spot (cash) em um endpoint de futuros retorna um erro de permissão em vez de realizar um redirecionamento automático.

Para detalhes específicos, consulte AscendEX

Endpoints específicos, pesos de limite de requisições, listas de símbolos, faixas de taxas e histórico de versões estão disponíveis na documentação da AscendEX. Utilize-os como a fonte oficial de informações.

Seção 03 · Desenvolva com IA

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

    Controle direto sobre comportamentos específicos da AscendEX, incluindo o esquema de URL prefixado com accountGroup e a divisão de objetos de conta entre cash, margin e futures.

  • CCXT

    Interface comum entre a AscendEX e outras exchanges de criptoativos. O CCXT expõe os mercados spot e de swap da AscendEX por meio da classe unificada `ascendex`.

  • Freqtrade ou Hummingbot

    Deploys baseados em frameworks que utilizam suas próprias estruturas de estratégia e modelos de configuração. Ambos incluem a AscendEX na lista de exchanges suportadas.

  • Conector personalizado

    Seu próprio motor de trading interno ou integração proprietária com a AscendEX, gerenciando a descoberta de accountGroup e o esquema de assinatura HMAC-SHA256.

Suporte de frameworks para produtos AscendEX

A cobertura varia de acordo com o framework. O CCXT abrange os mercados spot e de swap da AscendEX, incluindo futures v2; o Freqtrade cobre spot; o Hummingbot cobre spot com suporte parcial a swap; a API nativa da AscendEX cobre todos os recursos oferecidos pela exchange, incluindo transferências entre contas (cash, margin e futures).

FrameworkSpotPerpMargemFutures v2
Native AscendEX APISuportadoSuportadoSuportadoSuportado
CCXTSuportadoSuportadoParcialmente suportadoSuportado
FreqtradeSuportadoNão documentado como suportadoNão documentado como suportadoNão documentado como suportado
HummingbotSuportadoParcialmente suportadoNão documentado como suportadoParcialmente suportado

✓ suporte confirmado de acordo com a documentação oficial do framework. "não" indica que não há suporte documentado oficialmente. "parcial" indica cobertura limitada. 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 AscendEX fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à AscendEX é 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 à AscendEX.

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

  3. PASSO 03

    Implante em um contêiner da TradingHost

    Escolha uma região (EU ou US-East), informe as variáveis de ambiente que sua estratégia precisa (chave de API da AscendEX, secret e o valor de accountGroup retornado pelo endpoint account-info) e faça o deploy. O 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.

  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 AscendEX

Detalhes importantes que podem causar problemas ao executar uma estratégia para a AscendEX em um runtime de nuvem em container — informações que não estão na documentação da AscendEX nem nos arquivos README dos frameworks. Cada ponto abaixo foi extraído ou adaptado da própria documentação da AscendEX; as orientações de deploy são baseadas na execução dessas estratégias na TradingHost.

  1. 01 · accountGroup

    Requisições privadas exigem o prefixo accountGroup na URL

    As requisições privadas da AscendEX são roteadas em `https://ascendex.com/<accountGroup>/api/pro/...`. O valor de `accountGroup` é individual por usuário e retornado pelo endpoint de informações da conta na primeira autenticação. Um erro silencioso comum é definir um valor fixo para `accountGroup` no código inicial e esquecer que ele varia por conta; com isso, as requisições privadas retornam erro 404 ou de roteamento, mesmo que a chave esteja correta. Busque o `accountGroup` uma vez na inicialização da estratégia e salve-o em cache no ambiente do runtime durante a execução do deploy.

  2. 02 · Objetos de conta

    Cash, margin e futures são três objetos de conta distintos

    Uma conta de usuário da AscendEX possui três objetos de conta: `cashAccount` (spot), `marginAccount` (margem) e `futuresAccount` (futures v2). Cada um tem seu próprio saldo e escopo de API. As transferências entre eles exigem chamadas a endpoints explícitos, não ocorrendo de forma implícita como movimentações de margem. Uma estratégia projetada para liquidar uma posição de futuros na conta spot precisa chamar o endpoint de transferência após fechar a posição; isso não acontece de forma automática. Em estratégias de produção, gere chaves específicas para cada objeto de conta para evitar que uma chave de conta spot envie ordens de futuros acidentalmente.

  3. 03 · Domínios legados

    bitmax.io, btmx.com e btmx.io deixaram de rotear em 21 de maio de 2021

    A AscendEX passou por um rebranding a partir da BitMax em março de 2021. Os domínios legados (`bitmax.io`, `btmx.com`, `btmx.io`) foram totalmente desativados às 15:00 UTC de 21 de maio de 2021. Integrações antigas que ainda apontam para esses domínios retornam falhas de DNS ou de roteamento. Novas integrações devem apontar para os domínios da AscendEX e para a documentação atualizada. Tutoriais e postagens de fóruns antigos da BitMax ainda podem ser encontrados na web; considere-os obsoletos e verifique as informações na documentação atual antes de copiar qualquer código.

  4. 04 · Isolamento de risco

    Posições de futuros isoladas limitam o risco de liquidação cruzada entre contas

    O mercado de futures da AscendEX suporta margem cruzada (cross) e isolada (isolated) por posição. Posições isoladas limitam a perda à margem alocada; uma liquidação não gera um efeito cascata na conta cruzada ou em outras posições. Para implantações multiestratégia em que uma estratégia possui uma posição maior que as demais, prefira a margem isolada: uma liquidação isolada é resolvida de forma limpa, sem afetar as outras posições. Documente o modo de margem em seu repositório para que uma nova implantação nunca o altere silenciosamente.

  5. 05 · Escopo do WebSocket

    Inscrições privadas de WebSocket têm escopo de autenticação por objeto de conta

    Os canais privados de WebSocket da AscendEX são limitados a um objeto de conta específico (cash, margin ou futures). Inscrever-se em um canal privado com uma chave emitida para um objeto de conta diferente retorna um erro de inscrição em vez de alternar os escopos de forma transparente. Alinhe o caminho de inscrição do WebSocket ao objeto de conta para o qual a chave foi emitida e documente essa associação junto com a chave no seu manifesto de segredos. Uma estratégia de futures que usa uma chave de cashAccount para envio de ordens e uma inscrição de WebSocket de futuresAccount é uma fonte comum de incompatibilidade.

Seção 06 · Indicado para

Indicado para

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

  • Desenvolvedores que criam 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 AscendEX.

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

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 pré-configurados. 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 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ê 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 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 prontas para logs e monitoramento de integridade. 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 compatível com 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 expõe os mercados spot e swap da AscendEX por meio da classe unificada `ascendex`. Coloque sua estratégia de 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, 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. O escopo de chaves por objeto de conta da AscendEX funciona muito bem com o modelo multiestratégia. 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 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ê essas chaves em tempo de execução por meio de segredos de 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, segredo ou valor de accountGroup da AscendEX. 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. Use permissões com escopo limitado (leitura, negociação) e mantenha a função de saque totalmente desativada na chave da estratégia. A AscendEX emite chaves por objeto de conta, de modo que as operações de cash, margin e futures possuem suas próprias interfaces de chave; mantenha a chave com permissão de saque totalmente separada e nunca a utilize em um runtime de estratégia.

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, analisar 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 trades. Consulte a interface de controle MCP para obter uma 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 push comum de 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 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 integridade.

As requisições privadas da AscendEX são roteadas sob `https://ascendex.com/<accountGroup>/api/pro/...`. O valor de `accountGroup` é individual por usuário e é retornado pelo endpoint de informações da conta na primeira autenticação. Se você copiou um modelo inicial que define o `accountGroup` de forma fixa para um valor conhecido ou assume que ele seja `0`, as requisições retornarão erro 404, mesmo que a chave esteja correta. Busque o `accountGroup` na inicialização, armazene-o em cache no ambiente do runtime e nunca o defina de forma fixa. Consulte a seção de Notas operacionais acima para obter a orientação completa.

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 pertence à sua stack de pesquisa, framework ou AlgoBuilder.