כיצד להשתמש בערך משתנה בהתראה

תוכל להשתמש במצייני מיקום מיוחדים כדי לגשת לערכים משתנים בהודעת ההתראה. לדוגמה, באפשרותך ליצור התראה ב  NASDAQ: AAPL ולהקליד תיבת הודעה:

{{exchange}}:{{ticker}}, price = {{close}}, volume = {{volume}} 

לאחר הפעלת ההתראה, תקבלו ערכים תואמים:

הנה רשימה של מצייני מיקום זמינים:

1. {{טיקר}} - טיקר של הסמל המשמש להתראה (AAPL, BTCUSD וכו ').
2. {{exchange}}  - בורסת הסימול המשמש בהתראה (NASDAQ, NYSE, MOEX וכו '). שים לב כי עבור סימולים מושהים, הבורסה תסתיים ב- "_DL" או "_DLY." לדוגמה, "NYMEX_DL."
3. {{close}}, {{open}}, {{high}}, {{low}}, {{time}}, {{volume}} - ערכים תואמים של הבר שעליו הופעלה ההתראה . שים לב שהתראות על אינדיקטורים, גרפים ושרטוטים לא סטנדרטיים תלויות ברזולוציה, בעוד שהתראות מחיר פשוטות (למשל, מחיר שחוצה ערך כלשהו) מחושבות תמיד בברי דקה. {{time}} נמצא ב- UTC, מעוצב כ- yyyy-MM-ddTHH: mm: ssZ. לדוגמה, 2019-08-27T09: 56: 00Z. ערכים אחרים הם מספרים קבועים עם נקודה עשרונית המפרידה בין החלקים האינטגרליים לחלקים השבריים. לדוגמא, 1245.25.
4. {{timenow}}  - זמן האש הנוכחי של ההתראה, מעוצב באותו אופן כמו {{time}}. זמן החזרה לשנייה הקרובה ביותר, ללא קשר לרזולוציה.
5. {{plot_0}}, {{plot_1}}, ... {{plot_19}} - סדרת פלט תואמת של אינדיקטור המשמש להתראה. שים לב שהמקרא ממוספר מאפס. מזהה המקרא הגבוה ביותר הוא 19 (ניתן לגשת ל -20 סדרות פלט ראשונות בלבד).   סדרות פלט הן הערכים של אינדיקטור שתוכלו לראות בגרף. לדוגמא, לאינדיקטור הנפח המובנה יש שתי סדרות פלט: Volume ו- Volume MA. באפשרותך ליצור עליו התראה ולהקליד תיבת הודעה כזו
    

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

1. {{interval}}  - מחזיר את המרווח (כלומר פרק זמן / רזולוציה) של הגרף שעליו נוצרת ההתראה. שים לב שמסיבות טכניות, במקרים מסוימים, מציין מיקום זה יחזיר "1" במקום פרק הזמן בגרף. התראות מבוססות מחירים רגילות (עם תנאים כמו "מעבר AAPL 120" או "AMZN גדול מ- 3600") מבוססות כולן על הערך האחרון של הסימול, ולכן מסגרת הזמן של הגרף אינה רלוונטית להתראה. מכיוון שכך, כל ההתראות מבוססות המחירים מחושבות בפועל על פרק הזמן של 1 מ 'ומציין המיקום תמיד יחזיר "1" בהתאם. בנוסף, טבלאות טווח מחושבות גם על סמך נתונים של 1 מ 'כך שמציין המיקום {{interval}} תמיד יחזיר "1" בכל התראה שנוצרה בגרף טווח. 

עם התראות שנוצרו על גרפים ואינדיקטורים, מציין מיקום זה יפעל כצפוי.

מצייני מקום ברשימה7. {{syminfo.currency}} - מחזירה את קוד המטבע של הסימול הנוכחי ("EUR", "USD" וכו').

8. {{syminfo.basecurrency}} - מחזירה את קוד מטבע הבסיס של הסימול הנוכחי אם הסמל מתייחס לצמד מטבעות. אחרת, זה מחזיר na. לדוגמה, הוא מחזיר "EUR" כאשר הסמל הוא "EURUSD".

ניתן להשתמש במקומות עם קידומת "אסטרטגיה" רק בהתראות אסטרטגיות:

• {{strategy.position_size}}  - מחזיר את הערך של אותה מילת מפתח באורן, כלומר, גודל המיקום הנוכחי.
• {{strategy.order.contracts}}  - מחזיר את מספר החוזים של הצו שבוצע.
• {{strategy.order.price}}   - מחזיר את המחיר שבו בוצעה ההזמנה.
• {{strategy.order.id}}  - מחזיר את המזהה של ההזמנה שבוצעה (המחרוזת המשמשת כפרמטר הראשון באחת מהפונקציות קוראת הזמנת הזמנות: strategy.entry, strategy.exit או strategy.order).
• {{strategy.order.comment}}    - מחזירה את ההערה של ההזמנה שבוצעה (המחרוזת המשמשת בפרמטר ההערה באחת מהפונקציות קוראת יצירת הזמנות: strategy.entry, strategy.exit או strategy.order) אם לא צויין הערה, ישמש את הערך של  strategy.order.id
• {{strategy.order.alert_message}}   - מחזיר את הערך של הפרמטר alert_message בו ניתן להשתמש בקוד הפיין של האסטרטגיה בעת קריאה לאחת מהפונקציות המשמשות לביצוע פקודות: strategy.entry, strategy.exit או strategy.order. תכונה זו נתמכת רק ב Pine v4. ו מעלה.
• {{strategy.market_position}}  -  מחזיר את המיקום הנוכחי של האסטרטגיה בצורה מחרוזת: "ארוך", "שטוח" או "קצר".
• {{strategy.market_position_size}} -  מחזיר את גודל המיקום הנוכחי כערך מוחלט, כלומר מספר שאינו שלילי.
• {{strategy.prev_market_position}}-  מחזיר את המיקום הקודם של האסטרטגיה בצורה מחרוזת: "ארוך", "שטוח" או "קצר".
• {{strategy.prev_market_position_size}}- מחזיר את גודל המיקום הקודם כערך מוחלט, כלומר מספר שאינו שלילי.

לאחר הפעלת ההתראה, תופיע הערכים המתאימים:

אותם כללים חלים על סקריפטים שנכתבו בפיין. הסדרות נספרות על סמך סדר הקריאה שלהן בקוד. ראה את רשימת הפונקציות למטה. ניתן להשתמש בסדרות שלהם בהודעות התראה:

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

אם ארגומנט הסדרה של פונקציות כאלה מכיל ערך בוליאני, 0 או 1 יוחלפו בהודעת ההודעה. זכור כי פונקציות מסוימות - plotcandle ו- plotbar - מציגות 4 סדרות כל אחת, וכל אחת מהן תילקח בחשבון בהיגיון המספור.

עם זאת, שיטה זו של גישה למגרשים אינה תמיד נוחה. כדי להקל על הדברים הוספנו תמיכה להתקשרות לעלילות תוך שימוש בשמותיהן. לשם כך השתמש במציין המיקום {{plot ("שם")}}, שם שם הוא שם הסדרה.

עבור אינדיקטורים מובנים, השמות היחידים הנתמכים הם אלה המשמשים בגרסה האנגלית. בדוגמה עם אינדיקטור פרופיל ווליום לגישה לסדרות באמצעות שמותיהן, תכלול את הדברים הבאים בהודעה:

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

באופן דומה, כדי ש- Pine Script יוכל לגשת לסדרה, עליך לציין את השם מטיעון הכותרת של הפונקציות המתאימות, (נתמך בכל פונקציות המקרא למעט plotcandle ו- plotbar), והשפה כבר לא תהיה חשובה. אם אין לך גישה לקוד, ניתן לראות את השם בהגדרות הסגנון.

לדוגמה, כדי לגשת לערכי סקריפט זה:

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

כלול את {{plot ("series")}} בהודעת ההתראה.

אותו שם מוצג בהגדרות הסקריפט:

כאשר משתמשים במספר אינדיקטורים בהתראה אחת, תוכלו להתייחס לערכים של הראשון - זה המצוין ברשימה הנפתחת הראשונה. ראה דוגמה למטה.

כאשר התראה כוללת הגדרות אלה, אתה יכול להתייחס רק לערכי ה- MA. כדי לגשת לערכי הסקריפט "הסקריפט שלי", עליך לבחור אותו ברשימה הנפתחת הראשונה.

ניתן גם לציין מצייני מיקום חדשים בארגומנט ההודעה של פונקציית התראה התראה. לדוגמה:

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

ההודעה מהוויכוח נשלפת אוטומטית לחלון ההודעות בתיבת הדו-שיח ליצירת התראות.

שים לב שכאשר יוצרים התראה עם תנאי מפונקציית התראה, החלפת הערך תפעל רק עבור סקריפטים v4 ומעלה.

ניתן להשתמש בערכים מההתראות המופעלות יחד עם webhooks על ידי שליחת ערכים משתנים מהודעה לכתובות הרצויות. או באמצעות יישומי צד שלישי חיצוניים כמו התראות TradingView ל- MT4 / MT5, שכבר משתמשים בשימוש בערכים דינמיים. ניתן

/למצוא כמה מקרי שימוש בתחביר בסקריפט לדוגמא זה. זה פותח אפשרויות רבות עוד יותר לאלו מכם המשתמשים בהתראות