Tradewaysdocs
الاستيراد التلقائي

Interactive Brokers

اربط Interactive Brokers مرة واحدة باستخدام رمز Flex Web Service المميز واستعلامي Flex. يستورد Tradeways تنفيذات الأسهم وصناديق ETF وForex الجديدة وفق جدول زمني.

Interactive Brokers

اربط Interactive Brokers مرة واحدة وسيستورد Tradeways تنفيذاتك تلقائيًا. لا يوجد ما يجب تثبيته ولا يلزم أن يكون جهازك قيد التشغيل: ينزّل Tradeways وفق جدول زمني تقارير Flex التي أعددتها في Interactive Brokers.

الاتصال للقراءة فقط. يستطيع رمز Flex Web Service المميز تنزيل تقارير Flex التي هيّأتها فقط. ولا يستطيع تنفيذ أوامر ولا تحويل أموال.

يستغرق الإعداد نحو عشر دقائق. تُنشئ ثلاثة أشياء في Interactive Brokers وتلصقها في Tradeways:

ما هوشكلهالغرض منه
رمز Flex Web Service المميزرقم طويل، نحو 25 رقمًايتيح لـ Tradeways تنزيل تقاريرك
معرّف Activity Flex Queryرقم قصير، نحو 7 أرقامتقرير يومي: التصحيحات والعمولات والمراكز المفتوحة
معرّف Trade Confirmation Flex Queryرقم قصير، نحو 7 أرقامتقرير اليوم نفسه: التنفيذات الجديدة

كل ذلك موجود في Interactive Brokers ضمن Performance & Reports → Flex Queries. الصور أدناه من تطبيق Interactive Brokers للجوال، حيث تسمى هذه الصفحة Trade Reports. تعرض بوابة العملاء على سطح المكتب الحقول نفسها.

لجلب السجل السابق للاتصال، أو للاستيراد بدون رمز مميز، راجع استيراد ملفات Interactive Brokers.

إعداد Interactive Brokers

1. تفعيل Flex Web Service وإنشاء الرمز المميز

افتح Flex Queries وانقر على أيقونة الترس بجانب Flex Web Service Configuration.

Configure Flex Web Service: فعّل الخدمة، واترك عنوان IP فارغًا، وأنشئ رمزًا مميزًا جديدًا

  1. فعّل Flex Web Service Status.
  2. اترك Valid for IP Address فارغًا. لا يتصل Tradeways من عنوان ثابت، لذلك يُرفض الرمز المميز المقيّد بعنوان IP.
  3. انقر على Generate New Token واختر مدة صلاحيته. اختر أطول مدة حتى لا تضطر إلى استبداله قريبًا.

انسخ الرمز المميز. إنشاء رمز آخر لاحقًا يُبطل هذا الرمز؛ وعند ذلك استبدل بيانات الاعتماد في Tradeways.

2. إنشاء استعلامي Flex

في صفحة Flex Queries، لكل نوع استعلام زر + خاص به.

صفحة Flex Queries مع زري + لـ Activity Flex Query وTrade Confirmation Flex Query

Activity Flex Query (1). في البوابة الألمانية يسمى Kontoumsatz-Flex-Query.

  1. أعطه اسمًا، مثل Tradeways.
  2. أضف قسم Trades. اختر Executions مستوى للتفاصيل وحدد جميع الحقول.
  3. أضف قسم Open Positions. اختر Summary مستوى للتفاصيل وحدد جميع الحقول.
  4. اضبط التنسيق على XML. الفترة غير مهمة: يحدد Tradeways التواريخ في كل طلب.
  5. اضبط الإعدادات العامة كما في الخطوة 3، ثم احفظ.

Trade Confirmation Flex Query (2). في البوابة الألمانية يسمى Handelsbestätigungs-Flex-Query.

  1. أعطه اسمًا، مثل Tradeways.
  2. أضف قسم Trade Confirmation. اختر Execution مستوى للتفاصيل وحدد جميع الحقول.
  3. اضبط التنسيق على XML.
  4. اضبط الإعدادات العامة كما في الخطوة 3، ثم احفظ.

يمكن أن يتضمن كل استعلام عدة حسابات في Interactive Brokers. لا تحتاج إلى استعلام لكل حساب؛ يسألك Tradeways عن وجهة كل حساب عند رؤيته لأول مرة.

