दस्तावेज़

रिस्क इंजन और Webhook संदर्भ

AlgoVesta निष्पादन से पहले हर सिग्नल को कैसे सत्यापित करता है, और TradingView या किसी भी webhook स्रोत से भेजने के लिए सटीक JSON payload। फ़ील्ड नाम शाब्दिक हैं — उन्हें जैसे हैं वैसे कॉपी करें।

AlgoVesta तीन ट्रिगर चैनल से ट्रेड एग्ज़िक्यूट करता है: AI असिस्टेंट के लिए एक MCP सर्वर, Telegram सिग्नल, और TradingView वेबहुक। कोई भी चैनल क्यों न ट्रिगर हो, वही सर्वर-साइड रिस्क इंजन ऑर्डर को आपके एक्सचेंज या MetaTrader 5 खाते तक पहुंचने से पहले वेरिफ़ाई करता है। यह पेज तीनों के लिए तकनीकी रेफ़रेंस हब है।

ट्रेड ट्रिगर करने के तीन तरीके

हर चैनल एक ही एग्ज़िक्यूशन पाथ पर खत्म होता है: वेरिफ़िकेशन, साइज़िंग, ऑर्डर, फिर एक्सचेंज पर ही स्टॉप-लॉस और टेक-प्रॉफिट लगाना। वह चैनल चुनें जो आपके पहले से काम करने के तरीके से मेल खाता हो।

AI असिस्टेंट के लिए MCP सर्वर

Claude, ChatGPT, Cursor या किसी भी MCP-सक्षम क्लाइंट को एक ऑथेंटिकेटेड लिंक से बीस नेटिव ट्रेडिंग टूल से जोड़ें। हर कनेक्शन $5,000 के paper बैलेंस से शुरू होता है, और लाइव कीज़ अलग से, सेकंड फ़ैक्टर के साथ बनाई जाती हैं। ऑथेंटिकेशन या तो PKCE (S256) के साथ OAuth 2.1 से होता है या प्रति-यूज़र सीक्रेट लिंक से।

Telegram सिग्नल चैनल

AlgoVesta को उन सिग्नल चैनलों की ओर पॉइंट करें जिन्हें आप पहले से फ़ॉलो करते हैं। मैसेज को सिंबल, दिशा, एंट्री, स्टॉप-लॉस और टारगेट में पार्स किया जाता है, फिर आपके एक्सचेंज पर एग्ज़िक्यूट या MetaTrader 5 पर फ़ॉरवर्ड किया जाता है। जिन सिग्नल को बिना किसी संदेह के पार्स नहीं किया जा सकता, उन्हें अंदाज़ा लगाने के बजाय रिजेक्ट कर दिया जाता है।

TradingView वेबहुक

किसी भी इंडिकेटर, ड्रॉइंग या Pine स्ट्रैटेजी से अपने प्राइवेट वेबहुक URL पर अलर्ट भेजें। अलर्ट बॉडी नीचे बताए गए फ़ॉर्मैट में वैध JSON होनी चाहिए, और हर ऑटो-ट्रेडेड सिग्नल का सोर्स ऑर्डर खुलने से पहले वेरिफ़ाई किया जाता है।

रिस्क इंजन: एक सिग्नल कैसे सत्यापित होता है

कोई सिग्नल कभी आँख मूँदकर निष्पादित नहीं होता। किसी भी ऑर्डर से पहले, यह एक बहु-मॉड्यूल सत्यापन परत से गुज़रता है जो इसे लाइव बाज़ार स्थितियों और आपकी तय सीमाओं के विरुद्ध जाँचती है। यदि कोई कठोर नियम विफल हो, तो सिग्नल घटाया नहीं — अस्वीकार किया जाता है।

न्यूरल स्कोरिंगस्कोरिंग मॉडल से 0–100 का विश्वास स्कोर।
वॉल्यूम और ऑर्डर-फ़्लोवॉल्यूम स्पाइक और आक्रामक-ट्रेड असंतुलन (VPIN)।
मार्केट रीजीमट्रेंड बनाम रेंज बनाम मीन-रिवर्ज़न वर्गीकरण।
फंडिंग और लिक्विडेशनफंडिंग-रेट गतिकी और लिक्विडेशन क्लस्टर।
स्टॉप-लॉस मैपिंगज्ञात लिक्विडिटी क्लस्टर के अंदर स्टॉप रखने से बचता है।
आपके कठोर नियमदिशा, सत्र घंटे, पोजीशन और ड्रॉडाउन सीमाएँ।

सटीक मॉड्यूल सेट और थ्रेशोल्ड प्लेटफ़ॉर्म ट्यूनिंग के साथ बदलते हैं। सिद्धांत स्थिर है: ऑर्डर आपके एक्सचेंज तक पहुँचने से पहले आपके नियम और जोखिम सीमाएँ हमेशा लागू होती हैं।

दैनिक हानि और ड्रॉडाउन सुरक्षा

प्रति-सिग्नल जाँच के अलावा, खाता-स्तर की दो सुरक्षाएँ निरंतर चलती हैं।

