Diário de trade para OKX
O FOQUS mantém sozinho um diário de trade da sua conta na OKX. Cada posição em swaps perpétuos de USDT e USDC entra sem digitação manual, com taxas, funding e histórico de stops. Para conectar, você precisa de uma chave só com a permissão Read, da chave secreta e da passphrase dela. O diário é grátis para sempre.
O que o FOQUS registra da OKX
O FOQUS registra os swaps perpétuos da OKX com margem em USDT e USDC, como BTC-USDT-SWAP e BTC-USDC-SWAP.
Enquanto a posição está aberta, ela aparece no FOQUS com o lucro, o stop e o tempo na operação se atualizando em tempo real. Cada aumento de posição e cada saída parcial são registrados como ações próprias, com preço, tamanho e taxa. O FOQUS marca quando você definiu, removeu ou moveu o stop loss e o take profit. O funding entra na operação a cada pagamento.
Quando a posição fecha, ela tem um resultado com taxas e funding, e uma liquidação aparece como um evento próprio. Ao lado ficam as suas ordens limitadas de entrada: quais você enviou, alterou e cancelou.
Em torno das suas execuções, o FOQUS guarda o contexto: o seu saldo e as outras posições na entrada, e um retrato do mercado (variação de preço e volume, RSI, funding, contratos em aberto). Ele também grava o próprio livro de ofertas da OKX, um minuto antes e um minuto depois de cada entrada, aumento, saída parcial e saída. O plano gratuito inclui 10 gravações dessas por dia.
Ficam de fora: spot e margem, futuros com vencimento, opções e swaps com margem em moeda, como BTC-USD-SWAP. Também ficam de fora as posições abertas antes da conexão: o histórico da conta na OKX não tem livro de ofertas, e a OKX guarda uma ordem comum cancelada sem execução por apenas 2 horas. Por isso o FOQUS registra cada operação por conta própria, a partir do minuto da conexão.
Quais sites da OKX funcionam
A OKX tem três sites separados, cada um com o seu endereço de API, e uma chave só funciona pelo endereço do próprio site. O FOQUS conecta contas dos três:
| Onde você se cadastrou | O endereço de API que o FOQUS lê |
|---|---|
| okx.com | openapi.okx.com |
| my.okx.com (Espaço Econômico Europeu) | eea.okx.com |
| app.okx.com (Estados Unidos e Austrália) | us.okx.com |
O FOQUS descobre o site sozinho: ele testa primeiro openapi.okx.com, depois eea.okx.com, depois us.okx.com, e guarda o endereço que reconheceu a chave. Se nenhum reconhecer, nada é salvo, e a tela de conexão mostra “OKX doesn’t know this key. Check the API key.” (a OKX não conhece esta chave; confira a chave de API).
Como criar uma chave de API da OKX somente leitura
- Entre no site da OKX onde você se cadastrou. Abra o perfil → API and connections → Create API key. No app: Menu (⋮⋮⋮) → API → Create API key.
- Dê um nome à chave, por exemplo FOQUS. Escolha a conta em que você opera, a principal ou uma subconta, e para que a chave será usada.
- Deixe vazia a lista de endereços IP permitidos: o FOQUS não publica endereços.
- Em Permissions, mantenha só Read. Não ative Trade nem Withdraw, nem Transfer, Loan ou Earn, se aparecerem.
- Crie uma Passphrase (frase-senha) para a chave e anote. A OKX não consegue recuperá-la: se você esquecer, vai precisar criar uma chave nova.
- Confirme e guarde a API key e a Secret key.
- Crie uma conta no FOQUS, escolha OKX e preencha três campos: API key, API secret e Passphrase. Clique em Connect exchange.
Os nomes dos itens do menu dependem da versão do site da OKX e da região. Em algumas regiões, a OKX só deixa criar uma chave se a conta tiver pelo menos 100 USD em ativos. Os campos e os botões do FOQUS estão como aparecem na versão em inglês do app.
A OKX exclui uma chave sem vínculo de IP que tenha Trade ou Withdraw depois de 14 dias sem uso. Essa regra não afeta uma chave para o FOQUS, que não tem essas permissões. A OKX descreve as outras regras de expiração no seu próprio API FAQ, em “Will the API key expire?”. Se um dia a OKX desativar a chave, a conta no FOQUS mostra “The venue refused this key — the account is not updating” (a plataforma recusou esta chave e a conta não está sendo atualizada) e espera uma nova.
O guia da chave de API somente leitura coloca a chave da OKX ao lado das chaves da Binance e da Bybit.
É seguro dar ao FOQUS uma chave da OKX?
- As permissões vêm da própria OKX. Na conexão, o FOQUS busca a configuração da chave, onde a OKX lista as permissões dela como read_only, trade ou withdraw. Qualquer coisa além de read_only significa “The key is not read-only” (a chave não é somente leitura), e a chave é descartada.
- Nada além de leituras. O FOQUS envia à OKX apenas requisições de leitura. Ele não consegue enviar nem cancelar uma ordem, mover fundos entre contas ou fazer saques.
- Guardadas criptografadas: a chave secreta e a passphrase. A chave de API e o endereço do site da OKX da chave ficam guardados como estão.
- Para desconectar: exclua a conta no FOQUS, e as operações dela vão junto. Depois remova a chave em perfil → API, na OKX.
O diário reúne as operações de uma conta em uma tabela, em cards com gráfico ou em um relatório semanal, mensal e anual. A partir daí, o MAE e o MFE mostram quanto de cada movimento você aproveitou, e a calculadora de tamanho de posição planeja a próxima entrada pelo stop. Um registro feito à mão também serve: a planilha de diário de trade é grátis. Também se conectam: Binance, Bybit, MetaTrader 5.
Perguntas frequentes sobre o diário da OKX
Onde consigo a passphrase da OKX?
Você mesmo a cria quando gera a chave. Ela não é a senha da sua conta na OKX. Não dá para vê-la depois: se você a perdeu, exclua a chave e crie uma nova.
Por que o FOQUS diz “Incorrect OKX passphrase”?
A OKX reconheceu a chave, mas não aceitou a passphrase. Você precisa da passphrase que definiu ao criar esta chave específica: cada chave tem a sua. Confira o layout do teclado e as letras maiúsculas e minúsculas.
Uma conta da OKX da Europa, dos EUA ou da Austrália funciona?
Sim. O FOQUS descobre em qual site a chave foi criada, okx.com, my.okx.com ou app.okx.com, e lê as suas operações pelo endereço desse site.
O meu histórico antigo da OKX será importado?
Não, e isso é proposital: um histórico antigo tem pouca informação para revisar uma operação. Ele não tem livro de ofertas, e a OKX guarda uma ordem comum cancelada sem execução por apenas 2 horas. Por isso o FOQUS registra cada operação por conta própria desde o minuto da conexão. As posições abertas antes disso ficam de fora mesmo quando fecham depois, porque o FOQUS nunca viu os stops delas nem a conta na entrada.
Posso conectar uma subconta da OKX?
Sim. Crie a chave dentro da subconta, com as permissões e a passphrase dela. Não misture a chave e a passphrase da conta principal com as da subconta. O FOQUS vai registrar as operações dessa subconta.
Fontes
- OKX: API FAQ — os passos para criar uma chave no site e no app; a Passphrase não pode ser vista nem recuperada; as permissões Transfer, Loan e Earn; a condição de 100 USD em algumas regiões; chaves de subconta; expiração das chaves. Atualizado em 28 de setembro de 2026.
- OKX API: Order history (last 7 days) — uma ordem comum cancelada sem execução fica guardada por 2 horas.
- OKX API: Order book — a requisição do livro de ofertas recebe um instrumento e uma profundidade, nunca um horário, e devolve o livro atual.
- OKX API v5 — as permissões Read, Trade e Withdraw; até 20 endereços IP por chave; uma chave sem vínculo de IP que tenha trade ou withdraw expira depois de 14 dias sem uso; os endereços de API da my.okx.com e da app.okx.com; o campo perm que o FOQUS verifica.