十月 31, 2019

快訊裡可以使用變數了

我們很高興介紹我們對快訊所做的最新變動和改進 — 現在支帶有變數的快訊訊息。您可以使用價格、指標值、K線時間和其他類型作為變數。觸發快訊並發送通知後,您將能夠看到最新的變動。

您需要使用變數的特定佔位符(placeholder),以便返回最新的值。請您參閱下面的佔位符列表。若您希望在觸發快訊時收到相應的值,則佔位符應當在建立和修改快訊的對話框中,指定為訊息的一部分。

例如,您可以為NASDAQ:AAPL股票代碼建立快訊,並在訊息中包含以下內容:

{{exchange}}:{{ticker}}, Price = {{close}}, Volume = {{volume}}


觸發快訊後,您將會看到這些值,而不是之前顯示的佔位符。

以下是可用佔位符的列表。

1. {{ticker}} — 返回商品代碼(例如AAPLBTCUSD)。

2. {{exchange}} — 商品代碼對應的交易所(例如NASDAQNYSE、或AMEX)。延遲的數據應該包括DLDLY參數,例如NYMEX_DL

3. {{close}}{{open}}{{high}}{{low}}{{time}}{{volume}} — 觸發快訊的K線上對應的值。指標繪圖物件、和圖表的特殊類型的快訊取決於時間期;而價格的快訊始終基於1分鐘的時間期進行計算。 {{time}}K線圖的UTC時間,格式為yyyy-MM-ddTHH: mm: ssZ。例如,2019-08-27T09: 56: 00Z。其餘值為定點數,例如1245.25

4. {{timenow}} — 觸發快訊的確切時間。它的格式與K線圖時間{{time}}相同。不論選擇的時間期如何,都精確到秒。

5. {{plot_0}}{{plot_1}}、…{{plot_19}} — 用於設定快訊的相應指標系列(series)。指標系列是您在圖表上看到的值。例如,內建的“成交量”指標具有兩個系列 — “成交量”和“平均成交量”。您可以在指標上建立快訊,並在訊息中包含以下內容:

Volume: {{plot_0}}, Volume average: {{plot_1}}

觸發快訊時,您會看到相對應的值。

注意:plot0開始編號。

相同的編寫規則適用於使Pine語言編寫的腳本。請根據代碼中調用順序對系列進行排列。請參閱下面的功能列表,它們的系列可用於快訊的訊息中:

  • plot;
  • plotshape;
  • plotchar;
  • plotarrow;
  • plotbar;
  • plotcandle

如果此類函數的系列參數包含布林(Boolean)值,則快訊訊息中將替換01。請記住,某些功能 — plotcandleplotbar-分別顯示4個系列,並在編號邏輯中將其中的每一個都考慮在內。

但是,這種獲取plot的方法並不總是很方便。為了使事情變得容易,我們增加了使用指標名稱調用plot的支援。為此,請使用佔位符

{{plot("Name")}}

其中Name是系列的名稱。

對於內建指標,唯一支援的名稱是英文版本中使用的名稱。如以下範例,用於使用系列名稱來存取系列的成交量指標,您將需要在訊息中包括以下內容:

Volume: {{plot("Volume")}}, Volume average: {{plot("Volume MA")}}

同樣,為了使用Pine 腳本獲取該系列,您應該從相應函數的title參數 (title argument) 中指定名稱(除plotcandleplotbar之外,所有繪圖函數均支援該名稱),因此指標的語言版本將不再重要。如果您無權存取程式碼,則可以在樣式設定中看到該名稱。

例如,存取此腳本的值:

//@version=4
study("My script")
plot(close, title="series")

 在快訊的訊息中包括

{{plot("series")}}

相同的名稱顯示在腳本設定中:

在單一快訊中使用多個指標時,您可以引用第一個指標的值 — 第一個下拉列表中指標的值。請參見下面的範例。

當快訊包含這些設定時,您只能引用MA的值。要存取腳本“My script”的值,您需要在第一個下拉列表中選擇它。

您還可以在alertcondition函數的message參數 (message argument) 中指定新的佔位符。例如:

//@version=4
study("My script")
alertcondition(close>open, message="price {{ticker}} = {{close}}")

來自於參數的訊息,將被自動拉入快訊建立對話框中的訊息視窗。

請注意,從Alertcondition函數建立具有條件的快訊時,變數值替換僅適用於腳本v4版或更高版本。

 

您透過將訊息中的變數值發送到所需網址,可以將觸發快訊中的值與Webhooks功能一起使用。為您在使用快訊時,創造了更多的可能性。