Specifikace výstražných zpráv Bota signálů 2.0

Obsah

– Úvod

– Sekce A – pro uživatele strategie Pine Script

– Sekce B – univerzálně kompatibilní

– Nejčastější dotazy

Úvod

Se spuštěním Botů signálů mohou uživatelé TradingView nyní zveřejňovat své signály a vytvořit si na Bota signálů OKX. V tomto průvodci si projdete různé specifikace výstražných zpráv, které OKX pro své uživatele podporuje.

Pro ty, kteří se v Pine Scriptu dobře orientují a při odesílání signálů se spoléhají výhradně na skripty strategií, jsme navrhli exkluzivní formát specifikací. Tento formát jednoduše integruje zástupné texty strategií Pine Script, díky kterým můžete předávat obchodní signály s naprostou jednoduchostí. Pokud jste nativním uživatelem strategií Pine Script, je tento formát vaším ideálním společníkem, který nabízí zjednodušený přístup ke sloučení vašich skriptů strategií se zástupnými texty strategií v TradingView. Jestliže jste autorem strategie a k vytváření signálů k obchodování používáte funkce strategy.*(), přejděte na Sekce A – pro uživatele strategie Pine Script níže.

Na druhou stranu chápeme, že ne každý se spoléhá pouze na skripty strategií v Pine Scriptu. V Sekci B – univerzálně kompatibilní tohoto průvodce najdete univerzální sadu specifikací, které jdou nad rámec metod skriptování. Tyto specifikace platí pro všechny přístupy generování signálu. Ať už používáte vlastní indikátory, různé techniky vytváření grafů, nebo třeba dáváte přednost manuálně nastaveným výstrahám, tento rámec specifikací pro všechny vám dá, co budete potřebovat.

Stručný přehled Pine Scriptu: Strategie vs. indikátor

Strategie Pine Script slouží k provádění zpětného testování na historických datech i k testování na živých trzích. Vedle provádění výpočtů indikátorů jsou součástí strategií volání funkcí strategy.*(), které předávají objednávky obchodů do brokerského emulátoru Pine Scriptu. Tento emulátor pak dokáže simulovat provádění těchto objednávek. Výsledky zpětného testování se zobrazují na kartě Tester strategie, která je v dolní části grafu vedle karty Editor Pine Scriptu.

Na druhé straně indikátory Pine Script také obsahují výpočty, ale nehodí se pro použití v případech zpětného testování. Díky své nezávislosti na brokerském emulátoru vyžadují indikátory méně zdrojů a jejich provádění je mnohem rychlejší.

Je nutné si uvědomit, že můžete použít buď formát uvedený v sekci A, nebo sekci B – oba jsou plně kompatibilní Na základě předávaných zpráv systém inteligentně rozezná použitý formát a podle toho vaše zprávy analyzuje. Toto inteligentní zpracování zajišťuje bezproblémovou zkušenost bez ohledu na zvolený přístup.

Sekce A (Uživatelé strategie Pine Script)

Následující specifikace jsou speciálně přizpůsobené uživatelům, kteří vytváří své algoritmy pomocí strategií Pine Script a hlavně pomocí funkce strategy.*. Tento formát je určen pro umístění hodnot zástupného textu strategie a díky němu je přizpůsobení velmi jednoduché. Podrobnější informace o skriptech strategií a procesu odesílání výstrah s využitím proměnných zástupného textu strategií naleznete na tomto odkazu.

Pokud tento koncept neznáte, v sekci B najdete alternativní přístup ke vytváření výstrah, který je můžete použít ve větším množství situací.

Přehled specifikací AlertMsg

1. Specifikace AlertMsg – id

id – Identifikátor objednávky

{{strategy.order.id}} – vrací ID provedené objednávky (řetězec použitý jako první parametr v jednom z volání funkce generující objednávky: strategy.entry, strategy.exit nebo strategy.order).

2. Specifikace AlertMsg – action

**action – koupit nebo prodat?

{{strategy.order.action}} – vrátí řetězec „buy“ nebo „sell“ pro provedenou objednávku.

3. Specifikace AlertMsg – marketPosition

marketPosition – zamýšlený stav pozice (při provedení objednávky)

{{strategy.market_position}} – vrací aktuální pozici strategie ve formě řetězce: „long“, „flat“ nebo „short“.

4. Specifikace AlertMsg – prevMarketPosition

prevMarketPosition – Stav předchozí pozice (před provedením objednávky)