3. ضبط الإعدادات العامة في الاستعلامين

لكلا الاستعلامين كتلة General Configuration. اضبط القيم الأربع نفسها في كل منهما.

General Configuration مع تنسيق التاريخ وتنسيق الوقت مع المنطقة الزمنية والفاصلة المنقوطة، وضبط أزواج الصفقات المتقابلة/الإلغاء على Yes

  1. Date Format: yyyyMMdd.
  2. Time Format: HHmmss TimeZone. هذا الإعداد هو الأسهل نسيانًا. بدونه لا تحمل أوقات التنفيذ منطقة زمنية، ولا يستورد Tradeways تقريرًا سيضطر إلى تخمين أوقاته.
  3. Date/Time Separator: ; (semi-colon).
  4. Include Offsetting Trade/Cancel Pairs?: Yes. عندها يُزال أيضًا من سجلك أي تنفيذ يلغيه Interactive Brokers.

اترك Profit and Loss على Default. يمكن ترك الخيارات الأخرى كما هي.

4. نسخ معرّفي الاستعلامين

افتح كل استعلام. يظهر Query ID الخاص به أعلى التفاصيل.

تفاصيل Activity Flex Query مع Query ID في الأعلى

يجب أن يكون معرّفا الاستعلامين مختلفين. الرمز المميز أطول بكثير من معرّف الاستعلام، ما يسهّل التمييز بين القيم الثلاث.

الاتصال في Tradeways

  1. انتقل إلى الإعدادات → التكاملات وابحث عن Interactive Brokers.
  2. انقر على توصيل Interactive Brokers.
  3. الصق الرمز المميز في رمز Flex Web Service المميز، ومعرّف استعلام Activity في معرّف استعلام Activity، ومعرّف استعلام Trade Confirmation في معرّف استعلام Trade Confirmation. ثم انقر على توصيل.
  4. يفحص Tradeways الرمز المميز والاستعلامين. قد يستغرق Interactive Brokers بضع دقائق لإنشاء التقارير. يمكنك إغلاق النافذة؛ وتتحدّث الحالة في الإعدادات.
  5. عندما تتضمن التقارير حسابات Interactive Brokers، اربط كل حساب بحساب Tradeways خاص به، أو اختر عدم الاستيراد. لا يُستورد شيء لأي حساب قبل ربطه.

يُخزَّن الرمز المميز مشفَّرًا ولا يُعرض مرة أخرى. تظهر أرقام حسابات Interactive Brokers مقنَّعة.

بعد أن تستورد أول مزامنة أي شيء، يحتفظ الحساب المربوط بوجهته. يمكنك استبعاده ثم تضمينه لاحقًا، لكن إلى حساب Tradeways نفسه فقط. نقله سيستورد السجل نفسه إلى حساب ثانٍ.

آلية عمل المزامنة

المزامنة التلقائية ليست تغذية لحظية. ينشر Interactive Brokers تقارير Flex بتأخير، ويقرؤها Tradeways وفق جدول زمني:

  • التنفيذات الجديدة: يُفحص استعلام Trade Confirmation كل 15 دقيقة تقريبًا. توقّع ظهور التنفيذات الجديدة في سجلك خلال 10 إلى 20 دقيقة تقريبًا.
  • التصحيحات والمراكز المفتوحة: يُفحص استعلام Activity مرة واحدة يوميًا. يلتقط التنفيذات المتأخرة والعمولات المصحّحة وأسعار الإغلاق اليومية للمراكز المفتوحة.
  • أول مزامنة: تغطي آخر 365 يومًا تقويميًا. يأتي التاريخ الأقدم من استيراد ملف.

انقر على مزامنة الآن لطلب فحص مبكر. الطلبات محدودة بطلب واحد كل 15 دقيقة.

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

ما يُستورد

  • تنفيذات الأسهم وصناديق ETF، وتنفيذات Forex من نوع CASH التي يحددها Interactive Brokers على أنها فتح أو إغلاق. تُحتسب فئات الأصول الأخرى غير مدعومة وتُتخطى.
  • التنفيذات الجزئية وانعكاسات المراكز والعمولات كما يبلّغ عنها Interactive Brokers، بما في ذلك استردادات العمولات.
  • الإلغاءات: يُزال التنفيذ الملغى من الصفقة التي كان ينتمي إليها.
  • P&L الجاري للمراكز المفتوحة في الأسهم وصناديق ETF، انطلاقًا من سعر الإغلاق اليومي (MarkPrice) في تقرير Activity. وهو ليس سعرًا حيًا.

