Jak mogę handlować instrumentami pochodnymi za pomocą Jupyter Notebook?

Opublikowano 28 wrz 2023Zaktualizowano 4 kwi 202410 min czytania45

Dowiedz się, jak możesz przeprowadzić prosty handel instrumentami pochodnymi za pomocą tych samych narzędzi. Wykorzystajmy wszechstronne funkcje dostępne w python-okx na wyższym poziomie!

Typy instrumentów pochodnych

Na OKX dostępne są trzy rodzaje instrumentów pochodnych:

  1. Kontrakty terminowe typu Futures
  2. Kontrakty wieczyste typu swap
  3. Opcje

Możesz przejść do Wyjaśnienie instrumentów pochodnych Bitcoina, aby poznać charakterystykę różnych rodzajów instrumentów pochodnych na OKX. W tym samouczku użyjemy Kontrakty wieczyste typu swap jako przykładu.

Często zadawane pytania

1. Jak mogę uzyskać dane rynkowe z Pobierz dane rynkowe?

Możesz również zastąpić instType przez KONTRAKTY TERMINOWE lub OPCJE dla własnej informacji.
CT-web-derivativestrading-howtoapi-1

2. Jak mogę uzyskać dostępne pary handlowe z Pobierz instrumenty?

Podobnie jak w przypadku innych metod, wybierz typ instType, dla którego chcesz uzyskać informacje.
CT-web-derivativestrading-howtoapi-2
2.1 Obliczanie wartości referencyjnej kontraktu pochodnego z parametrem instrumentu ctVal i ctMult
Aby obliczyć wartość referencyjną kontraktu pochodnego (tj. future, perpetual swap i opcji), potrzebujesz ctVal (wartość kontraktu) i ctMult (mnożnik kontraktu) z parametrów instrumentu.
Wartość referencyjną kontraktu pochodnego można obliczyć jako
Wartość referencyjną kontraktu pochodnego można obliczyć jako ctVal * ctMult (jednostka: ctValCcy);
Na przykład, na podstawie parametrów instrumentu przedstawionych poniżej, możemy obliczyć wartość referencyjną kontraktu wieczystego LTC-USD jako: ctVal * ctMult (jednostka:ctValccy) = 10 * 1 USD = 10 USD
CT-web-derivativestrading-howtoapi-3

3. Jak mogę sprawdzić saldo z pozycji Uzyskaj saldo?

CT-web-derivativestrading-howtoapi-4

4. Czum jest tryb konta i tryb depozytu zabezpieczającego/transakcji, który kwalifikuje się do handlu instrumentami pochodnymi?

Jak wspomnieliśmy w naszym ostatnim samouczku, w ramach ujednoliconego konta dostępne są cztery tryby konta:

  • Proste konto,
  • Jednowalutowe konto z depozytem zabezpieczającym,
  • Wielowalutowe konto z depozytem zabezpieczającym,
  • Konto z portfelowym depozytem zabezpieczającym.
    Pamiętaj, że tylko trzy ostatnie tryby depozytu zabezpieczającego, a mianowicie jednowalutowy depozyt zabezpieczający, wielowalutowy depozyt zabezpieczający i portfelowy depozyt zabezpieczający, kwalifikują się do obrotu instrumentami pochodnymi.
    Zapoznaj się z dokumentem jak skonfigurować tryb konta, aby zrozumieć różnice między czterema trybami i jak przełączać się między nimi za pośrednictwem naszego interfejsu użytkownika.

4.1 Pobierz bieżącą konfigurację konta z parametru acctLv w Pobierz konfigurację konta
Upewnij się, że jesteś w odpowiednim trybie konta do handlu instrumentami pochodnymi.
CT-web-derivativestrading-howtoapi-5

5. Jak mogę ustawić dźwignię za pośrednictwem pozycji Ustaw dźwignię konta?

