Como negocio derivados com o Jupyter Notebook?

Publicado a 28/09/2023Atualizado a 4/04/2024Leitura de 11 minutos45

Descubra como fazer negociações simples de derivados com as mesmas ferramentas. Vamos usar os recursos completos disponíveis em python-okx num nível mais alto!

Tipos de Derivados

Existem três tipos de derivados disponíveis para negociar na OKX:

  1. Futuros
  2. Swaps perpétuos
  3. Opções

Aceda a Derivados do Bitcoin explicados: futuros, swaps perpétuos e opções para saber as caraterísticas dos diferentes tipos de derivados na OKX. Neste tutorial, vamos usar Swaps perpétuos como exemplo.

Perguntas frequentes

1. Como posso obter os dados do mercado em Obter dados de mercado?

Também pode substituir o instType por FUTUROS ou OPÇÕES para obter informações.
CT-web-derivativestrading-howtoapi-1

2. Como posso obter os pares de negociação disponíveis em Obter instrumentos?

Da mesma forma, escolha o instType para o qual deseja obter informações.
CT-web-derivativestrading-howtoapi-2 2.1 Calcule o valor nocional de um contrato de derivados com o parâmetro do instrumento ctVal e ctMult
Para calcular o valor nocional de um contrato de derivados (isto é, futuros, swaps perpétuos e opções), precisa do ctVal (valor do contrato) e do ctMult (multiplicador do contrato) dos parâmetros do instrumento.
O valor nocional de um contrato de derivados pode ser calculado como
O valor nocional de um contrato de derivados pode ser calculado como ctVal x ctMult (unidade: ctValCcy);
Por exemplo, a partir dos parâmetros do instrumento mostrados abaixo, podemos calcular o valor nocional de um contrato perpétuo de LTC-USD como: ctVal x ctMult (unidade: ctValccy) = 10 x 1 USD = 10 USD
CT-web-derivativestrading-howtoapi-3

3. Como verifico o saldo em Obter saldo?

CT-web-derivativestrading-howtoapi-4

4. O que é um modo de conta e um modo de margem/negociação que se qualifica para negociar derivados?

Como mencionado no último tutorial, na conta de negociação unificada, há quatro modos de conta:

  • Conta simples
  • Conta de margem de moeda única
  • Conta de margem multimoedas
  • Conta de margem de portfólio
    Observe que apenas os últimos três modos de margem, a saber, Margem de moeda única, Margem multimoedas e Margem de portfólio, se qualificam para negociação de derivados.
    Aceda a como configurar o modo de conta para entender as diferenças entre os quatro modos e como alternar entre os mesmos através da nossa interface de utilizador da Web.

4.1 Obtenha a configuração atual da conta a partir do parâmetro acctLv em Obter configuração da conta
Verifique se está no modo de conta correto para negociar derivados.
CT-web-derivativestrading-howtoapi-5

5. Como defino a alavancagem em Definir alavancagem da conta?

Um parâmetro importante que precisamos de definir quando negociamos derivados é a alavancagem.
A alavancagem permite que os negociadores insiram uma posição que vale muito mais ao comprometer apenas um pequeno montante de dinheiro. Assim, os ganhos ou perdas são consideravelmente potencializados.
Os negociadores podem ter uma alavancagem de até 125x ao negociar derivados na OKX. Leia as referências sobre como definir a alavancagem para diferentes níveis de alavancagem permitidos em diferentes níveis de posições.
CT-web-spottrading-howtoapi-6 Veja o que os glossários exibidos acima significam:

  • Alavancagem máxima: o múltiplo máximo de vezes do capital emprestado para aumentar o retorno potencial de um investimento.
  • Índice de margem inicial (IMR): a margem necessária para manter posições atuais.
  • Índice de margem de manutenção (MMR): a margem mínima necessária para manter as posições atuais. Ocorrerá liquidação se o patrimônio da conta ficar abaixo da margem de manutenção.
    Por exemplo, se quiser negociar 3000 contratos perpétuos de ETHUSDT, pode alavancar no máximo 75 vezes o capital que possui. IMR = 1 / 75 = 1,3%, e deve manter 0,8% ou mais de MMR para evitar a liquidação.
    Consulte as Regras de negociação com margem da OKX, secções 6.2 Alavancagem e 6.3 Índice de margem e liquidação forçada, para entender mais sobre alavancagem, requisitos de margem e regras de liquidação.