{{strategy.prev_market_position}} – vrací předchozí pozici strategie ve formě řetězce: „long“, „flat“ nebo „short“.

5. Specifikace AlertMsg – instrument

Formát 1: ticker – hodnoty zástupného textu TradingView

Standardní zástupný text'* je doslova text ve dvojitých závorkách, který je obsažený uvnitř výstražné zprávy.

„{{ticker}}“ vrátí ticker instrumentu, na základě kterého byla výstraha spuštěna.

Například: „BTCUSDT.P“, „ETHUSDT.P“.

* Standardní zástupný text pro přístup k proměnným v Pine Script. Další informace naleznete.

Formát 2: Formát instrumentu OKX

ID instrumentu nebo instId v OKX API. Další podrobnosti si můžete přečíst na tomto odkazu.

Například: „BTC-USDT-SWAP“, „ETH-USDT-SWAP“

6. Specifikace AlertMsg – signalToken

** signalToken – Ověření pro signál**

Token je bezpečnostní opatření, které zajišťuje, že příchozí požadavky jsou legitimní a autorizované. Tento signalToken se vygeneruje automaticky, když uživatel úspěšně vytvoří nový signál na naší platformě, a je třeba jej zkopírovat do výstražné zprávy TradingView.

Jak vyhledat signalToken pro již aktivní signál?

1. Podívejte se do sekce Podrobnosti u svého signálu.

2. Vyhledejte svůj signalToken v sekci doporučených výstražných zpráv.

7. Specifikace AlertMsg – timestamp

timenow – hodnoty zástupného textu TradingView

Standardní zástupný text'* je doslova text ve dvojitých závorkách, který je obsažený uvnitř výstražné zprávy.

„{{timenow}}“ vrátí aktuální a přesný čas vygenerování výstrahy ve formátu UTC a rrrr-MM-ddTHH: mm: ssZ.

Například: „2023-06-01T17:38:10Z“.

* Standardní zástupný text pro přístup k proměnným v Pine Script. Další informace naleznete.

8. Specifikace AlertMsg – maxLag

** maxLag – Maximální přijatelné zpoždění**

Pojem „maxLag“ se vztahuje k nejvyššímu přípustnému zpoždění nebo latenci v sekundách, než bude signál k obchodování považován za neplatný. Součástí výpočtu maxLag je určení časového rozdílu mezi okamžikem odeslání signálu z TradingView (pomocí pole „timestamp“ ve výstražné zprávě) a okamžikem jeho přijetí v OKX za účelem provedení objednávky.

Výchozí hodnota je nastavena na 60 sekund. Nastavení hodnoty maxLag pomáhá zajistit, aby Bot signálů pracoval včas a nejednal podle zastaralých nebo potenciálně nepřesných signálů, které již nemusí odrážet aktuální podmínky na trhu.

9. Specifikace AlertMsg – investmentType a amount

Důležité poznámky: Pro zajištění optimální kompatibility se strategií TradingView, doporučujeme nakonfigurovat investmenttype na „base“ a nastavit „amount“ na „{{strategy.order.contracts}}“. Dodržením tohoto postupu budou množství objednávek v OKX přizpůsobena množstvím objednávek zadaným ve vaší strategii TradingView.

investmentType a Amount

(POUZE PRO VSTUPNÍ SIGNÁLY)

– base: Částka v základní měně (doporučená volba)

– margin: Investovaná marže v druhé měně

– contract: Fixní počet kontraktů

– percentage_balance: Na základě % disponibilního zůstatku (tj. marže, která je k dispozici pro otevření nových objednávek).

– percentage_investment: Na základě % Aktivní investice ve vašem botovi. Aktivní investice obvykle představuje váš počáteční investovaný margin v době vytvoření bota a zůstává neměnná, dokud nepřidáte další margin a nerozhodnete se tuto hodnotu zvýšit. Například, pokud vytvoříte bota s počátečním investovaným marginem 1000 USDT, vaše Aktivní investice bude nastavena na 1000 USDT. Pro veškeré příchozí signály se tato hodnota použije pro výpočty velikosti vaší objednávky. Předpokládejme, že po několika dnech provozu bota se rozhodnete, že se vám daří dobře, a znovu investujete dalších 1000 USDT margin a přidáte je ke své Aktivní investici. Odtud se vaše Aktivní investice zvýší na 2000 USDT a tato nová hodnota bude použita pro výpočty velikosti vaší objednávky. Pokud nejste jisti, jaká je aktuální hodnota Aktivní investice vašeho bota, můžete ji vždy zkontrolovat v sekci Podrobnosti o botu.

