عن المشروع

Arbitrage Insights هي أداة صغيرة لمراجحة العملات الأجنبية. تقارن سعر الفوروارد العادل لزوج عملات، المُستمد من السعر الفوري وسعري الفائدة، مع سعر فوروارد السوق، وتحدد الفجوة، وتعرض ما يتبقى بعد تكاليف التداول والضريبة. يضم المشروع ثلاث صفحات. تسحب Live Monitor أسعارًا فورية مباشرة كل دقيقة، وتحسب سعر الفوروارد العادل لكل زوج مراقَب، وتقارنه بعرض سعر فوروارد يقدمه المستخدم، وتطرح التكاليف، ثم تطلق تنبيهًا عبر لافتة وصوت وإشعار متصفح عندما تصبح الفجوة جديرة بالتنفيذ. وتفحص Arbitrage Calculator صفقة واحدة خطوة بخطوة. أما Investment Calculator فتأخذ رأس المال والزوج والدولة وتعيد إجمالي الربح والربح بعد التكاليف والربح بعد الضريبة، مع مقارنة بين الدول. تتضمن الملفات المشتركة engine.js للحسابات، وtheme.css، وmonitor.js، وmonitor_config.json. تأتي الأسعار الفورية المباشرة من مصدر عام هو api.fxratesapi.com مع open.er-api.com كمصدر احتياطي. وتأتي أسعار الفائدة ونقاط الفوروارد من monitor_config.json؛ ولعدم وجود مصدر مجاني لعروض أسعار الفوروارد، يُدخل المستخدم نقاط فوروارد الوسيط هناك. وحتى يتم ذلك، يعمل الموقع في وضع تجريبي ولا يرسل إشعارات. يُطلق التنبيه عندما تتجاوز الفجوة بعد التكاليف alert_threshold_bp وتجتاز المدخلات فحوصات السلامة. للحصول على تنبيهات عند عدم فتح أي صفحة، يعمل monitor_check.py على GitHub Actions كل 15 دقيقة، ويستخدم نفس الإعداد والمحرك، ويكتب signals.json لتقرأه الصفحة، ويرسل رسالة تيليجرام عند ظهور فرصة وعندما تكون quotes_are_real صحيحة. يتطلب الإعداد إنشاء بوت تيليجرام عبر BotFather، وتخزين TELEGRAM_BOT_TOKEN وTELEGRAP_CHAT_ID كأسرار مستودع، وتعيين forward_points وquotes_as_of وquotes_are_real الفعلية في الإعداد. يعد fx_arbitrage.py التنفيذ المرجعي بلغة بايثون، بينما يعد engine.js نسخة منقولة تمت مراجعتها بشكل متبادل. عند تشغيله يطبع أربعة أمثلة عملية، بينما يشغّل monitor_check.py دورة مراقبة واحدة محليًا. يذكر README أن أسعار الفائدة ومعدلات الضريبة توضيحية أو مؤقتة ويجب التحقق منها قبل الاستخدام، وأن المشروع ليس نصيحة استثمارية.