(1) Razão por contas via ccy, agregando futuros com vencimento e perpétuos; (2) razão por contas de um instId; (3) razão Top Trader por contas de um instId; e (4) razão Top Trader por posições desse instId. Top Trader são os 5% de contas com maior valor de posição aberta. Esse grupo de APIs não oferece razão por posições da corretora inteira.
A série por moeda agrega futuros com vencimento e perpétuos; as outras três usam um contrato específico. As duas Top Trader ainda limitam a amostra aos 5% com maior valor de posição aberta. Escopo, amostra e denominador diferentes geram leituras diferentes; as razões sozinhas não provam compra ou venda incremental.
Registre endpoint, ccy ou instId, período e horário da amostra e compare séries de mesmo escopo. Acima de 1 só quer dizer que o numerador supera o denominador naquela amostra; 2,5 e 0,5 não são gatilhos oficiais da OKX.
Não pela definição da OKX. A série conta contas net long e net short, mas não rotula essa população como varejo. Portanto ela não sustenta, sozinha, uma leitura contrária de varejo.
Ela descreve o valor long versus short nos 5% de contas com maior posição aberta de um contrato. Serve para observar essa amostra, não para prever direção. O ranking não filtra taxa de acerto.
Primeiro confirme que as duas séries usam o mesmo instId. Se a razão Top Trader por contas está acima de 1 e a razão por posições abaixo de 1, há mais contas net long na amostra, mas o valor das posições short é maior. Isso não revela quem abriu ou fechou posição nem prevê o próximo movimento.
Salve endpoint, parâmetros, resposta bruta e horário; registre preço, volume, funding e open interest separadamente. Teste depois num horizonte definido antes. LSR descreve uma distribuição e não vira ordem de entrada, saída ou ajuste de stop.
A OKX entrega quatro feeds de long/short, não um
A OKX publica quatro feeds relacionados, mas eles não compartilham o mesmo escopo. Leia o parâmetro e a amostra junto com o valor.
Razão por contas de uma moeda. Consultada via ccy, conta contas net long contra net short em futuros com vencimento e perpétuos dessa moeda.
Razão por contas de um contrato. Consultada via instId, conta contas net long contra net short em um único contrato, como BTC-USDT-SWAP.
Top Trader por contas. Também específica por contrato, mas restrita aos 5% de contas com maior valor de posição aberta.
Top Trader por posições. Para o mesmo contrato e a mesma amostra, divide o valor das posições long pelo das short. É a única razão ponderada por posição nesses quatro endpoints.
O schema completo tá na documentação de API da OKX sob o namespace Rubik (dados). Em português, a melhor ponte introdutória é o Cointelegraph Brasil em matérias sobre posicionamento de derivativos.
A razão por contas conta cabeças, a razão por posições conta dólares
Razão por contas compara quantidades de contas. A razão Top Trader por posições compara valor long e short dentro da amostra dos 5% maiores de um contrato.
Para comparar contas e posições, use as duas séries Top Trader do mesmo instId. Contas acima de 1 e posições abaixo de 1 significam mais contas net long, mas maior valor short; isso não mostra quem acabou de comprar, vender ou fechar.
O que o filtro Top Trader seleciona e o que não mostra
As razões por contas sem filtro Top Trader contam contas, mas a OKX não classifica essa população como "varejo". Leia como distribuição de contas, não como amostra de varejo comprovada.
Os feeds de Top Trader guardam só as contas nos 5% de maior valor de posição aberta. O que sai dali é uma visão de onde estão os maiores livros — o que vale saber, mas vale também ser preciso sobre o que isso não é. Tamanho não é acerto. Não existe filtro de taxa de acerto em lugar nenhum desse corte: uma conta que abriu uma posição grande dez minutos atrás e uma que carrega a dela há três meses são a mesma linha naquela lista.
O tamanho da amostra não prova que as linhas Top Trader reajam mais rápido nem que a razão por contas seja mais lenta. Sobre qual linha seria "mais certeira": a OKX não publicou estudo desse tipo, e qualquer lead time alegado precisa de dados reproduzíveis.
Pro enquadramento contrário, o verbete da Investopedia sobre investimento contrário explica a ideia geral. Um LSR extremo mostra distribuição desigual; não mede fluxo marginal nem prova que compradores ou vendedores acabaram.
Como ler um valor alto ou baixo sem inventar causalidade
Compare cada série com o próprio histórico arquivado. Acima de 1 significa apenas que o numerador supera o denominador naquele endpoint; abaixo de 1 é o inverso. Faixas como 0,7-1,5 e extremos como 2,5 ou 0,4 são convenções informais, não definições da OKX nem resultados de um estudo publicado aqui.
Uma razão extrema só mostra que a distribuição medida está desigual. Ela não mede fluxo novo nem torna uma reversão inevitável. Qualquer afirmação sobre o que vem depois exige um estudo reproduzível com o mesmo endpoint e os mesmos parâmetros.
Risco de posição é outra conta. Num exemplo puramente hipotético, compre Q=0,05 BTC a 70.000 USDT e marque a 63.000. Sem taxas e funding, o PnL bruto é Q × (63.000 − 70.000) = −350 USDT.
Se metade for fechada enquanto o preço ainda está em 70.000, a parte fechada realiza zero e os Q=0,025 BTC restantes perdem 175 USDT no mesmo caminho. Isso só mostra que o PnL linear cai junto com a quantidade; não usa LSR para prever preço nem provar que reduzir era a decisão certa.
Liquidação exige modo de margem, margem mantida, taxa de manutenção e custos. Se quantidade e margem caem pela metade juntas, a margem por unidade não muda. Alterar a alavancagem na tela também não substitui reduzir quantidade ou adicionar margem.
Puxando a LSR da API da OKX pra sua máquina
Os endpoints são públicos, sem API key. A série por moeda usa ccy; as séries por contrato e Top Trader usam instId.
Razão por contas da moeda (futuros com vencimento + perpétuos): GET /api/v5/rubik/stat/contracts/long-short-account-ratio?ccy=BTC&period=5m
Razão por contas de um contrato: GET /api/v5/rubik/stat/contracts/long-short-account-ratio-contract?instId=BTC-USDT-SWAP
Razão Top Trader por contas: GET /api/v5/rubik/stat/contracts/long-short-account-ratio-contract-top-trader?instId=BTC-USDT-SWAP
Razão Top Trader por posições: GET /api/v5/rubik/stat/contracts/long-short-position-ratio-contract-top-trader?instId=BTC-USDT-SWAP
A série por moeda aceita 5m / 1H / 1D com janelas de 2 / 30 / 180 dias e limite de 5 requisições por 2 segundos por IP. Cada endpoint de contrato permite recuperar os 1.440 registros mais recentes, mas limit é 100 por padrão e no máximo; o limite é 5 requisições por 2 segundos por IP + instId. Dados Top Trader começam em 22/03/2024.
O que volta é um array bidimensional no formato [[timestamp, longShortRatio], ...]. Qual ponta tem a linha mais nova é coisa pra conferir imprimindo os timestamps uma vez, não pra supor. E note que a OKX não documenta intervalo de atualização dessas estatísticas — então não crave "tem valor novo a cada 5 minutos" dentro do seu loop de polling.
Ou abra nosso painel de razão long/short, com três séries para BTC e ETH fornecidas pela OKX por meio do proxy do site.
Como verificar uma afirmação histórica sobre LSR
Não temos as respostas brutas necessárias para confirmar a história de mercado que antes aparecia aqui. Por isso retiramos datas, preços, trajetórias e a afirmação de que um grupo acertou. Lembrança de painel não é evidência.
Um teste histórico defensável precisa de endpoint completo, ccy/instId, período, paginação, horário UTC, resposta sem edição e dados contemporâneos de preço, volume, funding e OI. A regra de avaliação deve ser definida antes de olhar o resultado.
Quando amostras divergem, confira o escopo
Imagine razão por contas da moeda em 1,9 e razão Top Trader por posições de um contrato em 0,6. A primeira conta contas em futuros com vencimento e perpétuos; a segunda compara valor de posição numa amostra Top Trader de um contrato. População, parâmetro e unidade são diferentes.
Alinhe horário e instrumento e identifique se cada série conta contas ou valor. Não deduza aumento, redução, dinheiro novo, direção ou prazo a partir da razão. Ela pode ficar estável com os dois lados dobrando, e pode subir por várias combinações do numerador e denominador.
Como montar um diário de LSR reproduzível
Salve endpoint, parâmetros, valor bruto e horário UTC; registre preço, volume, funding e OI como variáveis separadas. Defina hipótese, horizonte, custos e regra para dados ausentes antes de olhar resultados. Indicadores na mesma direção não viram automaticamente um sinal de trade.