TradingView Webhook Bot सेटअप गाइड

आपने TradingView पर एक ऐसा alert बना लिया है जो ठीक उसी वक़्त fire होता है जब आप trade में entry लेना चाहते हैं। दिक़्क़त यह है: alert सिर्फ़ एक notification है। जब तक आप उसे देखकर order लगाते हैं, तब तक price हिल चुकी होती है, या आप सो रहे थे और पूरा मौक़ा ही निकल गया।

एक TradingView webhook bot इसी अंतर को पाटता है। आपको सूचना देने के बजाय, alert एक webhook URL को सूचना देता है, यानी एक निजी web address जो आपके bot का होता है। Freya का signal bot उसी address पर सुनता रहता है, और जिस पल आपका alert fire होता है, वह अपने आप आपके exchange पर trade लगा देता है। आपका chart logic TradingView पर ही रहता है; execution Freya संभालती है।

यह गाइड concepts, step-by-step setup, और reliability, security व troubleshooting का वह ज्ञान cover करती है जो connection को उस वक़्त चालू रखता है जब वह सबसे ज़रूरी होता है।

TradingView Alerts और Webhooks कैसे काम करते हैं

इस pipeline को तीन हिस्से बनाते हैं।

Alert वह condition है जिसे आप TradingView chart पर तय करते हैं: price का किसी level को cross करना, किसी indicator का पलटना, या किसी custom script का fire होना। अकेले यह screen पर pop-up कर सकता है, आपको email कर सकता है, या आपके phone पर push कर सकता है, और इन सबमें अभी भी आपको ही action लेना पड़ता है।

Webhook वह automation विकल्प है। जब आप इसे enable करते हैं, तो जिस पल alert trigger होता है, TradingView internet के ज़रिए आपकी चुनी हुई URL पर एक छोटा message भेज देता है, यानी alert आपको पर्ची छोड़ने के बजाय सीधे फ़ोन कर देता है।

Bot दूसरा सिरा है, यानी receiving end। Freya का signal bot एक निजी webhook URL देता है; जब message पहुँचता है, तो bot आपके connected exchange account पर वही action execute करता है जिसके लिए वह configure किया गया है।

पूरी chain:

1. आपकी chart condition TradingView पर सच हो जाती है
2. Alert fire होता है और TradingView आपके bot की webhook URL को call करता है
3. Freya signal receive करती है और आपका bot आपके exchange पर order लगा देता है
4. फिर आपका bot अपनी settings के अनुसार position को manage करता है

मुख्य मानसिक मॉडल: आपकी strategy TradingView पर रहती है; Freya execution layer है, और समय का पूरा logic आपके alert के भीतर ही होता है।

Freya का Webhook Trigger क्या करता है

Freya पर webhook execution को signal bot संभालता है, यानी वह bot type जिसे create-bot flow में "webhook signals के आधार पर trades execute करें" के रूप में बताया गया है। किसी indicator-आधारित trigger (RSI, EMA, वग़ैरह) के उलट, webhook trigger का Freya के भीतर कोई timeframe और कोई condition configure नहीं होती, यानी कब fire करना है यह फ़ैसला पूरी तरह आपके TradingView alert का होता है। Freya का काम है उसके बाद क्या होता है।

दो webhook modes हैं, और एक bot इनमें से एक ही इस्तेमाल करता है, दोनों को मिलाया नहीं जा सकता:

• TradingView Webhook (Custom Signal mode)। आपके bot को दो URLs मिलते हैं: एक Open Webhook URL और एक Close Webhook URL। Open URL पर एक message आपके Freya में configure किए गए order settings का उपयोग करके एक position खोलता है, यानी trade amount और आपका take-profit व stop-loss; Close URL पर एक message उसे बंद कर देता है।

• Risk Ratio mode। आपके bot को एक URL मिलता है। Alert message एक छोटा JSON payload होता है जो आपकी take-profit और stop-loss prices को साथ लेकर आता है; signal आने पर entry market पर ले ली जाती है। Trade amount के बजाय आप एक fixed risk amount तय करते हैं (जो stop-loss से, या विकल्प के तौर पर take-profit से जुड़ा होता है), और Freya entry-से-stop की दूरी के हिसाब से position को अपने आप size कर देती है। कोई Close URL नहीं होता क्योंकि exits खुद संभल जाते हैं: take-profit आपके signal की ठीक उसी price पर एक limit order के रूप में लगती है, और trigger होने पर stop-loss एक market order के रूप में execute होता है।

