कमांड सिंटैक्स का संदर्भ

उद्देश्य

यह संदर्भ उन कमांड नामों और उपनामों की सूची है जिन्हें WebhookIngress स्वीकार करता है। यह TradingView webhook के इनपुट का वर्णन करता है, dashboard के मैनुअल ऑर्डर का नहीं।

Market और pending कमांड

• buy के साथ long भी स्वीकार है।
• sell के साथ short भी स्वीकार है।
• buystop के साथ buy_stop भी स्वीकार है।
• buylimit के साथ buy_limit भी स्वीकार है।
• sellstop के साथ sell_stop भी स्वीकार है।
• selllimit के साथ sell_limit भी स्वीकार है।
• pending ऑर्डर expiration ले सकता है, यानी मिनटों में उसकी जीवन-अवधि (रोबोट 0.0.30 या नया): webhook फ़ॉर्मेट वाला पृष्ठ देखें।

Close, cancel और संशोधन के कमांड

• closelong के साथ close_long भी स्वीकार है।
• closeshort के साथ close_short भी स्वीकार है।
• closelongshort के साथ close_long_short भी स्वीकार है।
• cancellong के साथ cancel_long भी स्वीकार है।
• cancelshort के साथ cancel_short भी स्वीकार है।
• newsltplong के साथ newsltp_long, breakevenlong, breakeven_long, break_even_long भी स्वीकार हैं।
• newsltpshort के साथ newsltp_short, breakevenshort, breakeven_short, break_even_short भी स्वीकार हैं।

विस्तारित कमांड

जो स्क्रिप्ट पहले से इन कमांड और पैरामीटर नामों का इस्तेमाल करती हैं, वे यहाँ बिना बदलाव के चलती हैं। sl_pips, sl_price, sl_pct, tp_pips, tp_price, tp_pct, entry_pips, entry_price और vol_lots नाम अपने-आप अनुवादित हो जाते हैं, और नीचे की हर कमांड अपना अंडरस्कोर वाला रूप भी स्वीकार करती है (close_all, newsltp_buy_stop, ...)। एक अपवाद: जो अलर्ट मूल्य इकाइयाँ मिलाता है (जैसे tp_price के साथ sl_pips), वह अब अस्वीकार हो जाता है।

• एक ही अलर्ट में पहले निकलें फिर प्रवेश करें: closelongopenlong, closelongopenshort, closeshortopenlong, closeshortopenshort, closelongshortopenlong, closelongshortopenshort, cancellongbuystop, cancellongbuylimit, cancelshortsellstop, cancelshortselllimit।
• सब कुछ समतल करें: closeall सभी symbol पर हर position बंद कर देता है और हर pending ऑर्डर हटा देता है। closealleaoff वही करता है, फिर रोबोट को रोक देता है।
• आंशिक close: closelongpct, closeshortpct। हिस्सा खाते की सेटिंग Partial close (%) से आता है — ये अलर्ट उसे साथ नहीं ले जाते। अलर्ट में दिया गया volume फिर भी भारी पड़ता है।
• pending ऑर्डर पर SL/TP: newsltpbuystop, newsltpbuylimit, newsltpsellstop, newsltpselllimit। ये ऑर्डर का प्रवेश भाव कभी नहीं हिलाते।
• अलर्ट से रोकना / फिर चालू करना: eaoff, eaon। दायरा पूरा खाता है।
• एक ही position पर trailing: trailingoff, trailingon, ऑर्डर का ticket साथ लेकर। पहले से लगा stop हिलता नहीं; रोबोट बस उसका पीछा करना बंद कर देता है।
• अलर्ट में लिखा आकार: vol_dollar (जोखिम में डाली राशि, खाते की मुद्रा में), vol_pct_bal_loss (balance का %), vol_pct_eq_loss (equity का %), vol_pct_bal_margin (balance का वह % जो margin के रूप में लगे — यह exposure की सीमा है और stop की दूरी को अनदेखा करती है)। खाते की जोखिम सेटिंग्स पर अलर्ट भारी पड़ता है।
• अलर्ट में लिखी सुरक्षा: spread प्रवेश पर स्वीकार्य spread को pips में सीमित करता है। betrigger / beoffset stop को break-even पर ले जाते हैं; trailtrig / traildist / trailstep उसका पीछा कराते हैं — पाँचों pips में, केवल उसी position पर। atrtimeframe / atrperiod / atrmultiplier / atrshift / atrtrigger इसके बजाय ATR के गुणक पर पीछा कराते हैं। ये तब भी काम करते हैं जब खाते का अपना trailing बंद हो।
• रोबोट संस्करण: प्रति अलर्ट आकार और सुरक्षा के लिए रोबोट 0.0.21 या नया चाहिए। पुराने रोबोट उन्हें अनदेखा कर देते हैं और अलर्ट को खाते की सेटिंग्स से चलाते हैं।

