← كل المقالات مدونة TheConnector

JSON الخاص بـ webhook من TradingView: مرجع payload ثابت

حقول payload واضح وقابل للمراجعة لـ webhook من TradingView — action وsymbol والحساب والمنصة والمخاطرة — مع مثال Pine Script والأخطاء الشائعة.

2026-05-12 1 دقيقة قراءة webhook JSON TradingView Pine Script payload

TheConnector أداة تقنية للتوجيه والأتمتة. تبقى الاستراتيجية وإعدادات حساب الوسيط ومخاطر التداول تحت تحكم المستخدم.

لماذا يهم وجود مخطط ثابت

يصبح الـ webhook أجدر بالثقة حين تكون الرسالة واضحة. payload JSON ثابت يمكن قراءته وتسجيله ومراجعته بعد أشهر. يستخدم TheConnector JSON بسيطاً عن قصد: لا لغة خاصة ولا قواعد تحليل مخفية.

الحقول الأساسية

payload صغير ومفيد يصف الإجراء ووجهته.

{
  "action": "buy",
  "symbol": "EURUSD",
  "account": "MY_ACCOUNT",
  "platform": "mt5",
  "risk": "1",
  "sl": "20",
  "tp": "40"
}

حقلاً بحقل

  • action: buy أو sell أو أمر إغلاق
  • symbol: رمز TradingView، يُربط برمز الوسيط عبر حسابك
  • account: أي حساب متصل يجب أن يستقبله
  • platform: mt4 أو mt5 أو ctrader عند الحاجة للتحديد
  • risk: وحدة المخاطرة لديك، تُفسَّر وفق قواعد الحساب
  • sl وtp: مسافتا وقف الخسارة وجني الأرباح اختياريتان

إرساله من Pine Script

ابنِ الـ JSON كنص وأرسله فقط عند تأكُّد الشرط.

//@version=5
indicator("Webhook payload", overlay=true)
longSignal = ta.crossover(ta.sma(close, 20), ta.sma(close, 50))
if longSignal and barstate.isconfirmed
    alert("{\"action\":\"buy\",\"symbol\":\"EURUSD\",\"account\":\"MY_ACCOUNT\",\"platform\":\"mt5\",\"risk\":1,\"sl\":20,\"tp\":40}", alert.freq_once_per_bar_close)

حافظ على الاتساق

  • استخدم أسماء الحقول نفسها دائماً
  • قرّر مرة واحدة هل الأرقام بين علامتي اقتباس والتزم بذلك
  • أرسل تنبيهاً واحداً لكل إغلاق شمعة ما لم تُصمَّم الاستراتيجية لغير ذلك
  • لا تضع أسراراً في payload؛ مفتاح الوصول موجود في رابط webhook

أخطاء شائعة

  • JSON غير صالح، مثل علامة اقتباس ناقصة أو فاصلة زائدة
  • رمز بلا ربط لدى الوسيط
  • قيمة مخاطرة لا تناسب قواعد الحساب
  • عدة تنبيهات على الشمعة نفسها تتجاوز حصة الخطة

المخاطر والحدود

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