التوثيق

محرّك المخاطر ومرجع Webhook

كيف تتحقّق AlgoVesta من كل إشارة قبل التنفيذ، وحمولة JSON الدقيقة التي تُرسَل من TradingView أو أي مصدر webhook. أسماء الحقول حرفية — انسخها كما هي.

تنفّذ AlgoVesta الصفقات من ثلاث قنوات تفعيل: خادم MCP لمساعدات الذكاء الاصطناعي، وإشارات Telegram، وwebhooks منصة TradingView. أياً كانت القناة التي تُفعَّل، يتحقق محرك المخاطر نفسه على جانب الخادم من الأمر قبل وصوله إلى منصتك أو حساب MetaTrader 5. هذه الصفحة هي المركز المرجعي التقني للقنوات الثلاث.

ثلاث طرق لتفعيل صفقة

تنتهي كل قناة بنفس مسار التنفيذ: التحقق، ثم تحديد الحجم، ثم الأمر، ثم وضع وقف الخسارة وجني الأرباح على المنصة نفسها. اختر القناة التي تناسب طريقة عملك الحالية.

خادم MCP لمساعدات الذكاء الاصطناعي

اربط Claude أو ChatGPT أو Cursor أو أي عميل يدعم MCP بعشرين أداة تداول أصلية عبر رابط واحد موثّق. يبدأ كل اتصال برصيد paper بقيمة 5,000$، وتُنشأ مفاتيح التداول الحي بشكل منفصل بعامل تحقق ثانٍ. المصادقة إما عبر OAuth 2.1 مع PKCE (S256) أو رابط سري خاص بكل مستخدم.

مرجع مطوّري MCP اربط مساعد ذكاء اصطناعي

قنوات إشارات Telegram

وجّه AlgoVesta نحو قنوات الإشارات التي تتابعها بالفعل. تُحلَّل الرسائل إلى رمز، واتجاه، ونقطة دخول، ووقف خسارة، وأهداف، ثم تُنفَّذ على منصتك أو تُحوَّل إلى MetaTrader 5. الإشارات التي يتعذّر تحليلها بوضوح تامّ تُرفض بدلاً من التخمين.

من Telegram إلى MetaTrader 5 اربط قناة Telegram

webhooks منصة TradingView

أرسل تنبيهاً من أي مؤشر، أو رسم، أو استراتيجية Pine إلى رابط webhook الخاص بك. يجب أن يكون نص التنبيه بصيغة JSON صحيحة وفق التنسيق الموثّق أدناه، ويُتحقَّق من مصدر كل إشارة تُنفَّذ تلقائياً قبل فتح الأمر.

أتمتة TradingView مرجع الحمولة

محرّك المخاطر: كيف يُتحقَّق من الإشارة

لا تُنفَّذ الإشارة أبدًا بشكل أعمى. قبل تنفيذ أي أمر، تمرّ عبر طبقة تحقّق متعددة الوحدات تقارنها بظروف السوق الحية والحدود التي تحدّدها. إذا فشلت قاعدة صارمة، تُرفَض الإشارة — لا تُصغَّر.

التقييم العصبي — درجة ثقة من 0–100 من نموذج تقييم.

الحجم وتدفّق الأوامر — قفزات الحجم واختلال الصفقات العدوانية (VPIN).

نظام السوق — تصنيف اتجاه / نطاق / عودة إلى المتوسط.

التمويل والتصفية — ديناميكيات معدّل التمويل وتجمّعات التصفية.

تخطيط وقف الخسارة — يتجنّب وضع الأوامر داخل تجمّعات سيولة معروفة.

قواعدك الصارمة — الاتجاه وساعات الجلسة وحدود المركز والتراجع.

تتطوّر مجموعة الوحدات والعتبات الدقيقة مع ضبط المنصّة. المبدأ ثابت: تُطبَّق قواعدك وحدود المخاطر دائمًا قبل أن يصل الأمر إلى منصّتك.

الخسارة اليومية وحماية السحب

إلى جانب فحوصات كل إشارة، تعمل حمايتان على مستوى الحساب باستمرار.

حد الخسارة اليومية — عندما تبلغ خسارتك المحقّقة لليوم الحد الذي حددته — نسبة من الرصيد أو مبلغ ثابت — تدخل AlgoVesta الوضع الآمن وتتوقف عن فتح صفقات جديدة حتى اليوم التالي.

تحجيم حسب السحب — مع نمو سحب الحساب، يُقلَّص حجم المركز تلقائيًا على مراحل (حذر → دفاعي → البقاء)، بحيث تقلّل سلسلة الخسائر تعرّضك بدلًا من مضاعفته.

مرجع حمولة Webhook

