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.

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

Activity Flex Query (1). في البوابة الألمانية يسمى Kontoumsatz-Flex-Query.
- أعطه اسمًا، مثل
Tradeways. - أضف قسم Trades. اختر Executions مستوى للتفاصيل وحدد جميع الحقول.
- أضف قسم Open Positions. اختر Summary مستوى للتفاصيل وحدد جميع الحقول.
- اضبط التنسيق على XML. الفترة غير مهمة: يحدد Tradeways التواريخ في كل طلب.
- اضبط الإعدادات العامة كما في الخطوة 3، ثم احفظ.
Trade Confirmation Flex Query (2). في البوابة الألمانية يسمى Handelsbestätigungs-Flex-Query.
- أعطه اسمًا، مثل
Tradeways. - أضف قسم Trade Confirmation. اختر Execution مستوى للتفاصيل وحدد جميع الحقول.
- اضبط التنسيق على XML.
- اضبط الإعدادات العامة كما في الخطوة 3، ثم احفظ.
يمكن أن يتضمن كل استعلام عدة حسابات في Interactive Brokers. لا تحتاج إلى استعلام لكل حساب؛ يسألك Tradeways عن وجهة كل حساب عند رؤيته لأول مرة.
3. ضبط الإعدادات العامة في الاستعلامين
لكلا الاستعلامين كتلة General Configuration. اضبط القيم الأربع نفسها في كل منهما.

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

يجب أن يكون معرّفا الاستعلامين مختلفين. الرمز المميز أطول بكثير من معرّف الاستعلام، ما يسهّل التمييز بين القيم الثلاث.
الاتصال في Tradeways
- انتقل إلى الإعدادات → التكاملات وابحث عن Interactive Brokers.
- انقر على توصيل Interactive Brokers.
- الصق الرمز المميز في رمز Flex Web Service المميز، ومعرّف استعلام Activity في معرّف استعلام Activity، ومعرّف استعلام Trade Confirmation في معرّف استعلام Trade Confirmation. ثم انقر على توصيل.
- يفحص Tradeways الرمز المميز والاستعلامين. قد يستغرق Interactive Brokers بضع دقائق لإنشاء التقارير. يمكنك إغلاق النافذة؛ وتتحدّث الحالة في الإعدادات.
- عندما تتضمن التقارير حسابات 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، انقر على استبدال بيانات الاعتماد لإعادة الفحص. وعندما يكون حساب الوجهة غير متاح، انقر على ربط الحسابات. يوقف قطع الاتصال كل عمليات الفحص ويحذف الرمز المميز؛ وتبقى الصفقات المستوردة سابقًا في حساباتك.