Step-by-Step: TradingView को अपने Bot से जोड़ें

Step 1: एक Signal Bot बनाएँ

Freya के Create Bot flow में Signal Bot type चुनें, फिर अपना exchange account, trading pair और direction चुनें, बिलकुल किसी भी दूसरे bot की तरह। हर screen की पूरी जानकारी Freya Finance पर Signal Bot कैसे बनाएँ में विस्तार से दी गई है।

Step 2: अपना Signal Mode चुनें

Custom Signal चुनें अगर आप trade amount, take-profit और stop-loss को Freya के भीतर configure करना चाहते हैं और चाहते हैं कि आपके alerts बस "अभी open करो" और "अभी close करो" कहें। Risk Ratio चुनें अगर आपकी strategy हर trade के लिए take-profit और stop-loss बनाती है और आप चाहते हैं कि sizing एक fixed risk amount से अपने आप हो जाए।

Step 3: अपनी Webhook URL(s) Copy करें

Strategy step पर Freya आपकी webhook URL(s) generate करती है। copy button का उपयोग करें, क्योंकि एक भी गुम अक्षर URL को बेकार कर देता है। आप किसी भी URL को बाद में regenerate कर सकते हैं, जिससे एक नई URL बनती है और पुरानी तुरंत invalid हो जाती है।

Step 4: TradingView Alert बनाएँ

अपने TradingView chart पर उस condition के साथ एक alert बनाएँ जो आपकी entry को दर्शाती है। alert की notification settings में Webhook URL विकल्प enable करें और अपने bot की URL paste करें, यानी Custom Signal mode में Open URL, या Risk Ratio mode में इकलौती URL। Custom Signal mode में alert-आधारित exits के लिए, अपनी exit condition के लिए एक दूसरा alert बनाएँ और उसे Close URL पर लगाएँ।

Step 5: Alert Message सेट करें

Alert message वह payload है जिसे TradingView आपके bot तक पहुँचाता है। ठीक उसी format का उपयोग करें जो आपके bot की setup screen देती है, यानी Risk Ratio mode में Freya एक JSON Body Template दिखाती है जिसमें one-click copy button होता है; आपके alert को वही structure अपने take-profit और stop-loss values भरकर भेजना चाहिए। मनमानी न करें: अगर message वैसा नहीं है जैसा bot अपेक्षा करता है, तो signal का अंदाज़ा लगाने के बजाय उसे नज़रअंदाज़ कर दिया जाता है।

Step 6: Live जाने से पहले Test करें

कभी भी webhook connect करके छोड़ न दें। कम से कम एक पूरा round trip छोटी रक़म के साथ चलाएँ:

1. ऐसी alert condition तय करें जिसके जल्दी trigger होने का भरोसा हो (price किसी ऐसे level को cross करे जिसे वह छूने ही वाली है)
2. उसे fire होने दें, फिर आने वाले signal event के लिए अपने bot का activity log जाँचें
3. पुष्टि करें कि आपके exchange पर position उसी size के साथ खुली जिसकी आपने उम्मीद की थी
4. close trigger करें (Close URL signal, या Risk Ratio mode में take-profit/stop-loss) और पुष्टि करें कि position सचमुच बंद हुई

एक साफ़ round trip के बाद ही अपनी असली strategy और असली size जोड़ें।

एक व्यावहारिक उदाहरण: Risk Ratio Sizing

मान लीजिए आप प्रति trade $20 का fixed risk तय करते हैं, जो stop-loss से जुड़ा है। आपका TradingView alert BTC के $100,000 पर fire होता है, और अपने message में $98,000 का stop-loss व $104,000 का take-profit लेकर आता है।

• Entry: market, $100,000 पर fill हुई
• stop-loss तक दूरी: $2,000 प्रति BTC (2%)
• Position size: $20 risk ÷ $2,000 प्रति BTC = 0.01 BTC (लगभग $1,000 का exposure)
• Take-profit: $104,000 पर limit order, अगर यह fill होता है तो profit 0.01 × $4,000 = $40, यानी जोखिम में डाले $20 के बदले 2:1 reward
• Stop-loss: अगर $98,000 trigger होता है तो market order, यानी मोटे तौर पर वही $20 जो आपने चुना, साथ में fees, और तेज़ movement में शायद थोड़ा ज़्यादा क्योंकि trigger हुआ stop market पर execute होता है