दैनिक हानि सीमाजब दिन की आपकी वास्तविक हानि आपकी निर्धारित सीमा — बैलेंस का प्रतिशत या एक निश्चित राशि — तक पहुँचती है, तो AlgoVesta सेफ मोड में चला जाता है और अगले दिन तक नए ट्रेड खोलना बंद कर देता है।
ड्रॉडाउन-आधारित साइज़िंगजैसे-जैसे खाता ड्रॉडाउन बढ़ता है, पोजीशन आकार चरणों में (सतर्क → रक्षात्मक → सर्वाइवल) स्वतः घटाया जाता है, ताकि हार का सिलसिला आपके एक्सपोज़र को बढ़ाने के बजाय घटाए।

Webhook payload संदर्भ

अपने AlgoVesta webhook URL पर JSON बॉडी के साथ एक HTTP POST भेजें। TradingView में, इसे अलर्ट मैसेज बॉक्स में पेस्ट करें। फ़ील्ड नाम बिल्कुल मेल खाने चाहिए।

# POST https://api.algovesta.com/webhook/<your-token> { "symbol": "BTCUSDT", "side": "buy", "price": 64250.0, "stop_loss": 63800.0, "take_profit": 65100.0 }
फ़ील्डआवश्यकविवरण
symbolहाँएक्सचेंज ट्रेडिंग पेयर, जैसे BTCUSDT।
side / actionहाँऑर्डर दिशा: buy या sell।
priceवैकल्पिकएंट्री संदर्भ मूल्य; मार्केट एंट्री के लिए छोड़ दें।
stop_lossवैकल्पिकस्टॉप-लॉस मूल्य। हर सिग्नल पर अनुशंसित।
take_profitवैकल्पिकटेक-प्रॉफ़िट मूल्य। ऐप में कई लक्ष्य कॉन्फ़िगर करने योग्य।
marketवैकल्पिकलक्ष्य बाज़ार: crypto (डिफ़ॉल्ट) या forex। forex पर सेट होने पर MetaTrader 5 को भेजा जाता है। इसका अनुमान कभी सिंबल से नहीं लगाया जाता।
lotsवैकल्पिककेवल forex — लॉट में पोज़िशन का आकार। अपना कॉन्फ़िगर किया हुआ लॉट/जोखिम मोड इस्तेमाल करने के लिए इसे खाली छोड़ें।
leverageवैकल्पिककेवल crypto — उस सिंबल के लिए आपके एक्सचेंज की सीमा लागू होती है।
amount_usdवैकल्पिककेवल crypto — मार्जिन, नोशनल नहीं। नोशनल = मार्जिन × लीवरेज।
risk_percentवैकल्पिककेवल crypto — जोखिम में डालने के लिए बैलेंस का % (0.1–50)।
quantityवैकल्पिककेवल crypto — कॉन्ट्रैक्ट की सटीक मात्रा। qty, size और contracts उपनाम के रूप में स्वीकार किए जाते हैं।
take_profitsवैकल्पिकएक से अधिक लक्ष्य: [{"price":…, "close_pct":…}]tpN_close के साथ tp1tp5 भी काम करता है।
trailingवैकल्पिक{"trigger_pct":…, "distance_pct":…} — ट्रेलिंग स्टॉप।
breakevenवैकल्पिकtrue या {"trigger_pct":…} — मुनाफ़े में आते ही स्टॉप को एंट्री पर ले जाता है।

एक्सचेंज उपसर्ग हटा दिए जाते हैं, इसलिए BINANCE:BTCUSDT ठीक BTCUSDT की तरह काम करता है। दिशा वाले फ़ील्ड में direction और type को action के उपनाम के रूप में स्वीकार किया जाता है, और close एक मान्य मान है।

पोजीशन आकार, लीवरेज और प्रति-सिग्नल जोखिम आपके डैशबोर्ड से या payload से आ सकते हैं — payload में मौजूद मान को प्राथमिकता दी जाती है। इसीलिए वेबहुक URL एक सीक्रेट है: एक IP allowlist जोड़ें ताकि AlgoVesta केवल उन्हीं सिग्नल को ऑटो-ट्रेड करे जिनका स्रोत वह सत्यापित कर सके।

पोज़िशन बंद करना

सिंबल के साथ "action": "close" भेजें। उस सिंबल की पूरी पोज़िशन बंद कर दी जाती है — आंशिक क्लोज़ समर्थित नहीं है; अगर आप आंशिक क्लोज़ माँगते हैं तो भी पूरी पोज़िशन बंद होती है और पैनल यह बात बताता है।

{ "symbol": "BTCUSDT", "action": "close" }

Pine स्ट्रैटेजी अलर्ट — एग्ज़िट अपने आप संभाले जाते हैं

अगर आप “Order fills only” वाले Pine strategy() से अलर्ट बनाते हैं, तो अकेले action भेजें: {{strategy.order.action}} एग्ज़िट पर भी sell लौटाता है, जिससे पोज़िशन बंद होने के बजाय एक शॉर्ट खुल जाएगा। पोज़िशन-स्थिति वाले फ़ील्ड शामिल करें और AlgoVesta आपके लिए एंट्री, एग्ज़िट और रिवर्सल तय कर लेगा।