Há 9 cenários diferentes para definições de alavancagem com as APIs abertas da OKX. Aceda a Definir cenários de alavancagem para os diferentes casos.
Para swaps perpétuos, há três cenários diferentes para a definição de alavancagem:

  • Definir alavancagem para instrumentos SWAP em modo de negociação de Margem cruzada a nível do contrato.
  • Definir alavancagem para instrumentos SWAP em modo de negociação de Margem isolada e modo de posição Comprar/Vender a nível do contrato.
  • Definir alavancagem para instrumentos SWAP em modo de negociação de Margem isolada e modo de posição Long/Short__ a nível do contrato e do lado da posição.
    O exemplo a seguir mostra como definir a alavancagem e o lado da posição de um único contrato de SWAP, em comparação com todos os contratos de SWAP de um determinado subjacente.
    CT-web-derivativestrading-howtoapi-7 Observe que o parâmetro de solicitação posSide só é necessário no modo de margem isolada e modo de posição long/short (envio de ordem) para instrumentos FUTUROS/SWAP (consulte os cenários 6 e 9 em Definir cenários de alavancagem).

6. Como posso criar ordens nos diferentes modos de posição (envio de ordens): long/short e comprar/vender?

Existem dois modos de posição (envio de ordens) ao negociar FUTUROS e SWAPS perpétuos: long/short e comprar/vender (líquido).
Pode alterar o modo de posição (envio de ordens) entre long/short e comprar/vender (líquido) por meio da API Definir modo de posição:
CT-web-derivativestrading-howtoapi-8 Ou em alternativa, pode fazê-lo em Definições na web abaixo:
Ct-web-derivativestrading-howtoapi-9 No modo comprar/vender (líquido), a posição de um determinado contrato é a quantidade líquida das suas negociações de compra e venda. Quando envia ordens em Enviar ordem, o parâmetro de solicitação posSide não é obrigatório. Se passar, o único valor válido será net.
No modo long/short, as posições compradas e vendidas de um determinado contrato serão independentes entre si e precisarão de ser fechadas separadamente. Quando envia ordens em Enviar ordem, o parâmetro de solicitação posSide é obrigatório. Os valores válidos são long ou short. Abaixo mostramos como definir os parâmetros side (lado da negociação) e posSide (lado da posição) quando envia uma ordem em diferentes cenários:

  • Envie uma ordem de compra e abra/aumente uma posição comprada: side = comprar, PosSide = long
  • Envie uma ordem de venda e abra/aumente uma posição vendida: side = vender, PosSide = short
  • Envie uma ordem de venda e feche/reduza uma posição comprada: side = vender, PosSide = long
  • Envie uma ordem de compra e feche/reduza uma posição vendida: side = comprar, PosSide = short
    Agora, já pode enviar ordens de derivados!

6.1 Envie uma ordem limite em Enviar ordem ordem
Pode comprar 100 contratos de swap de BTC-USDT ao preço de 19000 USDT.
CT-web-derivativestrading-howtoapi-10 6.2 Envie uma ordem de mercado em Enviar ordem
Pode comprar 100 contratos de swap de BTC-USDT ao preço de mercado.
CT-web-derivativestrading-howtoapi-11

7. Como obtenho os detalhes/estados de uma determinada ordem (consulte Obter detalhes da ordem)?

Além de ordId, também pode especificar o __clOrdId__para obter detalhes da ordem.
CT-web-derivativestrading-howtoapi-12

8. Como cancelo uma ordem em Cancelar ordem?

Também pode usar clOrdId em vez de ordId.
CT-web-derivativestrading-howtoapi-13

9. Como altero uma ordem em Alterar ordem?

Também pode usar clOrdId em vez de ordId.
Este exemplo mostra a revisão de um novo tamanho.
CT-web-derivativestrading-howtoapi-14

10. Como obtenho a lista de ordens abertas em Obter lista de ordens?

CT-web-derivativestrading-howtoapi-15

11. Como obtenho o histórico de ordens em Obter histórico de ordens (últimos 7 dias) e Obter histórico de ordens (últimos 3 meses)?

CT-web-derivativestrading-howtoapi-16

12. Como obtenho detalhes da transação em Obter detalhes da transação (últimos 3 dias) e Obter detalhes da transação (últimos 3 meses)?

CT-web-derivativestrading-howtoapi-17

13. Como obtenho posições em Obter posições?

Quando a sua conta estiver no modo net, será exibida a posição net de cada contrato; quando a sua conta estiver no modo long/short, a posição comprada ou vendida de cada contrato será exibida separadamente.
CT-web-derivativestrading-howtoapi-18 Por exemplo, pode acompanhar os seus lucros e perdas não realizados através do parâmetro de resposta upl.

Mais exemplos

Para obter mais exemplos, faça o download do Jupyter Notebook completo aqui.
Se tiver alguma dúvida sobre as APIs da OKX, pode apresentá-la no Canal do Telegram para suporte de API da OKX.