Z radością przedstawiamy najnowsze zmiany i ulepszenia alertów — teraz dostępne są wiadomości ze zmiennymi. Jako zmienne można użyć ceny, wartości wskaźników, czas i inne. Po uruchomieniu alertu wysyłane jest powiadomienie z aktualną wartością zmiennej.
Aby uzyskać aktualną wartość zmiennej, należy użyć specjalnych symboli zastępczych, których lista jest pokazana poniżej. Należy je określić w oknie dialogowym tworzenia i edycji alertów, w tej części wiadomości, w której chcesz uzyskać odpowiednią wartość po uruchomieniu alertu.
Na przykład możesz utworzyć alert dla symbolu NASDAQ:AAPL i dołączyć następującą wiadomość:
{{exchange}}:{{ticker}}, Price = {{close}}, Volume = {{volume}}
Kiedy alert zostanie uruchomiony, zobaczysz wartości zmiennej zamiast pokazanych wcześniej symboli zastępczych.
Poniżej lista dostępnych symboli zastępczych:
1. {{ticker}} — ticker symbolu, (na przykład AAPL, BTCUSD).
2. {{exchange}} — giełda dla danego symbolu (np. NASDAQ, NYSE lub AMEX). Dane z opóźnieniem zawierają parametr DL lub DLY np. NYMEX_DL.
3. {{close}}, {{open}}, {{high}}, {{low}}, {{time}}, {{volume}} — wartości odpowiadające danym słupka, który aktywował alert. Alerty dotyczące wskaźników, narzędzi do rysowania i niekonwencjonalnych wykresów zależą od interwału, natomiast alerty cenowe są zawsze obliczane na wykresie 1-minutowym. {{time}} to czas słupka w strefie UTC w formacie yyyy-MM-ddTHH: mm: ssZ. Na przykład 2019-08-27T09: 56: 00Z. Wszystkie pozostałe wartości są w formacie dziesiętnym, ale z kropką zamiast przecinka (format amerykański), np. 1245.25.
4. {{timenow}} — dokładny czas uruchomienia alertu. Jest sformatowany w ten sam sposób co czas słupka {{time}}. Czas jest dokładny co do sekundy niezależnie od wybranego interwału.
5. {{plot_0}}, {{plot_1}}, … {{plot_19}} — wartości odpowiadające serii danych wskaźnika wybranego do ustawienia alertu. Seria składa się z danych widocznych na wykresie. Na przykład wbudowany wskaźnik Wolumen ma dwie serie – Wolumen i Średni wolumen. Możesz utworzyć alert w oparciu o ten wskaźnik i napisać w wiadomości:
Volume: {{plot_0}}, Volume average: {{plot_1}}
Gdy alert zostanie uruchomiony, zobaczysz odpowiednie wartości.
Uwaga: funkcje plot są numerowane od zera.
Te same zasady dotyczą skryptów napisanych w Pine. Serie są liczone zgodnie z kolejnością wywołania w kodzie. Lista funkcji, których serie można użyć w powiadomieniach:
- plot;
- plotshape;
- plotchar;
- plotarrow;
- plotbar;
- plotcandle.
Jeżeli argument series tych funkcji zawiera wartość logiczną, w wiadomości powiadomienia zostanie podana wartość 0 lub 1. Należy pamiętać, że niektóre funkcje — plotcandle and plotbar — mają po 4 serie i każda z nich zostanie uwzględniona w mechanizmie numeracji.
Ta metoda pobierania wartości nie zawsze jest wygodna. Dla ułatwienia dodaliśmy obsługę wywoływania funkcji plot po nazwie. Żeby to zrobić, użyj symbolu zastępczego:
{{plot("Name")}}
Gdzie Name jest nazwą serii.
W przypadku wskaźników wbudowanych obsługiwane są tylko nazwy używane w angielskiej wersji językowej. W przykładzie ze wskaźnikiem Wolumen, żeby uzyskać dostęp do serii korzystając z ich nazw, należy dołączyć do wiadomości następujący komunikat:
Volume: {{plot("Volume")}}, Volume average: {{plot("Volume MA")}}
Analogicznie w przypadku Pine Script, żeby uzyskać dostęp do serii, należy podać nazwę z argumentu tytułu odpowiedniej funkcji (dla wszystkich funkcji plot oprócz plotcandle i plotbar). Jeżeli nie masz dostępu do kodu, nazwę można zobaczyć w ustawieniach stylu.
Na przykład, żeby uzyskać dostęp do wartości tego skryptu:
//@version=4 study("My script") plot(close, title="series")
Dołącz ten komunikat do wiadomości alertu:
{{plot("series")}}
Ta sama nazwa jest wyświetlana w ustawieniach skryptu.
Jeżeli używasz kilku wskaźników w jednym alercie, możesz odwołać się do wartości tylko pierwszego z nich — tego wskazanego na pierwszej liście rozwijanej. Zobacz poniższy przykład.
W tym przypadku możesz się odwołać tylko do wartości MA. Żeby uzyskać dostęp do wartości skryptu „My script”, należy go wybrać na pierwszej liście rozwijanej.
Możesz także określić nowe symbole zastępcze w argumencie wiadomości funkcji alertcondition. Na przykład:
//@version=4 study("My script") alertcondition(close>open, message="price {{ticker}} = {{close}}")
Komunikat z argumentu jest automatycznie wciągany do okna komunikatu w oknie dialogowym tworzenia alertu.
Gdy alert zostanie utworzony z warunkiem pochodzącym z funkcji alertcondition, zamiana wartości będzie miała zastosowanie tylko dla skryptów v4 i wyższych.
Wartości uzyskane z aktywowanych alertów można wykorzystać razem z webhookami, wysyłając zmienne zawarte w wiadomości na pożądany adres. Otwiera to jeszcze więcej możliwości dla tych, którzy często używają alertów.