(POUZE PRO VÝSTUPNÍ SIGNÁLY)

– base: Částka v základní měně (doporučená volba)
– percentage_position: Na základě % otevřené pozice

Sekce B (univerzálně kompatibilní)

Níže uvedené specifikace jsou univerzální a je možné je přizpůsobit jakékoli situaci. Ať už používáte Pine Script pro vytváření skriptů strategií nebo indikátorů (study), nebo manuálně zadáváte výstrahy do uživatelského rozhraní Výstrah v TradingView, tyto specifikace je možné upravit a přizpůsobit.

Přehled specifikací AlertMsg

1. Specifikace AlertMsg – action

Režim pozice:

Pokud Bot signálů pracuje v jednosměrném režimu (např. nákup/prodej), znamená to, že bot bude držet pouze pozice v jednom směru pro daný instrument.

Otevřené objednávky

– ENTER_LONG: Otevřít long pozici s očekáváním, že cena se zvýší.
– ENTER_SHORT: Otevřít short pozici s očekáváním, že cena se sníží.

Zavřít objednávky

– EXIT_LONG: Částečně nebo úplně uzavřít long pozici prostřednictvím prodeje držených pozic.
– EXIT_SHORT: Částečně nebo úplně uzavřít short pozici prostřednictvím odkupu kontraktů.

2. Specifikace AlertMsg – instrument

Formát 1: ticker – hodnoty zástupného textu TradingView

Standardní zástupný text'* je doslova text ve dvojitých závorkách, který je obsažený uvnitř výstražné zprávy.

„{{ticker}}“ vrátí ticker instrumentu, na základě kterého byla výstraha spuštěna.

Například: „BTCUSDT.P“, „ETHUSDT.P“.

* Standardní zástupný text pro přístup k proměnným v Pine Script. Další informace naleznete.

Formát 2: Formát instrumentu OKX

ID instrumentu nebo instId v OKX API. Další podrobnosti si můžete přečíst na tomto odkazu.

Například: „BTC-USDT-SWAP“, „ETH-USDT-SWAP“

3. Specifikace AlertMsg – signalToken

** signalToken – Ověření pro signál**

Token je bezpečnostní opatření, které zajišťuje, že příchozí požadavky jsou legitimní a autorizované. Tento signalToken se vygeneruje automaticky, když uživatel úspěšně vytvoří nový signál na naší platformě, a je třeba jej zkopírovat do výstražné zprávy TradingView.

4. Specifikace AlertMsg – timestamp

timenow – hodnoty zástupného textu TradingView

Standardní zástupný text'* je doslova text ve dvojitých závorkách, který je obsažený uvnitř výstražné zprávy.

„{{timenow}}“ vrátí aktuální a přesný čas vygenerování výstrahy ve formátu UTC a rrrr-MM-ddTHH: mm: ssZ.

Možné formátování (čas UTC, formát ISO 8061)

– formát rrrr-MM-ddTHH:mm:ssZ Například: „2023-06-01T17:38:10Z“.
– formát rrrr-MM-ddTHH:mm:ss.SSSZ Například: „2023-06-01T17:38:10.836Z“
– formát rrrr-MM-ddTHH:mm:ss+0000 Například: „2023-06-01T17:38:10+0000“

Například: „2023-06-01T17:38:10Z“.

* Standardní zástupný text pro přístup k proměnným v Pine Script. Další informace naleznete.

5. Specifikace AlertMsg – maxLag

** maxLag – Maximální přijatelné zpoždění**

Pojem „maxLag“ se vztahuje k nejvyššímu přípustnému zpoždění nebo latenci v sekundách, než bude signál k obchodování považován za neplatný. Součástí výpočtu maxLag je určení časového rozdílu mezi okamžikem odeslání signálu z TradingView (pomocí pole „timestamp“ ve výstražné zprávě) a okamžikem jeho přijetí v OKX za účelem provedení objednávky.

Výchozí hodnota je nastavena na 60 sekund. Nastavení hodnoty maxLag pomáhá zajistit, aby SignalBot pracoval včas a nejednal podle zastaralých nebo potenciálně nepřesných signálů, které již nemusí odrážet aktuální podmínky na trhu.