Jednym z ważnych parametrów, które musimy ustawić podczas handlu instrumentami pochodnymi, jest dźwignia.
Dźwignia finansowa umożliwia traderom wejście w pozycję, która jest warta znacznie więcej przy zaangażowaniu jedynie niewielkiej kwoty pieniędzy. Zyski lub straty są zatem znacznie powiększone.
Traderzy mogą mieć nawet 125-krotną dźwignię finansową podczas handlu instrumentami pochodnymi na OKX. Możesz przeczytać odnośniki do ustawiania dźwigni finansowej dla różnych poziomów dźwigni dozwolonych na różnych poziomach pozycji.
CT-web-spottrading-howtoapi-6 Oto, co oznaczają słowniczki przedstawione powyżej:

  • Max. Dźwignia finansowa: Maksymalna wielokrotność pożyczonego kapitału w celu zwiększenia potencjalnego zwrotu z inwestycji.
  • Początkowy wskaźnik depozytu zabezpieczającego (IMR): Depozyt zabezpieczający wymagany do utrzymywania bieżących pozycji.
  • Współczynnik obowiązkowego depozytu zabezpieczającego (MMR): Minimalny depozyt zabezpieczający wymagany do utrzymania bieżących pozycji. Likwidacja nastąpi, jeśli kapitał konta spadnie poniżej depozytu zabezpieczającego.
    Na przykład, jeśli chcesz dokonać transakcji na 3000 kontraktów wieczystych ETHUSDT, możesz wykorzystać maksymalnie 75-krotność posiadanego kapitału. IMR = 1 / 75 = 1,3%, a aby uniknąć likwidacji, należy utrzymywać MMR na poziomie 0,8% lub wyższym.
    Więcej informacji na temat dźwigni finansowej, wymogów dotyczących depozytu zabezpieczającego i zasad likwidacji można znaleźć na stronie OKX Margin Trading Rules w sekcji 6.2 Dźwignia finansowa i 6.3 Wskaźnik depozytu zabezpieczającego i przymusowa likwidacja.

Istnieje 9 różnych scenariuszy dźwigni ustawień za pośrednictwem otwartych interfejsów API OKX. Różne przypadki można znaleźć na stronie Scenariusze ustawiania dźwigni.
W przypadku kontraktów wieczystych typu swap istnieją 3 różne scenariusze ustawiania dźwigni finansowej:

  • Ustaw dźwignię finansową dla instrumentów SWAP w ramach transakcji cross-margin na poziomie kontraktu.
  • Ustaw dźwignię finansową dla instrumentów SWAP w trybie izolowanej dźwigni i trybie kupna/sprzedaży pozycji na poziomie kontraktu.
  • Ustaw dźwignię dla instrumentów SWAP w trybie isolated-margin i long/short na poziomie kontraktu i pozycji.
    Poniższy przykład pokazuje, jak ustawić dźwignię dla pojedynczego kontraktu SWAP i strony pozycji, w porównaniu do wszystkich kontraktów SWAP dla określonego instrumentu bazowego.
    CT-web-derivativestrading-howtoapi-7
    Należy pamiętać, że parametr żądania posSide jest wymagany tylko wtedy, gdy tryb depozytu zabezpieczającego jest izolowany w trybie long/short position (składanie zleceń) dla instrumentów FUTURES/SWAP (patrz scenariusz 6 i 9 w dokumencie Ustaw scenariusze dźwigni).

6. Jak mogę składać zlecenia w różnych trybach pozycji (składania zleceń): długi/krótki i kupno/sprzedaż?

