Runtime nativo de IA para estratégias de trading na Phemex
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
- Phemex
- Tipo de plataforma
- Exchange de criptomoedas
- Classe de ativos
- Cripto
- Produtos suportados
- Spot, contratos perpétuos inversos e de USDT, futuros com vencimento, sub-accounts e testnet pública
- 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 Phemex, CCXT, Freqtrade, Hummingbot, 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 Phemex
- 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 Phemex
Seção 02 · O que Phemex oferece
O que Phemex oferece
A Phemex oferece spot, contratos perpétuos com margem em USDT, perpétuos inversos e futuros com vencimento via APIs REST e WebSocket. A autenticação é HMAC-SHA256 com um timestamp de expiração de requisição explícito, e o limitador de taxa é dividido em três grupos independentes (contract, spotOrder, others), garantindo que um loop intenso de contratos não limite as ordens spot. Uma testnet separada em testnet-api.phemex.com permite validar o comportamento da API sem capital real. A Phemex US opera como uma entidade distinta; a API global não a cobre. Detalhes específicos dos endpoints mudam com o tempo. A estrutura geral é durável; os limites de taxa precisos, faixas de taxas e listas de símbolos estão disponíveis na documentação da Phemex.
Mercados e padrões de estratégia
- Estratégias de contratos perpétuos com margem em USDT
- Contratos perpétuos inversos (com margem em moedas)
- Estratégias de spot em pares de USDT e BTC
- Deploys multi-estratégia isolados por sub-accounts
- Deploys validados em testnet antes do lançamento em produção
- Operações de carry trade de taxa de financiamento em perpétuos
- Consumidores de order book e fluxo de negociações via WebSocket
- Execução cruzada entre grupos de limite de taxa (contract + spot)
Superfície da API
- Superfícies de produtos
- Spot, contratos perpétuos com margem em USDT, perpétuos inversos (com margem em moedas), futuros com vencimento e hierarquias de sub-accounts. Uma testnet pública em testnet-api.phemex.com roda em um pool separado com seu próprio limite de requisições e não permite negociar ativos reais. A Phemex US opera como uma entidade distinta em uma infraestrutura separada; contas globais da Phemex não são intercambiáveis com contas da Phemex US.
- Métodos de conexão
- REST para envio de ordens e consultas de conta. WebSocket para dados de mercado em tempo real, atualizações de order book, trades e eventos de conta. Inscrições privadas de WebSocket exigem autenticação na conexão.
- Autenticação
- Chave de API, secret e um timestamp de expiração de requisição assinado com HMAC-SHA256. Três grupos de limite de taxa (contract, spotOrder, others) possuem, cada um, seu próprio limite de requisições; exceder um deles não afeta os outros. Sub-accounts podem ter chaves com permissões restritas em relação à conta principal.
Para detalhes específicos, consulte Phemex
Endpoints específicos, pesos de limite de taxa, listas de símbolos, faixas de taxas e histórico de versões estão disponíveis na documentação da Phemex. Use-os como a fonte oficial de informações.
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para Phemex 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 Phemex
Controle direto sobre comportamentos específicos da Phemex, dados de conta e lógica de execução de ordens em spot, perps de USDT e perps inversos.
CCXT
Interface comum entre a Phemex e outras exchanges de criptomoedas. A CCXT expõe os mercados de spot e swaps perpétuos da Phemex por meio da classe unificada `phemex`.
Freqtrade ou Hummingbot
Deploys baseados em frameworks utilizando suas estruturas de estratégia e modelos de configuração. Ambos listam a Phemex entre as exchanges suportadas.
Conector personalizado
Seu próprio motor de trading interno ou integração proprietária com a Phemex, assinando requisições com HMAC-SHA256 de acordo com o esquema de expiração publicado.
Suporte de frameworks para produtos Phemex
A cobertura varia de acordo com o framework. A CCXT abrange a maior parte dos recursos da Phemex para spot e swaps perpétuos; o Freqtrade e o Hummingbot cobrem spot, com suporte a perpétuos dependendo da versão do conector; o acesso nativo à API da Phemex cobre tudo o que a exchange oferece, incluindo contratos inversos e hierarquias de sub-accounts.
✓ suporte confirmado de acordo com as documentações oficiais dos frameworks. "não" indica que não há suporte documentado oficialmente. "parcial" indica cobertura limitada, veja os detalhes no texto acima.
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 Phemex fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à Phemex é 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 à Phemex.
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 os valores de ambiente que sua estratégia precisa (chave de API da Phemex, secret e o esquema de timestamp de expiração que seu código utiliza) 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 requer instalação local do Docker.
- 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 Phemex
Detalhes práticos que podem causar problemas ao executar uma estratégia da Phemex em um runtime de nuvem em container — informações que não estão na documentação da Phemex nem nos READMEs de frameworks. Cada ponto abaixo foi citado ou parafraseado da própria documentação da Phemex; as orientações de deploy vêm da experiência de rodar essas estratégias na TradingHost.
01 · Divisão do limite de taxa
Três grupos de requisição independentes: contract, spotOrder, others
O limitador de taxa da API da Phemex é dividido em três grupos independentes, em vez de um pool global único. O grupo `contract` cobre endpoints de trading de contratos, o `spotOrder` cobre o envio de ordens spot e o `others` cobre todo o restante. Cada grupo possui seu próprio limite de requisições; exceder um deles não bloqueia os outros. Planeje estratégias que utilizem tanto spot quanto perpétuos considerando o limite individual de cada grupo, e não um limite total combinado.
02 · Expiração de requisição
Cada requisição assinada precisa de um timestamp de expiração explícito
O esquema de assinatura da Phemex exige um timestamp de expiração explícito em cada requisição autenticada (em segundos Unix, geralmente `now + 60`). Requisições com expiração já vencida ou definida muito à frente no futuro são rejeitadas. Uma falha silenciosa comum: o código do cliente calcula a expiração apenas uma vez na inicialização e a reutiliza nas chamadas seguintes, fazendo com que, após um minuto, todas as requisições retornem erro 401. Calcule a expiração no momento da assinatura, não na inicialização do objeto, e mantenha os relógios dos containers sincronizados via NTP.
03 · Pool de testnet
A Testnet roda em um host separado, com suas próprias chaves e limite de requisições
A testnet da Phemex em `testnet-api.phemex.com` emite chaves de API separadas, mantém saldos separados e atende a endpoints separados. Uma falha de autenticação silenciosa comum é configurar uma estratégia de produção com chaves de testnet (ou enviar código validado na testnet para a produção sem trocar o conjunto de chaves). Mantenha as credenciais de testnet e produção em entradas separadas de Secrets do TradingHost, nunca reutilizando-as entre ambientes. O limite de requisições da testnet é significativamente menor do que o da mainnet; não dimensione a vazão (throughput) da sua estratégia com base em observações da testnet.
FontePhemex testnet docs04 · Separação dos EUA
A Phemex US é uma entidade separada com sua própria infraestrutura
A Phemex US (`phemex.com/us`) opera como uma entidade corporativa distinta da Phemex global e roda em uma infraestrutura separada. Uma conta global da Phemex não concede acesso à Phemex US, e uma conta da Phemex US não pode assinar requisições para endpoints da Phemex global. Se a sua estratégia transita entre jurisdições dos EUA e de fora dos EUA, configure a seleção da exchange como um valor de configuração de primeira classe, e não como uma mudança baseada no tipo de chave. A restrição de jurisdição é aplicada na criação da conta e pode rejeitar requisições de API com base no IP.
05 · Postura pós-incidente
Gere novas chaves pós-janeiro de 2025 se você possuía alguma ativa durante o incidente
A Phemex divulgou um incidente de segurança em sua hot-wallet em 23 de janeiro de 2025 às 11:30 UTC. Depósitos e saques foram suspensos temporariamente; os fundos em cold-wallets não foram afetados. A exchange contratou empresas de segurança terceirizadas, acionou as autoridades e restabeleceu os serviços gradualmente nas semanas seguintes. Se você possuía uma chave de API da Phemex ativa durante esse período e não a rotacionou desde então, trate-a como suspeita e gere uma nova. O esquema de assinatura em si não mudou; o ponto de higiene operacional é rotacionar qualquer chave anterior às mudanças de postura pós-incidente.
06 · Escopo de sub-account
As sub-accounts possuem suas próprias chaves; direcione chaves específicas de cada estratégia por meio delas
As sub-accounts da Phemex são um limite de isolamento de primeira classe: cada sub-account mantém seu próprio saldo, suas próprias posições e suas próprias chaves de API. Chaves específicas por estratégia vinculadas a uma sub-account limitam o raio de impacto em caso de vazamento de chave, permitindo limitar cada estratégia ao saldo da sub-account em vez de expor a conta inteira. Use uma sub-account por estratégia de produção como padrão, com uma chave operacional separada na conta principal para transferências entre sub-accounts que não devem ser acessíveis pelo código da estratégia.
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a Phemex 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. O TradingHost é independente e não possui afiliação com a Phemex.
Não. O código da sua estratégia se conecta à Phemex e envia instruções de acordo com sua própria lógica, permissões de conta e método de integração. O TradingHost fornece o ambiente de execução (runtime) onde esse código roda.
Não. O acesso à API da Phemex é fornecido pela própria Phemex. Você é responsável por sua conta Phemex, permissões de API, credenciais e conformidade com os termos da Phemex.
Não. O TradingHost é o ambiente de execução em nuvem onde o código da sua estratégia roda. Nós não fornecemos sinais, modelos de previsão de IA ou bots pré-configurados. Com o TradingHost, você mesmo escreve ou gera a estratégia (geralmente usando Cursor ou Claude Code), mantém o código no GitHub e usa o TradingHost para executá-lo em produção. Produtos como 3Commas, Cryptohopper e similares são proprietários da lógica da estratégia; o TradingHost apenas executa a sua estratégia.
A AWS e a DigitalOcean fornecem computação bruta. Você mesmo precisa gerenciar atualizações de sistema operacional, orquestração de contêineres, envio de logs, rotação de credenciais, failover de região e monitoramento de uptime. O TradingHost oferece um ambiente de execução gerenciado e feito sob medida 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 monitoramento de integridade. Se você prefere operar a infraestrutura por conta própria, a AWS atende. Se prefere o ambiente de execução como um serviço gerenciado, o TradingHost é o caminho mais curto.
Sim. O TradingHost executa estratégias em Python; escolha o ambiente de execução de framework que corresponda à sua stack ou faça o deploy do seu próprio repositório.
Sim. O TradingHost suporta qualquer linguagem que possa ser executada dentro de um contêiner.
Sim. A CCXT expõe os mercados spot e de swaps perpétuos da Phemex por meio da classe unificada `phemex`. Coloque sua estratégia CCXT em um contêiner, aponte para o GitHub e o TradingHost a executará como qualquer outro projeto Python ou Node. Consulte o ambiente de execução do framework CCXT para ver os detalhes completos de configuração.
Sim, caso seu projeto seja projetado dessa forma. Você pode executar múltiplos processos ou serviços de estratégia dentro de um único ambiente de execução, ou separá-los em diferentes ambientes para obter isolamento e clareza operacional. As sub-accounts da Phemex se alinham perfeitamente ao modelo multiestratégia: defina o escopo de uma chave por sub-account e por estratégia. Consulte a página de ambientes de execução do TradingHost para saber mais sobre o modelo multiestratégia.
O caminho mais rápido é fazer o fork de um ambiente de execução de framework do 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 é grátis; os planos de execução estão listados na página de preços.
No seu fluxo de trabalho de secrets controlado pelo GitHub. O TradingHost as lê em tempo de execução por meio de secrets de repositório do GitHub, secrets de ambiente ou pelo seu próprio processo aprovado de gerenciamento de credenciais. O TradingHost não precisa da custódia da sua chave de API e segredo da Phemex. Consulte as secrets 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 opção de saque totalmente desativada na chave da estratégia. As sub-accounts da Phemex permitem limitar o raio de impacto por estratégia, garantindo que a conta principal nunca possua uma chave de estratégia com permissão de saque.
Sim. O 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 execução. O MCP é uma interface de controle e observabilidade, não o caminho de execução de ordens. 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 git push comum para a sua branch principal dispara um novo deploy.
O ambiente de execução detecta a falha 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 contêiner. O código da sua estratégia continua sendo o 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.
O limitador de requisições da Phemex se divide em três grupos independentes (contract, spotOrder, others), e exceder um deles não limita os outros. Se o seu loop de contract está sofrendo limitação enquanto o spot continua funcionando, o limite do grupo contract é o gargalo, e não a conta global. Reduza a frequência de requisições de contract ou divida as operações de contract e spot em sub-accounts separadas, cada uma com suas próprias chaves. Consulte a seção de Notas operacionais acima para obter a orientação completa.
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 obter detalhes de roteamento e proximidade.
Não. O TradingHost é focado em runtime de produção e deploy. O backtesting deve ser feito na sua stack de pesquisa, framework ou AlgoBuilder.