6. Specifikace AlertMsg – order

orderType

– Market: Zadat market order k otevření (pokud action =ENTER_XX) nebo zavření (pokud action = EXIT_XX) pozice. Není nutné zadávat orderPriceOffset.
– Limit: Zadat limit order k otevření (pokud action =ENTER_XX) nebo zavření (pokud action = EXIT_XX) pozice.

orderPriceOffset (platí POUZE pro LIMIT order)

– ENTER_LONG: [1-(orderPriceOffset/100)] * nabídka-1
– ENTER_SHORT: [1+(orderPriceOffset/100)] * poptávka-1
– EXIT_LONG: [1+(orderPriceOffset/100)] * poptávka-1
– EXIT_SHORT: [1-(orderPriceOffset/100)] * nabídka-1

7. Specifikace AlertMsg – investmentType a amount

investmentType a Amount

(POUZE PRO VSTUPNÍ SIGNÁLY)

– Margin: Investovaná marže v druhé měně

– Contract: Fixní počet kontraktů

– Percentage_balance: Na základě % disponibilního zůstatku (tj. marže, která je k dispozici pro otevření nových objednávek).

– Percentage_investment: Na základě % Aktivní investice ve vašem botovi. Aktivní investice obvykle představuje váš počáteční investovaný margin v době vytvoření bota a zůstává neměnná, dokud nepřidáte další margin a nerozhodnete se tuto hodnotu zvýšit. Například, pokud vytvoříte bota s počátečním investovaným marginem 1000 USDT, vaše Aktivní investice bude nastavena na 1000 USDT. Pro veškeré příchozí signály se tato hodnota použije pro výpočty velikosti vaší objednávky. Předpokládejme, že po několika dnech provozu bota se rozhodnete, že se vám daří dobře, a znovu investujete dalších 1000 USDT margin a přidáte je ke své Aktivní investici. Odtud se vaše Aktivní investice zvýší na 2000 USDT a tato nová hodnota bude použita pro výpočty velikosti vaší objednávky. Pokud nejste jisti, jaká je aktuální hodnota Aktivní investice vašeho bota, můžete ji vždy zkontrolovat v sekci Podrobnosti o botu.

(POUZE PRO VÝSTUPNÍ SIGNÁLY)

– Percentage_position: Na základě % otevřených pozic

Sekce B Praktické příklady

Příklad 1: Long Entry -> Long Exit (úplné uzavření) bez Multi-Entry

Příklad 2: Long Entry - > Short Entry (One-Step Reversal) bez Multi-Entry

Příklad 3: Long Entry -> Long Exit (částečně) - Long Exit (úplné uzavření)

Příklad 4: Použití Multi-Entry

Multi-Entry je funkce Bota signálů, která umožňuje provedení několika vstupních bodů pro daný instrument. Obchodníci mohou optimalizovat svůj přístup k obchodování diverzifikací vstupních bodů (tj. DCA (dollar-cost averaging)), což potenciálně může zvýšit šanci na získání ziskových obchodů v dynamickém tržním prostředí.

Příklad 5: Použití pouze trigger signálu (bez polí týkajících se objednávky)

Poskytovatelé signálů mohou vyloučit některé volitelné parametry, pokud je již uživatel v botovi nakonfiguroval. To je užitečné především pro poskytovatele, kteří se zaměřují POUZE na nabídku trigger signálů pro nákup/prodej a je na každém upisovateli, aby se rozhodl, kolik chce investovat.

Příklad 6: Použití pouze trigger signálu (bez polí týkajících se objednávky)

Pokud v konfiguraci signálu i bota nejsou uvedeny detaily objednávky, použijí se výchozí hodnoty.

– Pro signály ENTER bude ve výchozím nastavení otevřeno X %* investice s použitím market order.
– Pro signály EXIT bude ve výchozím nastavení po přijetí signálu uzavřeno 100 % otevřených pozic.

*** X = 100 pro jediný pár. X = 50 pro více párů.

Příklad 7: Přednost pořadí polí

Parametry botů mají přednost před parametry signálů. Je nutné si zapamatovat dvě pravidla:

1. Pravidlo 1: Bot i signál definují pole

2. Pravidlo 2: Buď bot, nebo signál definuje pole

Nejčastější dotazy

Pokud máte nějaké dotazy ohledně Bota signálů, můžete si v tomto článku prohlédnout některé z nejčastějších dotazů našich uživatelů.