चाहे आपका stop 1% दूर हो या 5%, जोखिम में डाली गई dollar रक़म $20 ही रहती है क्योंकि size adjust हो जाता है, और यही एकरूपता Risk Ratio mode का पूरा मक़सद है।

Reliability: किस पर भरोसा किया जा सकता है और किस पर नहीं

Automation उतनी ही भरोसेमंद होती है जितनी उसकी सबसे कमज़ोर कड़ी, और webhook bots के साथ वह कड़ी अक्सर Freya के बाहर होती है।

TradingView plan की ज़रूरतें। webhook notifications हर TradingView plan में शामिल नहीं होतीं, और alert limits व expiration भी tier के हिसाब से बदलते हैं। जो alert webhooks नहीं भेज सकता वह bot के नज़रिए से चुपचाप fail हो जाता है, इसलिए अपने setup को इनके इर्द-गिर्द बनाने से पहले अपने plan के alert विकल्प जाँच लें।

देरी और outages होते रहते हैं। Freya का marketplace webhook-आधारित strategies को external-signal चेतावनी के साथ label करता है: trades को TradingView या webhook signals trigger करते हैं, और source पर देरी या outages संभव हैं। अगर TradingView में कोई incident हो, तो आपका alert कभी fire नहीं होता और bot, सही तरीके से, कुछ नहीं करता। Freya वही execute करती है जो पहुँचता है; जो कभी पहुँचता ही नहीं उसे वह execute नहीं कर सकती।

छूटे हुए close signals सबसे तीखा किनारा हैं। Custom Signal mode में, अगर आपका open signal पहुँच जाता है लेकिन close signal कभी नहीं आता, तो position खुली रह जाती है। आपके bot के order settings में configure किया गया stop-loss एक ऐसा backstop है जो किसी दूसरे webhook के पहुँचने पर निर्भर नहीं करता, और ज़्यादातर setups में इसका होना फ़ायदेमंद है।

One-shot alerts fire होना बंद कर देते हैं। "Only Once" पर trigger होने के लिए सेट किया गया TradingView alert एक signal के बाद तब तक ख़त्म हो जाता है जब तक आप उसे दोबारा न बनाएँ। किसी बार-बार चलने वाली strategy के लिए, कोई दोहराने वाला trigger विकल्प चुनें और alert की expiration date जाँच लें।

Security: आपकी Webhook URL एक राज़ है

एक webhook URL आपके bot को trigger करने की चाबी है। इसके ऊपर कोई password नहीं होता, यानी URL का पास होना ही credential है:

• किसी webhook URL को कभी share या post न करें, न alert settings के screenshot में, न किसी shared chart layout में, और न मदद माँगते हुए किसी chat message में। पहले उसे blur या crop कर दें।
• इसे सिर्फ़ उन्हीं tools में paste करें जिन पर आपका control हो, जैसे आपके अपने TradingView alerts।
• अगर exposure का शक़ हो तो तुरंत regenerate करें, पुरानी URL तत्काल काम करना बंद कर देती है। फिर अपने alerts को नई URL से update करें।

Troubleshooting: Alert Fire हुआ पर कोई Trade नहीं हुआ

वजह लगभग हमेशा एक छोटी सूची में से कोई एक होती है, इसे क्रम से जाँचें:

1. क्या bot चल रहा है? paused या stopped bot आने वाले signals को नज़रअंदाज़ कर देता है, यही सबसे आम गुनहगार है।
2. सही URL, सही जगह? Close URL पर लगा हुआ entry alert कभी position नहीं खोलेगा। Open बनाम Close की पुष्टि करें, और यह पुष्टि करें कि URL पूरी तरह paste हुई थी।
3. क्या आपने हाल ही में regenerate किया? regenerate करने से पुरानी URL तुरंत invalid हो जाती है। अगर आपके alert में अब भी पुरानी है, तो उसके messages कहीं नहीं पहुँचते।
4. क्या message format मेल खाता है? ख़ासकर Risk Ratio mode में, message को आपके bot की setup screen वाले JSON structure से मेल खाना चाहिए। ग़लत ढंग से बना message नज़रअंदाज़ कर दिया जाता है।
5. क्या आपका TradingView plan webhooks भेज भी सकता है? अगर नहीं, तो alert दिखने में trigger होता है पर कोई message नहीं भेजा जाता। यह भी जाँचें कि alert expire तो नहीं हो गया या "Only Once" पर सेट तो नहीं था।
6. Exchange minimums। अगर आपकी configure की गई रक़म, या अपने आप calculate हुआ Risk Ratio size, pair के minimum order size से कम है, तो exchange order अस्वीकार कर देता है।