{ "symbol": "{{ticker}}", "action": "{{strategy.order.action}}", "market_position": "{{strategy.market_position}}", "prev_market_position": "{{strategy.prev_market_position}}", "position_size": "{{strategy.position_size}}" }
फ़िल के बाद पोज़िशनAlgoVesta क्या करता है
flat (or position_size = 0)पोज़िशन बंद कर देता है। कोई उल्टा ऑर्डर नहीं खोला जाता।
पिछली स्थिति के विपरीतरिवर्सल — पहले बंद करता है, फिर नई दिशा में खोलता है। अगर बंद करना विफल हो जाए तो कुछ भी नहीं खोला जाता।
पहले जैसी ही दिशाइसे उस दिशा में एक एंट्री माना जाता है।

संदेश JSON होना चाहिए। जब सामग्री मान्य JSON नहीं होती, तो TradingView अलर्ट बॉडी को सादे टेक्स्ट के रूप में भेजता है — उसका डिफ़ॉल्ट संदेश (जैसे “BTCUSDT Crossing 1.00”) दिशा नहीं बताता और अस्वीकार कर दिया जाता है। हम अस्पष्ट टेक्स्ट पर कभी अनुमान नहीं लगाते; गलत दिशा में ऑर्डर खोलने से बेहतर है सिग्नल अस्वीकार करना। यह भी ध्यान रखें कि TradingView 3 मिनट में 15 बार ट्रिगर होने के बाद अलर्ट अपने आप रोक देता है।

नो-कोड बिल्डर
JSON हाथ से न लिखें — इसे विज़ुअली बनाएं

दिशा, टेक-प्रॉफ़िट / स्टॉप-लॉस (एकल या बहु-स्तरीय), लीवरेज, पोजीशन आकार, ट्रेलिंग और ब्रेकईवन को सरल टॉगल से सेट करें। AlgoVesta सटीक TradingView अलर्ट संदेश बनाता है — इसे कॉपी करके अपने अलर्ट में पेस्ट करें।

देखें विज़ुअल बिल्डर कैसे काम करता है → स्टेप-बाय-स्टेप अलर्ट सेटअप →

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

AlgoVesta पर कौन-से चैनल ट्रेड ट्रिगर कर सकते हैं?

तीन: AI असिस्टेंट के लिए इस्तेमाल होने वाला MCP सर्वर, Telegram सिग्नल चैनल, और TradingView वेबहुक। एक ट्रेड आपके डैशबोर्ड से मैन्युअली भी खोला जा सकता है। हर चैनल एक ही एग्ज़िक्यूशन पाथ और एक ही रिस्क जांच से होकर गुज़रता है।

क्या TradingView के लिए वेबहुक JSON फ़ॉर्मैट ज़रूरी है?

हां। जब अलर्ट बॉडी वैध JSON नहीं होती तो TradingView उसे प्लेन टेक्स्ट के रूप में भेजता है, और इसका डिफ़ॉल्ट अलर्ट मैसेज कोई दिशा नहीं बताता, इसलिए इसे रिजेक्ट कर दिया जाता है। ऊपर वेबहुक पेलोड रेफ़रेंस में बताए गए पेलोड फ़ॉर्मैट का इस्तेमाल करें, या इसे विज़ुअली बनाएं और नतीजे को अपने अलर्ट में पेस्ट करें।

क्या रिस्क इंजन MCP और Telegram ऑर्डर पर भी लागू होता है?

हां — हर चैनल पर एक ही सर्वर-साइड जांच चलती है। आपकी रिस्क पॉलिसी, स्टॉप-लॉस की अनिवार्यता, और आपकी पोज़िशन व ड्रॉडाउन लिमिट को ऑर्डर के किसी एक्सचेंज तक पहुंचने से पहले लागू किया जाता है — चाहे ऑर्डर AI असिस्टेंट से आया हो, Telegram सिग्नल से हो या TradingView अलर्ट से। बातचीत का कोई भी शब्द इन्हें कमज़ोर नहीं कर सकता।

पूरा MCP टूल रेफ़रेंस कहां मिलेगा?

MCP डेवलपर रेफ़रेंस सभी 20 टूल, तीन स्कोप, OAuth 2.1 और सीक्रेट-लिंक ऑथेंटिकेशन, रेट लिमिट, एरर कोड और समर्थित 16 एक्सचेंज व MetaTrader 5 का दस्तावेज़ीकरण करता है।

क्या मैं असली पैसे के बिना टेस्ट कर सकता हूं?

हां। हर MCP कनेक्शन असली मार्केट कीमतों के साथ $5,000 वर्चुअल paper बैलेंस से शुरू होता है, और TradingView व Telegram दोनों की ऑटोमेशन में एक डेमो मोड है जो सिग्नल-से-ऑर्डर तक का पूरा फ़्लो सिम्युलेट करता है। लाइव ट्रेडिंग के लिए हमेशा एक अलग, साफ़ तौर पर बनाई गई की या कनेक्शन ज़रूरी होता है।