Runtime nativo de IA para estratégias de trading na OKX
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
- OKX
- Tipo de plataforma
- Exchange de criptomoedas
- Classe de ativos
- Cripto
- Produtos suportados
- Spot, swaps perpétuos, contratos futuros com vencimento, opções (BTC e ETH), margem, Simple Earn (flexível e fixo). Os futuros com vencimento de BTC/ETH com margem em USDT serão descontinuados até 26 de junho de 2026, após o qual os futuros com vencimento com margem em USD continuarão.
- Modelo de runtime
- Runtime de estratégia em containers
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem executável em container
- Integrações comuns
- REST e WebSocket nativos da OKX v5, CCXT (okx), Hummingbot (okx, okx_perpetual), Freqtrade (spot e futuros, com ressalvas), personalizado
- 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 OKX
- 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 OKX
Seção 02 · O que OKX oferece
O que OKX oferece
A OKX oferece spot, swaps perpétuos, futuros com vencimento, opções de BTC e ETH, e trading de margem por meio de uma Unified Account que suporta os modos multi-currency margin e portfolio margin. A API v5 expõe REST e três URLs de WebSocket (Public, Private, Business), além de um ambiente de demonstração que utiliza os hostnames de produção com o cabeçalho `x-simulated-trading: 1`, em vez de um host de testnet separado. As especificidades dos endpoints mudam com o tempo. A estrutura geral é durável; os pesos exatos de limites de requisição, faixas de taxas e listas de símbolos estão disponíveis na documentação da OKX.
Mercados e padrões de estratégia
- Swaps perpétuos, com margem em USDT e em moedas (coin-margined)
- Estratégias de opções em BTC e ETH (covered calls, spreads, operações de vencimento)
- Modo portfolio margin (margem baseada em risco entre produtos)
- Modo multi-currency margin (múltiplos ativos como margem compartilhada em valor de USD)
- Unified Account abrangendo spot, margem, perpétuos, futuros e opções
- Hierarquia de subcontas sob uma conta master
- Trading simulado via chaves de API de demonstração com o cabeçalho x-simulated-trading: 1
- Migração de demo para produção (chaves de demonstração separadas, depois alteração para chaves reais sem reescrever o código)
Superfície da API
- Superfícies de produtos
- Spot, swaps perpétuos, futuros com vencimento, opções (BTC, ETH), margem, além de um ambiente de demonstração (trading simulado) que espelha os mesmos endpoints. Não há um host testnet.okx.com separado: a demonstração utiliza os hostnames de produção com x-simulated-trading: 1 configurado em cada requisição e uma chave de API de demonstração criada no painel de trading simulado.
- Métodos de conexão
- REST v5, WebSocket Public (wss://ws.okx.com:8443/ws/v5/public), WebSocket Private (wss://ws.okx.com:8443/ws/v5/private), WebSocket Business (wss://ws.okx.com:8443/ws/v5/business). As ordens podem ser enviadas, alteradas e canceladas via WebSocket, além de REST.
- Autenticação
- Assinatura HMAC-SHA256, chave de API, segredo e frase secreta (credencial de 3 partes). Cabeçalhos: OK-ACCESS-KEY, OK-ACCESS-SIGN, OK-ACCESS-TIMESTAMP (ISO 8601 UTC, ms), OK-ACCESS-PASSPHRASE. Até 20 IPs permitidos por chave de API na lista de permissões. O trading simulado utiliza chaves de demonstração separadas e o cabeçalho x-simulated-trading: 1.
Para detalhes específicos, consulte OKX
Endpoints específicos, pesos de limites de requisição, listas de símbolos, faixas de taxas e histórico de versões estão disponíveis na documentação da OKX. Considere-os como a fonte única de verdade.
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para OKX 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 OKX v5
Controle direto sobre o comportamento específico da OKX, estado da Unified Account, roteamento de subcontas e lógica de execução de ordens.
Freqtrade ou Hummingbot
Deploys baseados em frameworks utilizando a estrutura de estratégia e o modelo de configuração de cada um.
Conector personalizado
Seu próprio motor de trading interno ou integração proprietária com a OKX.
Suporte de frameworks para produtos OKX
A cobertura varia de acordo com o framework. O CCXT abrange a maior parte da superfície da OKX; o Freqtrade e o Hummingbot cobrem spot e perpétuos (o Freqtrade também cobre futuros com vencimento); o acesso à API nativa OKX v5 cobre tudo o que a OKX oferece, incluindo opções de BTC e ETH.
✓ suporte confirmado de acordo com os documentos oficiais do framework. "parcial" indica cobertura limitada ou apenas para dados de mercado. "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 OKX fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à OKX é 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 à OKX.
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 (chave de API, segredo e frase secreta da OKX, a credencial de 3 partes) 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. 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 OKX
Problemas práticos que surgem ao executar uma estratégia da OKX em um runtime de nuvem em containers, que não estão na documentação da OKX nem nos READMEs dos frameworks. Cada afirmação abaixo é citada ou parafraseada da própria documentação da OKX; as orientações de deploy são baseadas na execução dessas estratégias na TradingHost.
01 · Versão da API
A OKX está na v5; a v3 foi descontinuada em 2022, sem v4
A OKX pulou a v4 (devido à conotação do número 4) e foi diretamente da v3 para a v5. A API v3 foi descontinuada em 5 de janeiro de 2022, após a conclusão da maior parte da migração para a Unified Account. Não há suporte legado para a v3 hoje: todas as integrações devem utilizar os endpoints da v5.
02 · Trading simulado (demo)
A demonstração é uma flag de cabeçalho com chaves separadas, não um host separado
A OKX não opera um host testnet.okx.com separado. O trading de demonstração (demo) utiliza os hostnames de produção com o cabeçalho x-simulated-trading: 1 configurado em cada requisição, além de uma chave de API demo criada no painel de trading de demonstração. Chaves de produção não autenticam no ambiente demo, e chaves demo falham silenciosamente sem o cabeçalho.
03 · Autenticação
Credencial em três partes e timestamp assinado
A OKX exige chave de API, segredo e passphrase (a passphrase é definida na criação da chave, não sendo a senha da conta). As requisições assinam timestamp + método + requestPath + corpo com HMAC-SHA256 base64 e enviam o resultado em OK-ACCESS-SIGN. O código 50111 indica chave inválida e o 50113 indica assinatura inválida, ambos comuns quando a passphrase está ausente ou há desvio no timestamp.
04 · WebSockets
Três URLs de WebSocket, não apenas uma
A OKX divide o tráfego de WebSocket entre Público (dados de mercado, sem autenticação), Privado (conta, execuções, posições, ordens, exige login autenticado) e Business (algoritmos, grid e canais especializados). Uma estratégia que assina um canal exclusivo do Business na URL Pública não recebe nada e parece "silenciosa". O mapeamento de canais para URLs muda ocasionalmente; verifique as notas de migração antes de adicionar assinaturas.
05 · Modo de conta
O modo portfolio margin é opcional e altera o cálculo da margem
A Unified Account possui múltiplos modos (cash, single-currency margin, multi-currency margin, portfolio margin). O modo multi-currency utiliza ativos convertidos para USD como margem compartilhada. O portfolio margin aplica um modelo baseado em risco em spot, margem, perpétuos, futuros e opções para maior eficiência de capital. A OKX descontinuou posições de margem isolada nos modos multi-currency e portfolio margin, portanto, lógicas de dimensionamento de posição escritas para o modo isolado não são aplicáveis.
06 · Acesso nos EUA
A OKX global bloqueia o varejo dos EUA; a OKX US é uma plataforma separada
Em fevereiro de 2025, o DOJ anunciou que a entidade afiliada da OKX, Aux Cayes FinTech Co. Ltd., declarou-se culpada por operar uma empresa de transmissão de dinheiro não licenciada e aceitou penalidades totalizando cerca de US$ 505 milhões (perda de US$ 420,3 milhões e multa de US$ 84,4 milhões). A OKX global restringe pessoas dos EUA por política interna desde 2017; essa restrição continua em okx.com. Posteriormente, a OKX relançou uma entidade separada para os EUA em okx.com/en-us em 2025 (disponível em 41 estados; KY, NY, TX e alguns territórios foram excluídos no lançamento). As estratégias devem apontar para o endpoint da OKX correspondente à entidade licenciada da conta.
07 · Lista de permissões de IP
Chaves de API sem lista de permissões de IP representam riscos de segurança
A OKX suporta até 20 IPs por chave na lista de permissões e recomenda fortemente vincular as chaves a IPs específicos. Sem esse vínculo, uma chave vazada pode ser usada de qualquer lugar. Para ambientes de execução em contêineres, use o IP de saída estático da região da estratégia e adicione-o à lista de permissões da chave; rotacione a passphrase e o segredo em caso de qualquer suspeita de exposição (a passphrase não pode ser recuperada).
FonteOKX API FAQ
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a OKX 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 OKX.
Não. O código da sua estratégia se conecta à OKX e envia instruções de acordo com sua própria lógica, permissões da 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 OKX é fornecido pela própria OKX. Você é responsável por sua conta na OKX, permissões de API, credenciais e conformidade com os termos da OKX.
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ê escreve ou gera a estratégia por conta própria (geralmente com 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ê 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 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 deseja 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 ambiente de execução 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.
O CCXT expõe a OKX (okx, antiga okex) para trading de spot e perpetual swaps, bem como para dados de conta, mercado e históricos. Futuros também são suportados. Dados de mercado de opções estão acessíveis por meio da simbologia da OKX, mas a execução de ordens de opções pelos métodos unificados do CCXT é limitada; direcione ordens de opções através do cliente nativo OKX v5. O objeto de exchange da OKX exige apiKey, secret e password (a passphrase), além dos cabeçalhos padrão de subconta. Consulte o ambiente de execução do framework CCXT para ver o guia 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 ambiente de execução, ou separá-los em diferentes ambientes para isolamento e clareza operacional. Consulte a página de ambientes de execução da TradingHost para conhecer o modelo multiestratégia.
O caminho mais rápido é fazer um fork de um ambiente de execução 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 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 aprovado de gerenciamento de segredos. A TradingHost não precisa da custódia de sua chave de API, segredo ou passphrase. 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. Use permissões com escopo limitado (leitura, negociação) e vincule a chave ao IP de saída do seu ambiente de execução usando a lista de permissões de IP da OKX (até 20 IPs por chave).
A OKX utiliza uma credencial em três partes: chave de API, segredo e passphrase. A passphrase é uma string definida pelo usuário no momento da criação da chave de API, enviada em cada requisição autenticada via OK-ACCESS-PASSPHRASE e integrada à assinatura HMAC-SHA256 junto com o segredo. A OKX não pode recuperar a passphrase caso ela seja perdida; você precisará gerar a chave novamente. Trate-a como mais um segredo.
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 do ambiente 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 do 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 fluxo de implantação nativo do GitHub também funciona sem nenhuma ferramenta de IA: um simples git push para a sua branch principal dispara uma nova implantação.
O runtime detecta o crash e expõe os logs relevantes e informações de integridade. 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.
O erro 50111 significa que a OKX não conseguiu encontrar a chave de API (chave incorreta, ambiente incorreto ou chave de demonstração usada em ambiente de produção). O erro 50113 significa que a assinatura não foi validada. Causas comuns: passphrase incorreta ou ausente, secret incorreto, dessincronização do relógio em OK-ACCESS-TIMESTAMP (deve ser ISO 8601 UTC com precisão de milissegundos), ordem incorreta da string pré-hash (timestamp + method + requestPath + body) ou ausência do cabeçalho x-simulated-trading: 1 ao usar uma chave de demonstração. Execute a sincronização NTP no container e registre a string pré-hash em builds que não sejam de produção.
Sim. Crie uma chave de API demo no painel de negociação simulada da OKX e adicione x-simulated-trading: 1 a todos os cabeçalhos REST e WebSocket. O host permanece o mesmo. Chaves demo não podem operar em produção, chaves de produção não podem operar em demo, e o cabeçalho é obrigatório em todas as chamadas; altere ambos simultaneamente ao migrar para produção.
O modo de conta é definido no nível da Unified Account e afeta os cálculos de margem. O modo multi-currency trata ativos convertidos para USD como margem compartilhada. O portfolio margin aplica um modelo baseado em risco, compensando a exposição líquida entre spot, margem, perpétuos, futuros e opções. Posições de margem isolada não são mais suportadas nos modos multi-currency ou portfolio.
A OKX global (okx.com) restringe pessoas dos EUA sob uma política de 2017. Em fevereiro de 2025, a Aux Cayes FinTech Co. Ltd. (afiliada da OKX) declarou-se culpada por operar um negócio de transmissão de dinheiro não licenciado nos EUA e pagou US$ 505 milhões. Uma entidade separada para os EUA (okx.com/en-us) foi relançada em 2025 em 41 estados norte-americanos. A OKX US e a OKX global são plataformas diferentes; confirme a qual entidade sua conta pertence antes de realizar a implantação.
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. A TradingHost é focada em ambiente de execução (runtime) de produção e implantação. O backtesting deve ser feito em sua própria estrutura de pesquisa, framework ou AlgoBuilder.