Webhooks से परे bot-status की समस्याओं के लिए, देखें मेरा Bot Trade क्यों नहीं कर रहा?

अक्सर पूछे जाने वाले सवाल

क्या webhook bots इस्तेमाल करने के लिए मुझे paid TradingView plan चाहिए?

अगर TradingView आपका signal source है, तो plan tier मायने रखता है: webhook notifications हर plan का हिस्सा नहीं होतीं, और free-tier alerts की limits व expiration नियम ज़्यादा सख़्त होते हैं। अपनी automation को alerts के इर्द-गिर्द बनाने से पहले, TradingView का plan comparison खोलें और पुष्टि करें कि आपके plan में webhook notifications शामिल हैं, और अगर आप कई pairs चलाते हैं तो अपना alert allowance जाँचें। इसके बावजूद, bot की तरफ़ से इससे फ़र्क़ नहीं पड़ता कि message कौन भेजता है। Freya का signal bot किसी भी source से आने वाले webhook calls पर प्रतिक्रिया देता है, चाहे कोई दूसरा charting platform हो, आपका अपना script हो, या webhook भेजने में सक्षम कोई भी tool। यानी paid TradingView plan, TradingView के webhook feature की ज़रूरत है, Freya की नहीं। अगर आपके plan में webhooks नहीं हैं, तो आपके विकल्प हैं: upgrade करना, signal sources बदलना, या external signals के बजाय indicator-आधारित triggers के साथ logic को Freya के भीतर बनाना।

Open और Close webhook URLs में क्या फ़र्क़ है?

Custom Signal mode में, आपका bot दो अलग-अलग कामों वाली दो अलग URLs देता है। Open Webhook URL पर एक message आपके Freya में configure किए गए order settings का उपयोग करके एक position खोलता है, यानी trade amount के साथ आपका कोई भी take-profit और stop-loss। Close Webhook URL पर एक message bot की खुली हुई position को बंद कर देता है। ये आपस में बदले नहीं जा सकते, यानी Close URL पर लगा entry alert कभी trade नहीं खोलेगा। Risk Ratio mode अलग तरह से काम करता है, यहाँ सिर्फ़ एक URL होती है जो entry signal के लिए इस्तेमाल होती है, और कोई Close URL नहीं होती क्योंकि exit को webhook message में साथ आए take-profit और stop-loss अपने आप संभालते हैं। दोनों URLs को अलग-अलग copy और regenerate किया जा सकता है; regenerate करने से एक नई URL बनती है और पुरानी तुरंत invalid हो जाती है, इसलिए उसके बाद संबंधित TradingView alert को update करें।

क्या मेरा TradingView alert take-profit और stop-loss सेट कर सकता है?

हाँ, Risk Ratio mode इसी के लिए है। उस mode में, आपका alert message एक छोटा JSON payload होता है जो take-profit और stop-loss prices को साथ लेकर आता है, और Freya की setup screen वह JSON Body Template देती है जिसे आप अपने alert में copy करते हैं। signal आने पर entry market price पर ले ली जाती है, और exits आपके signal की values से लगते हैं: take-profit उसी सटीक price पर एक limit order के रूप में जो आपने भेजी, और stop-loss उसकी trigger price पर पहुँचते ही एक market order के रूप में। चूँकि stop market पर execute होता है, यह किसी भी stop order की तरह तेज़ movement में slippage झेल सकता है। Custom Signal mode में, webhook exit levels सेट नहीं कर सकती; take-profit और stop-loss उन order settings से आते हैं जिन्हें आप Freya के भीतर configure करते हैं, और आपके alerts सिर्फ़ इतना बता पाते हैं कि कब open करना है और कब close।

क्या TradingView में अपनी webhook URL paste करना सुरक्षित है?

