TradingView अलर्ट संदेश: फ़ॉर्मैट, उदाहरण दर उदाहरण
संदेश ही वह अकेला टेक्स्ट है जो आपका अलर्ट भेजता है। MT4, MT5 या cTrader पर ऑर्डर बनने के लिए, वह एक सरल फ़ॉर्मैट का पालन करता है: एक JSON ऑब्जेक्ट या टेक्स्ट की एक ही पंक्ति। यहाँ हर फ़ील्ड, हर कमांड और कॉपी करने को तैयार उदाहरण हैं, सभी वेबहुक परीक्षक में जाँचे हुए।
अलर्ट का संदेश
{
"action": "buy",
"symbol": "EURUSD",
"volume": 0.10,
"sl": 1.0820,
"tp": 1.0910
}
संदेश कहाँ जाता है
TradingView की अलर्ट विंडो में, Message फ़ील्ड में वह टेक्स्ट होता है जो हर ट्रिगर पर भेजा जाता है, और Webhook URL फ़ील्ड में वह पता जिस पर उसे भेजा जाता है। यह पता आपके TheConnector खाते का है: उसमें एक्सेस की पहले से होती है, इसलिए संदेश में सिर्फ़ ऑर्डर का विवरण होता है।
- एक अलर्ट एक संदेश भेजता है, इसलिए एक ही कमांड
- एक्सेस की वेबहुक पते में रहती है, संदेश में कभी नहीं
- TradingView भेजने से पहले {{ticker}} जैसे वेरिएबल बदल देता है
न्यूनतम संदेश
एक मान्य संदेश के लिए दो फ़ील्ड काफ़ी हैं: कमांड और सिंबल। तब ऑर्डर का आकार खाते की जोखिम सेटिंग से तय होता है, और जोखिम के आधार पर आकार तय करने के लिए स्टॉप चाहिए: व्यवहार में, कम से कम एक स्टॉप-लॉस जोड़ें, या फिर लॉट की एक तय संख्या दें।
{"action":"buy","symbol":"EURUSD"}
buy,EURUSD
- action: क्या करना है, इस उदाहरण में ख़रीदना
- symbol: TradingView का टिकर, जिसे आपके ब्रोकर के सिंबल से मिलाया जाता है
- एक पंक्ति वाला टेक्स्ट रूप बिल्कुल यही जानकारी रखता है
संदेश के फ़ील्ड
आठ फ़ील्ड लगभग हर ज़रूरत पूरी करते हैं। उनके नाम छोटे अक्षरों में लिखे जाते हैं, और उनके मान संख्याएँ होते हैं, सिवाय कमांड, सिंबल और टैग के। जिस फ़ील्ड को TheConnector नहीं पहचानता, उसे चुपचाप अनदेखा कर दिया जाता है: ग़लत वर्तनी वाला नाम पकड़ में नहीं आता, इसीलिए लाइव जाने से पहले परीक्षक पर एक नज़र डालना फ़ायदेमंद है।
actionकमांड: ख़रीदना, बेचना, बंद करना, रद्द करना, बदलनाbuysymbolइंस्ट्रूमेंट, उसी नाम से जो TradingView में हैEURUSDriskऑर्डर का जोखिम, खाते के जोखिम स्रोत के अनुसार पढ़ा जाता है1volumeलॉट की तय संख्या, जिसे जोखिम पर प्राथमिकता मिलती है0.10slस्टॉप-लॉस, खाते के मूल्य मोड में20tpटेक-प्रॉफ़िट, खाते के मूल्य मोड में40priceपेंडिंग ऑर्डर की एंट्री प्राइस1.0850tagरणनीति का नाम, ताकि एक सिंबल पर कई रणनीतियों को अलग पहचाना जा सकेtrend- स्वीकार्य उपनाम: volume के लिए lot या lots, sl के लिए stoploss, tp के लिए takeprofit
- account फ़ील्ड नहीं: वेबहुक पता पहले से ही खाते की पहचान करता है
- अन्य कमांड और प्रति अलर्ट सेटिंग सिंटैक्स संदर्भ में हैं
कमांड
action फ़ील्ड नीचे दी गई कमांड में से कोई एक लेता है। हर कमांड अंडरस्कोर वाली वर्तनी भी स्वीकार करती है, जैसे close_long, और buy और sell के लिए long और short भी स्वीकार किए जाते हैं।
buy / sellमार्केट पर पोज़िशन खोलता है, ख़रीद या बिक्री मेंbuy,EURUSD,risk=1,sl=20buylimit / selllimitकीमत से नीचे (ख़रीद) या ऊपर (बिक्री) पेंडिंग ऑर्डरbuylimit,EURUSD,price=1.0850,volume=0.1buystop / sellstopकीमत से ऊपर (ख़रीद) या नीचे (बिक्री) पेंडिंग ऑर्डरsellstop,GBPJPY,price=198.250,risk=1,sl=198.800closelong / closeshortसिंबल पर ख़रीद या बिक्री पोज़िशन बंद करता हैcloselong,EURUSDcloselongshortसिंबल पर दोनों दिशाओं की पोज़िशन बंद करता हैcloselongshort,EURUSDcancellong / cancelshortख़रीद या बिक्री के पेंडिंग ऑर्डर रद्द करता हैcancelshort,GBPJPYnewsltplong / newsltpshortखुली पोज़िशन का स्टॉप-लॉस और टेक-प्रॉफ़िट खिसकाता हैnewsltplong,EURUSD,sl=15,tp=60- पेंडिंग ऑर्डर को उसकी एंट्री प्राइस चाहिए
- एंट्री की तरह, क्लोज़ या संशोधन भी सिंबल बताता है
- breakevenlong और breakevenshort, newsltplong और newsltpshort के दूसरे नाम हैं
मार्केट पर ख़रीदना या बेचना, स्टॉप और लक्ष्य के साथ
सबसे आम संदेश: जोखिम के हिसाब से तय आकार वाली मार्केट एंट्री, अपने स्टॉप-लॉस और टेक-प्रॉफ़िट के साथ। जब जोखिम स्रोत “TradingView प्रतिशत” पर और मूल्य मोड “Pips” पर हो, तो यह उदाहरण बैलेंस का 1% जोखिम में डालता है, 20 pips दूर स्टॉप और 40 pips दूर लक्ष्य के साथ।
{"action":"buy","symbol":"EURUSD","risk":1,"sl":20,"tp":40}
- बिक्री के लिए, buy की जगह sell लिखें
- जोखिम स्टॉप हिट होने पर होने वाला नुकसान है, पोज़िशन का आकार नहीं
- तय आकार के लिए risk की जगह volume भेजें
पेंडिंग ऑर्डर लगाना
buylimit ऑर्डर इंतज़ार करता है कि कीमत नीचे आकर उसकी एंट्री तक पहुँचे, और buystop ऑर्डर इंतज़ार करता है कि कीमत ऊपर जाकर वहाँ तक पहुँचे। यह उदाहरण मानता है कि खाते का मूल्य मोड “पूर्ण मूल्य” है: एंट्री, स्टॉप और लक्ष्य बाज़ार कीमतें हैं।
{"action":"buylimit","symbol":"EURUSD","price":1.0850,"volume":0.10,"sl":1.0820,"tp":1.0910}
- यहाँ आकार तय है: 0.10 लॉट
- Pips या प्रतिशत मोड में, यही फ़ील्ड दूरी के रूप में पढ़े जाते हैं
- अगर सेटअप अब सही नहीं रहा, तो cancellong ख़रीद के पेंडिंग ऑर्डर हटा देता है
पोज़िशन बंद करना या उसका स्टॉप खिसकाना
तीन संदेश, हर अलर्ट के लिए एक: ख़रीद पोज़िशन बंद करना, दोनों दिशाओं की पोज़िशन बंद करना, फिर खुली ख़रीद पोज़िशन का स्टॉप-लॉस और लक्ष्य खिसकाना। एंट्री की तरह, हर संदेश अपना सिंबल बताता है।
{"action":"closelong","symbol":"EURUSD"}
{"action":"closelongshort","symbol":"EURUSD"}
{"action":"newsltplong","symbol":"EURUSD","sl":15,"tp":60}
- बिना टैग वाला क्लोज़ माँगी गई दिशा की पहली पोज़िशन लेता है
- अगर एक ही सिंबल पर कई रणनीतियाँ हों, तो उन्हें tag से नाम दें
- हर अलर्ट में एक पंक्ति कॉपी करें, पूरा ब्लॉक कभी नहीं
एक ही सिंबल पर दो रणनीतियाँ
नाम के बिना, क्लोज़ पहली मिलने वाली पोज़िशन ले लेता है, शायद दूसरी रणनीति की। tag फ़ील्ड रणनीति को नाम देता है: एंट्री के समय रोबोट उसे ब्रोकर के यहाँ पोज़िशन की टिप्पणी में लिखता है, और नाम वाला क्लोज़ सिर्फ़ उन्हीं पोज़िशन को छूता है जिन पर वह नाम हो।
{"action":"buy","symbol":"USDJPY","risk":1,"sl":20,"tag":"trend"}
{"action":"closelong","symbol":"USDJPY","tag":"trend"}
- रणनीति के हर अलर्ट में वही टैग, एंट्री हो या एग्ज़िट
- टैग छोटे अक्षरों में बदले जाते हैं और 12 वर्णों तक काट दिए जाते हैं: उन्हें छोटा और एक-दूसरे से अलग रखें
- सिर्फ़ अक्षर, अंक, - और _
संदेश में TradingView वेरिएबल डालना
एक ही संदेश हर चार्ट पर काम आ सकता है: {{ticker}} के साथ, सिंबल उसी चार्ट का होता है जिस पर अलर्ट बनाया गया है। TradingView भेजने से पहले वेरिएबल बदल देता है, इसलिए TheConnector को असली सिंबल मिलता है।
{"action":"buy","symbol":"{{ticker}}","risk":1,"sl":20,"tp":40}
- टेक्स्ट वेरिएबल कोटेशन मार्क में जाते हैं ("{{ticker}}"), {{close}} जैसी संख्याएँ नहीं
- रणनीति अलर्ट: ख़रीद से बाहर निकलने के लिए {{strategy.order.action}} “sell” होता है, इसलिए alert_message को प्राथमिकता दें
- वेरिएबल की पूरी सूची TradingView अलर्ट गाइड में है
स्टॉप, लक्ष्य और कीमत की इकाइयाँ
sl, tp और price की संख्याएँ खाते की सेटिंग में चुने गए मूल्य मोड के अनुसार पढ़ी जाती हैं। पूर्ण मूल्य: बाज़ार की कोई कीमत, जैसे 1.0750। Pips: एंट्री से दूरी, जैसे 20। प्रतिशत: एंट्री प्राइस के प्रतिशत के रूप में दूरी, जैसे 0.5।
- मूल्य मोड उसी से मेल खाना चाहिए जो आपके अलर्ट भेजते हैं
- Pips फ़ॉरेक्स के लिए ठीक हैं; सूचकांकों और धातुओं पर कीमत या प्रतिशत चुनें
- दशमलव को बिंदु से लिखें: एक पंक्ति वाले रूप में, कॉमा फ़ील्ड को अलग करता है
- विकल्प: sl_pips, sl_price या sl_pct (और tp_pips, tp_price, tp_pct) इकाई अलर्ट में ही तय करते हैं
वे ग़लतियाँ जिनसे संदेश अस्वीकार होता है
ज़्यादातर अस्वीकृतियाँ गिनी-चुनी वजहों से होती हैं, और अलर्ट इतिहास हर वजह का नाम बताता है। पहली वजह चौंकाती है: किसी पुराने उदाहरण से कॉपी किया गया account फ़ील्ड पूरे अलर्ट को अस्वीकार करवा देता है, कुंजी मान्य होने पर भी।
- खाते से ठीक-ठीक मेल न खाने वाला account फ़ील्ड: अस्वीकृति, मानो एक्सेस की अस्वीकृत हुई हो
- ग़लत बना JSON: छूटा हुआ कोटेशन मार्क या फ़ालतू कॉमा
- अज्ञात या ग़ायब कमांड, या ग़ायब सिंबल
- टेक्स्ट या इकाई के साथ लिखी संख्या, जैसे 20pips या 1%
भेजने से पहले संदेश जाँचना
मुफ़्त वेबहुक परीक्षक आपका संदेश उसी पार्सर से पढ़ता है जो उत्पादन गेटवे में है, और दिखाता है कि वह क्या समझता है: कमांड, सिंबल, आकार, स्टॉप, लक्ष्य, टैग। किसी भी खाते पर कुछ नहीं भेजा जाता। होम पेज का अलर्ट जेनरेटर आपके लिए संदेश तैयार कर देता है।
- संदेश ठीक वैसे ही पेस्ट करें जैसा वह TradingView में होगा
- टेस्ट से पहले वेरिएबल की जगह असली मान डालें
- फिर डेमो खाते पर पहला अलर्ट भेजें
संबंधित गाइड
FAQ
क्या एक्सेस की संदेश में डालनी चाहिए?
नहीं। वह आपके डैशबोर्ड से कॉपी किए गए वेबहुक पते का हिस्सा है, जो खाते की पहचान करता है। संदेश सिर्फ़ ऑर्डर का विवरण देता है।
JSON या टेक्स्ट की एक पंक्ति: कौन-सा चुनें?
दोनों स्वीकार किए जाते हैं और उनमें एक जैसे फ़ील्ड होते हैं। JSON हर मान को नाम देता है, जिससे उसे दोबारा पढ़ना आसान होता है; एक पंक्ति वाला रूप, जैसे buy,EURUSD,risk=1,sl=20,tp=40, टाइप करने में छोटा है।
अलर्ट से पोज़िशन कैसे बंद करें?
ख़रीद पोज़िशन बंद करने के लिए closelong भेजें, या बिक्री वाली के लिए closeshort, सिंबल के साथ: {"action":"closelong","symbol":"EURUSD"}। अगर सिंबल पर कई रणनीतियाँ हों, तो वही टैग जोड़ें जो एंट्री पर था।
कुंजी मान्य होने पर भी मेरा अलर्ट क्यों अस्वीकार होता है?
ज़्यादातर किसी पुराने उदाहरण से कॉपी किए गए account फ़ील्ड की वजह से: अगर वह मौजूद है, तो उसे खाते से बिल्कुल मेल खाना चाहिए, वरना अलर्ट ऐसे अस्वीकार होता है मानो कुंजी ग़लत हो। उसे हटा दें; वेबहुक पता काफ़ी है।
क्या कैंडल की क्लोज़िंग प्राइस भेजी जा सकती है?
हाँ, {{close}} वेरिएबल के साथ, बिना कोटेशन मार्क के। यह पेंडिंग ऑर्डर की एंट्री प्राइस के रूप में काम आता है, जब खाते का मूल्य मोड “पूर्ण मूल्य” हो।
अगर संदेश में ऐसा फ़ील्ड हो जिसे TheConnector नहीं पहचानता, तो क्या होता है?
उसे बिना किसी त्रुटि के अनदेखा कर दिया जाता है। ऑर्डर उसके बिना चला जाता है, इसलिए ग़लत वर्तनी वाला नाम बिना चेतावनी के ऑर्डर बदल देता है: संदेश को वेबहुक परीक्षक में जाँचें।