تظهر مقاييس MFE وMAE وغيرها من التحليلات المعتمدة على الأسعار فقط للأدوات التي لها تاريخ أسعار مدعوم. وتُستورد الصفقات الأخرى بدونها؛ ولا يقدّرها Tradeways.

فجوات التاريخ

يحتاج تنفيذ الإغلاق إلى تنفيذ فتحه. عندما يكون تنفيذ الفتح أقدم من الفترة المزامنة وغير موجود في سجلك، يتخطى Tradeways تنفيذ الإغلاق ويحتسبه فجوة في التاريخ. ولا ينشئ تنفيذ فتح بديلًا. لسد الفجوة، استورد ملفًا يغطي التنفيذين إلى الحساب نفسه.

الحالة والأعداد

يعرض كل اتصال في الإعدادات حالته، وآخر فحص، وآخر فحص ناجح، والفحص المجدول التالي، بحسب منطقتك الزمنية.

الحالةالمعنى
جارٍ الفحصيجري طلب تقرير أو معالجته.
اختر الحساباتعُثر على حسابات Interactive Brokers جديدة. اربطها أو استبعدها للمتابعة.
نشطنجح آخر فحص.
نشط، مع صفوف متخطاةاستُورد آخر تقرير، لكن بعض الصفوف تحتاج إلى مراجعة وتم تخطيها. تستمر المزامنة.
متأخر، تُعاد المحاولةInteractive Brokers غير متاح. يعيد Tradeways المحاولة تلقائيًا.
يلزم إجراءالرمز المميز أو أحد الاستعلامين أو تنسيق التقرير يحتاج إلى انتباه. المزامنة متوقفة حتى تصلحه. وتذكر الرسالة السبب.

تصف الأعداد آخر تقرير: التنفيذات المستوردة، والمتخطاة لأنها مكررة، والمزالة لأنها ملغاة، والمتخطاة لأنها غير مدعومة، والمتخطاة لأنها فجوات في التاريخ. ولأن تقرير Activity اليومي يتداخل مع الأيام السابقة، تُحتسب معظم تنفيذاته مكررة. وهذا متوقع.

استكشاف الأخطاء وإصلاحها

الرسالة أو العَرَضما يجب فعله
انتهت صلاحية رمز Flex المميزأنشئ رمزًا جديدًا في الخطوة 1، ثم انقر على استبدال بيانات الاعتماد.
رمز Flex المميز مقيَّد بعناوين IP معينةأنشئ رمزًا مميزًا مع ترك Valid for IP Address فارغًا.
معرّف استعلام Flex غير صالحتحقق من أن كل معرّف في الحقل الصحيح ومن أن استعلامي Activity وTrade Confirmation غير مبدَّلين.
تعذرت قراءة التقريراضبط تنسيق كلا الاستعلامين على XML.
تعذرت قراءة بعض الصفوف في هذا التقريراضبط تنسيق الوقت في كلا الاستعلامين على HHmmss TimeZone وحدد جميع الحقول في كل قسم. يجب أن تحمل أوقات التنفيذ لاحقة US Eastern، أي EST أو EDT.
لا تظهر التنفيذات الجديدة إلا في اليوم التالياستعلام Trade Confirmation لا يعيدها. تحقق من قسمه ومن إعداداته العامة.
الحساب متصل بالفعل عبر رمز Flex مميز آخرأزل الحساب من أحد الاستعلامين، أو اقطع الاتصال الآخر.
التقرير أكبر من أن يُنزَّلاستورد التاريخ الأقدم من ملف. وإذا توقفت التنفيذات الجديدة عن الوصول، فتواصل مع الدعم.

بعد إصلاح الرمز المميز أو أحد الاستعلامين في Interactive Brokers، انقر على استبدال بيانات الاعتماد لإعادة الفحص. وعندما يكون حساب الوجهة غير متاح، انقر على ربط الحسابات. يوقف قطع الاتصال كل عمليات الفحص ويحذف الرمز المميز؛ وتبقى الصفقات المستوردة سابقًا في حساباتك.

On this page