एक ही symbol पर कई रणनीतियाँ

एक ही जोड़ी पर ट्रेड करने वाली दो रणनीतियाँ एक ही खाते पर रहती हैं, इसलिए बिना tag वाला closelong पहला मिलने वाला long बंद कर देता है — जो दूसरी रणनीति का भी हो सकता है। उन्हें अलग रखने के लिए हर रणनीति को tag (उपनाम comment) से नाम दें: प्रवेश पर रोबोट वह नाम position के broker comment में अंकित कर देता है, और नाम वाला close केवल उन्हीं positions को छूता है जिन पर वह नाम है।

• किसी रणनीति के हर अलर्ट में वही नाम रखें, प्रवेश और निकास दोनों में। जिस नाम के साथ कभी कोई प्रवेश नहीं हुआ, उस नाम का close कुछ भी बंद नहीं करता।
• नाम lowercase कर दिए जाते हैं और 12 अक्षरों पर काट दिए जाते हैं; अक्षर, अंक, - और _ के अलावा सब कुछ हटा दिया जाता है। इसलिए Strat A और strata एक ही नाम हैं — छोटे और स्पष्ट रूप से अलग नाम चुनें।
• नाम वाले close के लिए रोबोट 0.0.21 या नया चाहिए। पुराने रोबोट पर वह अलर्ट किसी दूसरी रणनीति की position पर चलाने के बजाय अस्वीकार कर दिया जाता है।
• नाम प्रतिकृति के साथ जाता है: लक्ष्य खाते पर दोहराई गई पोज़िशन स्रोत का नाम रखती हैं।
• नाम के साथ अपना streamId न भेजें — वह बनाए गए id की जगह ले लेता है, और फिर नाम कभी position के comment तक नहीं पहुँचता।
• नाम न हो तो कुछ नहीं बदलता: close तब भी माँगी गई दिशा की पहली position ले लेता है।

trend रणनीति का प्रवेश अलर्ट:

{"action":"buy","symbol":"USDJPY","risk":1,"tag":"trend"}

उसका निकास अलर्ट, जो दूसरी रणनीति को नहीं छूता:

{"action":"closelong","symbol":"USDJPY","tag":"trend"}

Market का उदाहरण

{
  "action": "buy",
  "symbol": "EURUSD",
  "risk": 1,
  "sl": 0.2,
  "tp": 0.4,
  "priceMode": "percent"
}

priceMode अलर्ट में ही sl, tp और price की इकाई बताता है: price, pips या percent। यहाँ स्टॉप एंट्री से 0.2% और लक्ष्य 0.4% दूर है, खाते का मूल्य मोड चाहे जो हो; priceMode के बिना खाते का मूल्य मोड लागू होता है।

Pending का उदाहरण

{
  "action": "buystop",
  "symbol": "EURUSD",
  "price": 1.0875,
  "risk": 1,
  "sl": 1.0840,
  "tp": 1.0940,
  "priceMode": "price"
}

Close या संशोधन का उदाहरण

{
  "action": "closelong",
  "symbol": "EURUSD",
  "ticket": "123456789"
}

Parser से जुड़ी बातें

• access key को TradingView के Webhook URL में रखें: https://webhook.theconnector.fr/YOUR_ACCESS_KEY।
• risk संख्यात्मक है; ठीक-ठीक lots volume, lot, lots या fixedVolume से भेजे जाते हैं।
• price केवल pending ऑर्डर के लिए ज़रूरी है।
• ttl_ms को मौजूदा पार्सर नहीं पढ़ता। हर कीमत उसी इकाई में रहती है जिसमें वह लिखी गई है — प्रत्यय (sl_pips, tp_price…) केवल उसी मान के लिए, वरना priceMode, वरना खाते का मूल्य मोड — और जिस अलर्ट की कीमतों को दो इकाइयाँ चाहिए (जैसे tp_price के साथ sl_pips), वह अस्वीकार हो जाता है, और कभी भी अपने स्टॉप-लॉस या टेक-प्रॉफ़िट के बिना नहीं भेजा जाता: सभी कीमतों पर प्रत्यय लगाएँ, या किसी पर नहीं।
• देर से आया कमांड समाप्त हो जाता है; उसे दोबारा नहीं चलाया जाता।