Runtime nativo de IA para estratégias de trading na Crypto.com Exchange
Desenvolva no Cursor, Claude Code ou em qualquer IDE de IA. Faça o deploy a partir do GitHub em um runtime gerenciado na nuvem com controle MCP nativo, logs e seleção de região.
Seção 01 · Visão rápida
Visão rápida
- Plataforma
- Crypto.com Exchange (operada pela Foris DAX Limited, Ilhas Cayman)
- Tipo de plataforma
- Exchange de criptomoedas centralizada
- Classe de ativos
- Cripto (spot, derivativos perpétuos, margem)
- Produtos suportados
- Spot, derivativos perpétuos, margem. Os derivativos são oferecidos por afiliadas da Crypto.com com licenças separadas e possuem restrições geográficas (as jurisdições excluídas incluem Estados Unidos, Reino Unido, Singapura e cerca de outras 110, conforme a lista da central de ajuda da Crypto.com).
- Modelo de runtime
- Runtime de estratégia em contêiner
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem executável em contêiner
- Integrações comuns
- API nativa da Crypto.com Exchange v1, CCXT (`cryptocom`), FIX 4.4 (GEN 3.0, institucional), clientes HTTP / WebSocket 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 Crypto.com Exchange
- Conta da exchange, emissão de chaves de API, acesso ao mercado, ambiente de execução, custódia
- Afiliação
- O TradingHost é independente e não possui afiliação com a Crypto.com, Foris DAX Limited ou qualquer entidade do grupo Crypto.com.
Seção 02 · O que Crypto.com Exchange oferece
O que Crypto.com Exchange oferece
A Crypto.com Exchange oferece trading de spot, derivativos perpétuos e margem por meio de uma API v1 unificada que expõe interfaces REST, WebSocket e FIX 4.4. As estratégias se autenticam com chaves de API assinadas com HMAC-SHA256; as hierarquias de contas mestre e subcontas são tratadas de forma nativa, e um sandbox de UAT separado é hospedado em `uat-api.3ona.co`. Os detalhes dos endpoints mudam com o tempo. A estrutura geral é estável; as cotas precisas de limites de taxa, códigos de erro e listas de instrumentos `-PERP` estão disponíveis na documentação da Crypto.com.
Mercados e padrões de estratégia
- Market making no mercado spot em pares de CRO e stablecoins
- Captura de base perpétua e taxa de financiamento (funding rate) em instrumentos `-PERP`
- Arbitragem cruzada spot vs. perpétuo (única plataforma, duas interfaces de produtos)
- Execução direcional financiada por margem com risco isolado por subconta
- Orquestração de ordens gatilho / TP / SL via `private/advanced/create-order` do Advanced Order Management (pós-jan-2026)
- Execução identificada com `broker_id` para estratégias de reembolso de taxas (fee-rebate)
- Fluxo sensível à latência via FIX 4.4 para mesas institucionais
- Distribuição de múltiplas estratégias sob uma única conta mestre usando isolamento de subcontas
Superfície da API
- Superfícies de produtos
- Spot, derivativos perpétuos e margem via API unificada Exchange v1. Produtos de Staking, Earn e poupança não permitem trading algorítmico. O sandbox está disponível em uat-api.3ona.co / uat-stream.3ona.co com chaves separadas.
- Métodos de conexão
- REST e WebSocket. A API anterior Derivatives v1 foi integrada à Exchange v1; a Spot v2.1 era uma geração anterior. O WebSocket opera em dois streams: User API em `wss://stream.crypto.com/exchange/v1/user` e Market Data em `wss://stream.crypto.com/exchange/v1/market`. Endpoint FIX 4.4 (GEN 3.0) disponível para contas institucionais.
- Autenticação
- HMAC-SHA256 sobre `method + id + api_key + parameter_string + nonce`, assinado com o segredo da API. Hierarquia de conta mestre / subconta via `private/get-accounts`. Whitelist de IP opcional por chave (obrigatória para chaves com permissões de trading ou saque).
Para detalhes específicos, consulte a Crypto.com
Endpoints específicos, limites de taxa, listas de instrumentos, faixas de taxas (fee tiers) e histórico de versões estão na documentação da Crypto.com. Considere-os como a única fonte de verdade.
- exchange-docs.crypto.com/exchange/v1Referência unificada de REST + WebSocket da Exchange v1
- exchange-docs.crypto.com/derivativesAPI de Derivativos (integrada à Exchange v1)
- help.crypto.com, API articleCriação de chaves de API, permissões, whitelist de IP
- crypto.com/en/product-news/fixapiAnúncio da API FIX para GEN 3.0
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para Crypto.com Exchange 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 Crypto.com Exchange v1
Controle direto sobre comportamentos específicos da Crypto.com Exchange, dados de conta e lógica de execução de ordens. Uma única chave unificada atende spot, margem e derivativos perpétuos; suporta marcação com `broker_id` para fluxos de reembolso de taxas (fee-rebate) e os endpoints do Advanced Order Management para ordens TP/SL e gatilho.
CCXT
Interface comum entre a Crypto.com Exchange e outras exchanges de criptomoedas. O CCXT classifica o conector `cryptocom` como certificado e de nível profissional (pro-tier), com suporte a spot, margem e swap. Considere o CCXT como uma camada de conveniência; os endpoints do Advanced Order Management pós-jan-2026 seguem o contrato nativo da Exchange v1.
FIX 4.4 (GEN 3.0)
Endpoint FIX institucional para mesas sensíveis à latência. Opera em paralelo com as interfaces REST e WebSocket; o acesso é restrito e depende de análise de conta institucional pela Crypto.com.
Cliente HTTP / WebSocket personalizado
Seu próprio motor de trading interno ou integração proprietária com a Crypto.com Exchange usando os endpoints públicos de REST e WebSocket.
Suporte de frameworks para produtos Crypto.com Exchange
A cobertura varia conforme o framework. A API nativa da Crypto.com Exchange v1 e o CCXT `cryptocom` abrangem spot, perpétuos e margem sob uma única chave unificada. O Freqtrade não possui suporte oficial para a Crypto.com Exchange e só acessa a plataforma via compatibilidade genérica do CCXT, apenas para spot. O conector `crypto_com` do Hummingbot foi marcado como desatualizado após a atualização da API GEN 3 e não consta na lista atual de exchanges do Hummingbot; para produção, prefira a v1 nativa ou o CCXT.
✓ suporte confirmado de acordo com os documentos oficiais do framework. "não" indica que não há suporte documentado oficialmente. "via CCXT" indica que o framework só acessa a Crypto.com por meio da compatibilidade genérica do CCXT. "conector desatualizado" indica um conector existente que não acompanhou as atualizações de API da plataforma. Os links de workflow 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 Crypto.com Exchange fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à Crypto.com Exchange é 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 à Crypto.com Exchange.
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 ou nosso starter nativo da Crypto.com Exchange) para ter uma base funcional.
- PASSO 03
Implante em um contêiner da TradingHost
Escolha uma região (EU ou US-East), insira as variáveis de ambiente que sua estratégia exige (chaves de API da Crypto.com Exchange, URLs base para produção ou UAT, etc.) e faça o deploy. O TradingHost cria seu container a partir do repositório e executa sua estratégia em uma infraestrutura gerenciada de Kubernetes. Sem necessidade de 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 Crypto.com Exchange
Detalhes práticos que podem causar problemas ao executar uma estratégia para a Crypto.com Exchange em um runtime de nuvem conteinerizado, e que não estão na documentação da Crypto.com nem nos READMEs de frameworks. Cada ponto abaixo foi citado ou parafraseado da própria documentação da Crypto.com; as orientações de implantação vêm da experiência de rodar essas estratégias no TradingHost.
01 · Migração de API
Lançamento da API Advanced Order Management (dezembro de 2025 a janeiro de 2026)
A Crypto.com migrou as ordens gatilho para `private/advanced/create-order` em 2025-12-17 08:00 UTC, e a criação e cancelamento de ordens Take Profit / Stop Loss seguiram em 2026-01-28 08:00 UTC. Códigos que antes acessavam `private/create-order` para TP/SL ou ordens gatilho devem migrar para o endpoint avançado e para a assinatura `user.advanced.order`. Estratégias que não foram atualizadas antes da transição perderam a funcionalidade de ordens condicionais.
02 · Distinção de plataforma
A API da Exchange não é a API do App
A Crypto.com opera duas plataformas distintas. A Crypto.com Exchange (web, crypto.com/exchange) expõe uma API pública, documentada e assinada via HMAC; o Crypto.com App (carteira de varejo) não possui uma API pública de negociação. Chaves de API geradas no App não funcionam na Exchange e vice-versa; este é o erro de integração mais comum de todos.
03 · Acesso a derivativos
Restrição geográfica e segmentação por entidade
Os derivativos são operados por afiliadas da Crypto.com com licenças separadas (Foris DAX MT Limited internacionalmente; Crypto.com Derivatives North America / CDNA nos EUA). Cerca de 110 jurisdições estão excluídas da plataforma internacional de derivativos, incluindo EUA, Reino Unido e Singapura. Chaves de API de Spot não concedem acesso automático à negociação de derivativos, mesmo para contas em regiões elegíveis.
04 · Limites de requisições
Cotas por método e por canal
As cotas de REST por método são rígidas: `private/create-order`, `private/cancel-order` e `private/cancel-all-orders` são limitadas a 15 requisições por 100 ms; `private/get-order-detail` a 30 por 100 ms; `private/get-trades` e `private/get-order-history` a 1 por segundo; todos os outros métodos privados a 3 por 100 ms. O REST público é de 100 rps por IP. WebSocket: 150 rps na User API, 100 rps em Market Data. Exceder o limite retorna `42901` (HTTP 429).
05 · Ciclo de vida do WebSocket
Heartbeat de 30s, warm-up de 1s
O servidor envia um heartbeat a cada 30 segundos; o cliente deve responder com `public/respond-heartbeat` usando o `id` correspondente em até 5 segundos, caso contrário a conexão é encerrada. A Crypto.com recomenda explicitamente aguardar 1 segundo entre a abertura do WebSocket e a primeira requisição para evitar limites de taxa na conexão. Códigos de encerramento a tratar: 1000 (normal), 1006 (anormal), 1013 (reinicialização do servidor, exige reconexão com backoff).
06 · Ambientes
O sandbox de UAT fica em um host separado
A produção acessa api.crypto.com e stream.crypto.com. O sandbox de UAT roda em uat-api.3ona.co and uat-stream.3ona.co e utiliza chaves de API separadas. As estratégias devem ler as URLs base a partir de variáveis de ambiente em vez de fixar api.crypto.com no código, caso contrário os testes em sandbox enviarão ordens silenciosamente para a produção.
07 · Erros de autenticação
Falhas de nonce, assinatura e IP
Três códigos de erro dominam os problemas de autenticação: `40101` (não autenticado, chave ou assinatura incorreta), `40102` (desvio de nonce superior a 60 segundos em relação ao horário do servidor) e `40103` (o IP da requisição não está na lista de permissões da chave). Executar um container em uma região cujo IP de saída difere do IP liberado é a causa mais comum de `40103` após um novo deploy.
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a Crypto.com Exchange são ideais para:
- Desenvolvedores criando estratégias em IDEs de IA (Cursor, Claude Code)
- Traders sistemáticos de cripto
- Desenvolvedores quant
- Usuários do CCXT
- 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 possui qualquer afiliação com a Crypto.com, Foris DAX Limited ou qualquer entidade do grupo Crypto.com.
Não. O código da sua estratégia se conecta à Crypto.com Exchange 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 roda.
Não. O acesso à API da Crypto.com Exchange é fornecido pela própria Crypto.com. Você é o responsável por sua conta na Crypto.com Exchange, permissões de API, credenciais e conformidade com os termos da Crypto.com.
Não. A 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 estratégias prontas. Com a TradingHost, você mesmo escreve ou gera a estratégia (geralmente usando Cursor ou Claude Code), mantém o código no seu GitHub e usa a TradingHost para executá-la em produção. Produtos como 3Commas, Cryptohopper e similares são donos da lógica da estratégia; a TradingHost apenas executa a sua própria estratégia.
A AWS e a DigitalOcean oferecem infraestrutura bruta. Você precisa gerenciar atualizações de sistema operacional, orquestração de containers, 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 via GitHub, controle via MCP a partir de IDEs de IA, além de painéis de logs e status integrados. 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, a TradingHost é o caminho mais curto.
Sim. A TradingHost executa estratégias em Python; basta escolher o ambiente de execução de framework compatível com sua stack ou implantar 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 Crypto.com sob o ID de exchange `cryptocom` e a lista como certificada e de nível profissional (pro-tier), com suporte a spot, margem e swap. Trate o CCXT como uma camada de conveniência; a semântica de limites de taxa e os endpoints de Advanced Order Management pós-janeiro de 2026 seguem o contrato nativo da Exchange v1. Consulte o ambiente de execução 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 ambiente de execução, ou separá-los em ambientes diferentes para maior isolamento e clareza operacional. A hierarquia de conta mestre e subcontas da Crypto.com Exchange se alinha perfeitamente a esse modelo: cada estratégia pode operar sua própria subconta sob uma única chave mestre. Consulte a página de ambientes de execução da TradingHost para entender o modelo multiestratégia.
O caminho mais rápido é fazer um fork de um ambiente de execução de framework da TradingHost, como o CCXT, para ter um projeto pronto para implantação, ou conectar 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 ambiente de execução 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 pelo seu próprio processo homologado de gerenciamento de segredos. A TradingHost não precisa da custódia da sua chave de API e segredo. Consulte a seção de segredos da plataforma para conhecer o modelo completo de tratamento.
Não. As estratégias nunca devem precisar de permissões de saque. A Crypto.com exige a liberação de IPs (IP whitelisting) em chaves com permissões de negociação ou saque; mantenha o escopo de saque desativado nas chaves da sua estratégia e gerencie saques separadamente.
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, analisar logs, reiniciar estratégias e gerenciar fluxos de trabalho do ambiente de execução. 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 todos os detalhes.
Ambos. A superfície 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 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 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.
O erro 40101 significa que a assinatura HMAC-SHA256, a chave ou a ordenação dos parâmetros assinados está incorreta; verifique novamente a string assinada `method + id + api_key + parameter_string + nonce` e a ordenação ascendente das chaves dos parâmetros. O erro 40102 significa que o seu nonce está com uma diferença de mais de 60 segundos em relação ao relógio do servidor da Crypto.com; sincronize o NTP. O erro 40103 significa que o IP da sua requisição não está na lista de permissões (whitelist) da chave de API; chaves de negociação e saque exigem uma whitelist de IP. Consulte a seção de Notas operacionais acima para obter as orientações completas.
A Crypto.com Exchange é a plataforma de negociação com a API v1 pública e documentada usada para trading algorítmico; é com ela que o TradingHost se integra. O Crypto.com App é a carteira de varejo e produto voltado ao consumidor; ele não publica uma API de negociação. As chaves de API são geradas na interface web da Exchange em User Center > API, e não no aplicativo móvel.
A criação e o cancelamento de ordens Take Profit e Stop Loss foram movidos de `private/create-order` para `private/advanced/create-order` em 2026-01-28 08:00 UTC, após a migração das ordens de gatilho (trigger orders) em 2025-12-17 08:00 UTC. As estratégias agora devem chamar o endpoint avançado para ordens condicionais e assinar o canal `user.advanced.order` para atualizações de status. Ordens simples de limite (limit) e a mercado (market) continuam em `private/create-order`.
Na plataforma internacional, a chave de API unificada da Exchange v1 pode operar spot, margem e perpétuos com uma única credencial, mas a permissão de derivativos subjacente está vinculada à conta, não à chave. Os derivativos devem estar habilitados na conta, e a conta deve estar em uma jurisdição não excluída. Nos EUA, os derivativos rodam em uma afiliada licenciada separadamente (CDNA) com seu próprio processo de integração.
O Freqtrade pode acessar a Crypto.com via CCXT, mas não é oficialmente suportado pela equipe do Freqtrade. O conector `crypto_com` do Hummingbot está marcado como desatualizado desde a atualização da API GEN 3 e não consta na lista atual de exchanges do Hummingbot; trate-o como não suportado e use CCXT ou a v1 nativa diretamente.
O TradingHost opera nas regiões EU e US-East. Escolha a região mais próxima do matching engine 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 implantação. O backtesting pertence à sua pilha de pesquisa, framework ou AlgoBuilder.