أرسل طلب HTTP POST بجسم JSON إلى رابط webhook الخاص بك في AlgoVesta. من 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`. يُرسل إلى MetaTrader 5 عند ضبطه على forex. ولا يُستنتج أبدًا من الرمز.
`lots`	اختياري	للفوركس فقط — حجم المركز باللوت. اتركه فارغًا لاستخدام وضع اللوت/المخاطرة الذي أعددته.
`leverage`	اختياري	للعملات الرقمية فقط — يُطبَّق حد منصتك لذلك الرمز.
`amount_usd`	اختياري	للعملات الرقمية فقط — الهامش وليس القيمة الاسمية. القيمة الاسمية = الهامش × الرافعة.
`risk_percent`	اختياري	للعملات الرقمية فقط — نسبة الرصيد المعرضة للمخاطرة (0.1–50%).
`quantity`	اختياري	للعملات الرقمية فقط — كمية العقود بالضبط. تُقبل `qty` و`size` و`contracts` كأسماء بديلة.
`take_profits`	اختياري	أهداف متعددة: `[{"price":…, "close_pct":…}]`. كما تعمل `tp1`…`tp5` مع `tpN_close`.
`trailing`	اختياري	`{"trigger_pct":…, "distance_pct":…}` — وقف خسارة متحرك.
`breakeven`	اختياري	`true` أو `{"trigger_pct":…}` — ينقل الوقف إلى سعر الدخول بمجرد تحقيق ربح.

تُزال بادئات المنصة، لذا يعمل BINANCE:BTCUSDT تمامًا مثل BTCUSDT. وفي حقل الاتجاه تُقبل direction وtype كأسماء بديلة لـ action، وclose قيمة صالحة.

يمكن أن يأتي حجم مركزك ورافعتك ومخاطرة كل إشارة من لوحتك أو من الحمولة — وتُعطى الأولوية للقيمة الموجودة في الحمولة. لهذا رابط webhook هو سرّ: أضف قائمة IP مسموح بها حتى لا يتداول AlgoVesta تلقائيًا إلا الإشارات التي يمكنه التحقق من مصدرها.

إغلاق مركز

أرسل "action": "close" مع الرمز. يُغلق المركز بالكامل على ذلك الرمز — الإغلاق الجزئي غير مدعوم؛ وإذا طلبته فسيُغلق المركز بالكامل وتوضّح اللوحة ذلك.

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

تنبيهات استراتيجية Pine — عمليات الخروج تلقائية

إذا أنشأت التنبيه من strategy() في Pine مع خيار “Order fills only”، فلا ترسل 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. يرسل TradingView نص التنبيه كنص عادي إذا لم يكن JSON صالحًا — والرسالة الافتراضية (مثل “BTCUSDT Crossing 1.00”) لا تحمل اتجاهًا ولذلك تُرفض. نحن لا نخمّن أبدًا من نص غامض؛ فرفض الإشارة أكثر أمانًا من فتح أمر في الاتجاه الخاطئ. لاحظ أيضًا أن TradingView يوقف التنبيهات تلقائيًا بعد 15 تفعيلًا خلال 3 دقائق.

بدون برمجة

لا تكتب JSON يدويًا — أنشئه بصريًا

اضبط الاتجاه وجني الأرباح / وقف الخسارة (مستوى واحد أو متعدد) والرافعة وحجم المركز والتتبّع ونقطة التعادل عبر مفاتيح بسيطة. تُنشئ AlgoVesta رسالة تنبيه TradingView الدقيقة — انسخها والصقها في تنبيهك.

شاهد كيف يعمل المُنشئ المرئي → إعداد التنبيه خطوة بخطوة →

الأسئلة الشائعة

ما القنوات التي يمكنها تفعيل صفقة على AlgoVesta؟

ثلاث: خادم MCP الذي تستخدمه مساعدات الذكاء الاصطناعي، وقنوات إشارات Telegram، وwebhooks منصة TradingView. يمكن أيضاً فتح الصفقة يدوياً من لوحة التحكم. تمر كل قناة عبر نفس مسار التنفيذ ونفس فحوصات المخاطر.

هل صيغة JSON للـwebhook إلزامية لـTradingView؟

نعم. ترسل TradingView نص التنبيه كنص عادي عندما لا يكون بصيغة JSON صحيحة، ورسالة التنبيه الافتراضية لا تحمل اتجاهاً، لذلك تُرفض. استخدم تنسيق الحمولة الموثّق في مرجع حمولة الـwebhook أعلاه، أو أنشئه بصرياً والصق النتيجة في تنبيهك.

هل يُطبَّق محرك المخاطر أيضاً على أوامر MCP وTelegram؟

نعم — تعمل نفس فحوصات جانب الخادم على كل قناة. تُطبَّق سياسة المخاطر الخاصة بك، وشرط وقف الخسارة الإلزامي، وحدود المراكز والتراجع، قبل وصول الأمر إلى المنصة — سواء جاء الأمر من مساعد ذكاء اصطناعي، أو إشارة Telegram، أو تنبيه TradingView. لا يمكن لأي prompt أو رسالة أن يُضعفها.

أين أجد المرجع الكامل لأدوات MCP؟

يوثّق مرجع مطوّري MCP جميع الأدوات الـ20، والنطاقات الثلاثة، والمصادقة عبر OAuth 2.1 والرابط السري، وحدود معدل الطلبات، ورموز الأخطاء، والمنصات الـ16 المدعومة بالإضافة إلى MetaTrader 5.

هل يمكنني التجربة بدون أموال حقيقية؟

نعم. يبدأ كل اتصال MCP برصيد paper افتراضي بقيمة 5,000$ بأسعار سوق حقيقية، ولأتمتة TradingView وTelegram كلتيهما وضع تجريبي يحاكي المسار الكامل من الإشارة إلى الأمر. يتطلب التداول الحقيقي دائماً مفتاحاً أو اتصالاً منفصلاً يُنشأ صراحةً.