Istnieją dwa tryby pozycji (składania zleceń) podczas handlu FUTURES i perpetual SWAP: long/short i buy/sell (netto).
Możesz zmienić tryb pozycji (składania zleceń) pomiędzy long/short i kup/sprzedaj (netto), poprzez API Ustaw tryb pozycji:
CT-web-derivativestrading-howtoapi-8
Alternatywnie można to zrobić za pomocą Ustawień na stronie internetowej, jak poniżej:
CT-web-derivativestrading-howtoapi-9
W trybie kup/sprzedaj (netto) pozycja danego kontraktu jest ilością netto transakcji kupna i sprzedaży. W przypadku składania zleceń za pośrednictwem strony Złóż zlecenie, parametr żądania posSide nie jest obowiązkowy. Jeśli ją przekażesz, jedyną prawidłową wartością będzie net.
W trybie long/short, długie i krótkie pozycje danego kontraktu będą niezależne od siebie i muszą być zamykane oddzielnie. W przypadku składania zleceń za pośrednictwem strony Złóż zamówienie, parametr żądania posSide jest obowiązkowy. Prawidłowe wartości to long lub short. Poniżej pokazano, jak ustawić parametr side (strona transakcji) i posSide (strona pozycji) podczas składania zlecenia w różnych scenariuszach:

  • Złożenie zlecenia kupna i otwarcie/zwiększenie pozycji długiej: side = buy, posSide = long
  • Złożenie zlecenia sprzedaży i otwarcie/zwiększenie krótkiej pozycji: side = sell, posSide = short
  • Złożenie zlecenia sprzedaży i zamknięcie/redukcja długiej pozycji: side = sell, posSide = long
  • Złożenie zlecenia sprzedaży i zamknięcie/redukcja długiej pozycji: side = sell, posSide = long
    Następnie możesz składać zlecenia na instrumenty pochodne!

6.1 Złożenie zlecenia z limitem ceny za pośrednictwem strony Złóż zlecenie
Zakup 100 kontraktów swap BTC-USDT po cenie 19 000 USDT.
CT-web-derivativestrading-howtoapi-10
6.2 Złożenie zlecenia rynkowego za pośrednictwem strony Złożenie zlecenia
Zakup 100 kontraktów swap BTC-USDT po cenie rynkowej.
CT-web-derivativestrading-howtoapi-11

7. Jak mogę uzyskać szczegóły/stan danego zlecenia (patrz Uzyskaj szczegóły zlecenia)?

Oprócz ordId, można również określić clOrdId, aby uzyskać szczegóły zlecenia.
CT-web-derivativestrading-howtoapi-12

8. Jak mogę anulować zlecenie za pośrednictwem Anuluj zamówienie?

Możesz także użyć clOrdId zamiast ordId
CT-web-derivativestrading-howtoapi-13

9. Jak mogę zmienić zamówienie za pośrednictwem Zmień zlecenie?

Możesz także użyć clOrdId zamiast ordId.
Ten przykład pokazuje zmianę nowego rozmiaru.
CT-web-derivativestrading-howtoapi-14

10. Jak mogę uzyskać listę otwartych zleceń poprzez Pobierz listę zleceń?

CT-web-derivativestrading-howtoapi-15

11. Jak mogę uzyskać historię zleceń za pośrednictwem Pobierz historię zleceń (ostatnie 7 dni) i Pobierz historię zleceń (ostatnie 3 miesiące)?

CT-web-derivativestrading-howtoapi-16

12. Jak mogę uzyskać szczegóły transakcji za pośrednictwem Pobierz szczegóły transakcji (ostatnie 3 dni) i Pobierz szczegóły transakcji (ostatnie 3 miesiące)?

CT-web-derivativestrading-howtoapi-17

13. Jak mogę uzyskać pozycje za pośrednictwem Pobierz pozycje?

Gdy rachunek jest w trybie netto, wyświetlona zostanie pozycja netto każdego kontraktu; gdy konto jest w trybie long/short, długa lub krótka pozycja każdego kontraktu zostanie wyświetlona osobno.
CT-web-derivativestrading-howtoapi-18 Na przykład, można śledzić niezrealizowany zysk i stratę poprzez parametr odpowiedzi upl.

Więcej przykładów

Aby uzyskać więcej przykładów, pobierz pełny Jupyter Notebook tutaj.
Jeśli masz jakieś pytania dotyczące OKX API, możesz je zadać na kanale kanał wsparcia API OKX API.