URL को अपने ही TradingView alert में paste करना उसका इच्छित उपयोग है, यानी integration जैसा design किया गया है वैसा काम कर रहा है। असली जोखिम exposure है, paste करना नहीं। एक webhook URL के ऊपर कोई password नहीं होता: जिसके पास URL है वह आपके bot पर वह action trigger कर सकता है। आम leak के रास्ते मामूली होते हैं: chat में share किया गया alert settings का screenshot, मदद माँगती कोई public post, या कोई shared chart layout। हर URL को password की तरह मानें: उसे screenshots से बाहर रखें, किसी के साथ share न करें, और सिर्फ़ उन्हीं tools में paste करें जिन पर आपका ख़ुद का control हो। अगर आपको कभी शक़ हो कि किसी और ने URL देख ली है, तो तुरंत उसे regenerate करें, पुरानी URL उसी पल काम करना बंद कर देती है जब नई बनती है, और फिर अगले signal के fire होने से पहले अपने alert को नई URL से update करें।

मेरा alert fire हुआ पर कोई trade क्यों नहीं हुआ?

bot से ही शुरू करें: paused या stopped bot signals को पूरी तरह नज़रअंदाज़ कर देता है, यही सबसे आम वजह है। इसके बाद plumbing जाँचें: alert में सही और पूरी URL होनी चाहिए (entries के लिए Open, Close नहीं), और अगर आपने हाल ही में regenerate किया है, तो alert शायद अब भी मृत URL पर लगा हो। फिर message जाँचें: ख़ासकर Risk Ratio mode में, payload को आपके bot की setup screen वाले JSON template से मेल खाना चाहिए, वरना signal नज़रअंदाज़ हो जाता है। TradingView की तरफ़, पुष्टि करें कि आपका plan सचमुच webhooks भेजता है और alert न तो expire हुआ है और न उसका इकलौता "Only Once" shot fire हो चुका है। आख़िर में, अगर आपकी रक़म, या अपने आप calculate हुआ Risk Ratio size, उस pair के लिए exchange के minimum से कम है, तो order अस्वीकार हो जाता है। आपके bot का activity log बताता है कि कौन-सा सिरा fail हुआ: log किया गया signal execution की समस्या दर्शाता है; कोई log entry न होना यह बताता है कि signal कभी पहुँचा ही नहीं।

क्या मेरे signals का TradingView से आना ज़रूरी है?

नहीं। TradingView सबसे लोकप्रिय source है क्योंकि इसका alert system लचीला और chart-आधारित है, लेकिन Freya का signal bot origin की परवाह किए बिना webhook calls पर प्रतिक्रिया देता है। webhook भेजने में सक्षम कोई भी tool काम करता है: कोई दूसरा charting platform, कोई custom script, webhook notifications वाला कोई screener, या कोई in-house signal system। हर हाल में contract एक जैसा रहता है, यानी Custom Signal mode में Open या Close URL को call करें, या Risk Ratio mode में इकलौती URL पर अपेक्षित JSON payload को take-profit और stop-loss values के साथ भेजें। किसी भी source पर दो चेतावनियाँ लागू होती हैं। पहली, reliability का सवाल ख़त्म नहीं होता: आपका bot सिर्फ़ उन्हीं signals को execute कर सकता है जो सचमुच पहुँचते हैं, इसलिए आपके source की uptime ही आपकी strategy की uptime है। दूसरी, security का नियम सार्वभौमिक है, यानी आप जो भी tool इस्तेमाल करें, webhook URL सिर्फ़ उन्हीं systems में जाए जिन पर आपका control और भरोसा हो।

आगे कहाँ जाएँ

एक webhook bot उतना ही अच्छा होता है जितनी उसे feed करने वाली strategy। अपने signal logic को इतिहास के ख़िलाफ़ परखें, देखें अपनी Crypto Trading Strategy को Backtest कैसे करें, और अगर आपने कोई setup का हिस्सा छोड़ दिया हो तो पूरा walkthrough पढ़ें Freya Finance पर Signal Bot कैसे बनाएँ में। अगर आप entry logic को Freya के भीतर ही बनाना पसंद करें, तो DCA Bot Strategy Guide उस तरीक़े को गहराई से cover करती है। और custody व API-key permissions के सवालों के लिए, देखें क्या Freya Finance पर मेरा पैसा सुरक्षित है?