بنّي وشغّل بوت توقّعات Polymarket فالتيرمينال ديالك

شنو هو بوت التنبؤ ديال Polymarket؟

Polymarket Prediction Bot هو تطبيق مفتوح المصدر، خدام بالكيبورد ومن التيرمينال، كيساعدك تستكشف أسواق التنبؤ فـ Polymarket. كيجمع بين متصفح الأسواق، وعرض مباشر لدفتر الأوامر بنظام CLOB، ومحرك للاستراتيجيات، ومتتبع للصفقات، وسجلّ التنفيذات، كاملين فواجهة تيرمينال مبنية بـ Textual وRich.

أسواق Polymarket غالباً كتكون فيها حصص YES وNO، وكتتحسم فـ $1 ولا $0 حسب نتيجة واحد الحدث فالعالم الحقيقي. وحيت ثمن السوق يقدر يتفسر على أساس أنه احتمال ضمني، البوت كيقارن أثمان السوق مع تقديرات الاحتمال العادل، وكيفحص ظروف دفتر الأوامر، وكيبيّن إشارات الربح المحتمل ولا المراجحة.

مهم: هاد المشروع تعليمي وغير رسمي، وما عندوش علاقة بـ Polymarket. ماشي نصيحة مالية، وما كاينة حتى استراتيجية مرفقة كتضمن الربح. بدا بـ --demo، اللي كيستعمل مجموعة بيانات مرفقة وتنفيذات محاكاة بلا ما يمسّ المحفظة.

المميزات الرئيسية

• متصفح الأسواق: صفّي الأسواق حسب الحجم، والفرق بين البيع والشراء، والفئة، والمدة المتبقية حتى الحسم.
• دفتر أوامر CLOB: عاين عروض الشراء والبيع ديال YES وNO، والفروقات، وأثمان الوسط، واختلال توازن الدفتر.
• محرك الاستراتيجيات: شغّل استراتيجيات فرق الاحتمال، واختلال الدفتر، والسيولة، بوحدها ولا مجموعين.
• تتبع الإشارات: راجع الجهات المقترحة وقيم الثقة من 0 حتى 1.
• مراقبة المراكز: تتبّع أحجام YES وNO المفتوحة، ومتوسط التكلفة، والربح أو الخسارة غير المحققة بـ USDC، والعدّ التنازلي حتى الحسم.
• سجلّ التنفيذات: حافظ على سجل محلي ديال الإشارات، والتنفيذات المحاكاة ولا تنفيذات CLOB، والإلغاءات.
• لوحة المعلومات: شوف أكثر الأسواق تحركاً، والفروقات الواسعة، والأسواق اللي قربات تتحسم، والإشارات اللي كتسنى.
• التداول التجريبي: جرّب مسارات العمل برصيد USDC افتراضي قبل ما تهيّأ الولوج الحقيقي.
• ضوابط المخاطر: طبّق حد أقصى للتعرّض بـ USDC، وسقوفاً لكل سوق، وحداً يومياً للخسارة.
• واجهة متعددة الأنظمة: شغّل التطبيق على Windows ولا macOS ولا Linux.

المتطلبات الأساسية

التثبيت العادي كيحتاج Git وPython 3.11 ولا أحدث وpip. المستودع كيوفّر حتى مشغلات بنقرة وحدة كتفكّ مفسّر مستقل مرفق فأول استعمال، وبالتالي ما كتحتاجش تثبيت Python فالنظام إلا استعملتي هاد المشغلات.

ثبّت البوت باستعمال Python

1. نسخ المستودع:

   git clone https://github.com/gulelmatthews/Polymarket-Perpetual-Bot.git

2. دخل لمجلد المشروع:

   cd Polymarket-Perpetual-Bot

3. ثبّت الحزم المطلوبة:

   pip install -r requirements.txt

4. بدا بمجموعة البيانات التجريبية المرفقة:

   python main.py --demo

المشروع كيوفّر حتى نقطة تشغيل للحزمة باستعمال python -m polymarket_bot. تحليل أوامر سطر الأوامر ومنطق التشغيل ديالو مطبّقين فالحزمة المضيفة.

استعمل المشغلات بنقرة وحدة

Windows

شغّل المشغّل المرفق بصيغة batch:

run.bat

Linux وmacOS

خلّي مشغّل shell قابل للتنفيذ، ومن بعد شغّلو:

chmod +x run.sh
./run.sh

فأول استعمال، هاد المشغلات كيفكّو المفسّر المستقل المرفق اللي كيحتاجو التطبيق.

تنقّل فلوحة التيرمينال

الواجهة منظمة فستة عروض رئيسية. استعمل أرقام الكيبورد باش تنتاقل مباشرة بينها:

• 1: لوحة المعلومات
• 2: الأسواق
• 3: دفتر الأوامر
• 4: الاستراتيجية
• 5: المراكز
• 6: السجل

كاينين حتى اختصارات إضافية بالكيبورد كيدعمو مسار العمل الرئيسي:

• /: صفّي لائحة الأسواق.
• Enter ولا b: حلّ دفتر CLOB ديال السوق المختار.
• s: شغّل محرك الاستراتيجيات على لائحة التتبع.
• o: حضّر أمر تداول تجريبي.
• t: بدّل بين الواجهات المتاحة.
• q: خرج من التطبيق.

مسار عمل تجريبي أساسي

1. شغّل التطبيق باستعمال python main.py --demo.

2. ضغط على 2 باش تحل متصفح الأسواق.

3. استعمل / باش تضيق الأسواق اللي باينة حسب الفلاتر المتاحة.

4. اختار سوقاً وضغط على Enter ولا b باش تعاين دفتر أوامر YES وNO ديالو.

5. راجع أحسن عروض الشراء والبيع، والفرق، وثمن الوسط، والاختلال النسبي فالحجم.

6. ضغط على s باش تفحص لائحة التتبع بالاستراتيجيات المفعّلة.

7. حل عرض الاستراتيجية باستعمال 4 وراجع ثقة كل إشارة والجهة المقترحة.

8. ضغط على o باش تحضّر أمراً تجريبياً ملي بغيتي تختبر إشارة.

9. استعمل 5 باش تعاين المراكز والربح أو الخسارة غير المحققة، ومن بعد استعمل 6 باش تراجع الإشارات والتنفيذات المحاكاة.

فهم الاستراتيجيات المدمجة

استراتيجية فرق الاحتمال

هاد الاستراتيجية كقارن ثمن السوق مع نموذج ديال الاحتمال العادل. كتولّد إشارة ملي كيتجاوز الفرق العتبة المهيّأة. مثلاً، إلا كان الاحتمال العادل حسب النموذج أعلى بشكل واضح من ثمن YES الحالي، الإشارة الناتجة تقدر تقترح جهة YES.

جودة هاد الإشارة كتتعلق بنموذج الاحتمال العادل اللي تزودات به الاستراتيجية. اعتابر الثقة نتيجة تحليلية، وماشي ضمانة.

استراتيجية اختلال دفتر الأوامر

استراتيجية عدم التوازن فدفتر الأوامر كتشوف للحجم النسبي المتاح فجوج الجوانب YES وNO. الميل الكبير فالحجم يقدر يتعتبر إشارة للاتجاه. هادي معلومات من دفتر الأوامر، وماشي دليل بلي السوق غادي يتحرك ولا يسالي فداك الاتجاه.

استراتيجية السيولة

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

إشارات بين الأسواق

البوت يقدر يبيّن إشارات فرق YES زائد NO والمراجحة بين نتائج متعددة. خاص هاد الإشارات تتقيّم مع السيولة المتاحة، وعمق دفتر الأوامر، وحدود المخاطر، وماشي تتعتبر أرباح مضمونة.

إعداد الوضع المباشر

الوضع المباشر كيحتاج بيانات اعتماد Polymarket API ديالك. صايب ملف الإعدادات فـ ~/.polymarket-bot/config.toml بهاد البنية:

[auth]
private_key    = "0x…"
proxy_address  = "0x…"
api_key        = "…"
api_secret     = "…"
api_passphrase = "…"
endpoint       = "https://clob.polymarket.com"

المفتاح الخاص هو المفتاح الخاص ديال Polygon EOA، بينما proxy_address هو عنوان وكيل Polymarket ولا عنوان الموقّع. التطبيق كيقرا بيانات الاعتماد غير من ملف الإعدادات المحلي هادا.

فالأنظمة اللي كتدعم صلاحيات ملفات Unix، قيّد الولوج للملف:

chmod 0600 ~/.polymarket-bot/config.toml

تحذير أمني: عمرك تدير ملف الإعدادات، ولا المفتاح الخاص، ولا سر API، ولا عبارة المرور فـ source control. المشروع كيصرّح بلي المفاتيح كتبقى محلية وما كتتسجّلش فالسجلات.

من بعد ما تهيّأ بيانات الاعتماد، تقدر تشغّل الوضع المباشر بهاد الأمر:

python main.py

وضع الأوامر المباشرة محمي وكيحتاج إعدادات صريحة. جرّب الإعداد أولاً فالوضع التجريبي، وتأكد من ضوابط التعرّض ديالك، وتحقق واش Polymarket متاحة فالم jurisdiction ديالك. المشروع ما كيتجاوزش التقييد الجغرافي.

نصائح متقدمة للاستعمال

جمع سياق الاستراتيجيات

الاستراتيجيات المدمجة قابلة للاختيار والتركيب. بلا ما تعتمد على مقياس واحد، قارن بين أفضلية الاحتمال، وعدم توازن دفتر الأوامر، واتساع الفرق، وثقة الإشارة. الاتفاق بين المؤشرات يقدر يعطي سياق أكثر، ولكن ما كيلغيش مخاطر التداول.

فحص السيولة قبل دراسة أي إشارة

ثمن السوق اللي باين ما كيبينش شحال من حجم يقدر يتنفذ فداك الثمن. حلّ دفتر الأوامر وفحص عمق عروض الشراء والبيع، والفرق، ونقطة الوسط، وعدم التوازن قبل ما تقيّم أفضلية ولا إشارة مراجحة.

استعمل السجل كسجلّ تتبّع

البوت كيسجّل الإشارات، والتنفيذات، والإلغاءات. مراجعة السجل تقدر تعاونك تقارن مخرجات الاستراتيجية مع النتائج المحاكاة اللي من بعد، وتحدد الحالات اللي ما تصرفاتش فيها إشارة عالية الثقة بالطريقة المتوقعة.

راقب وقت التسوية

استعمل متصفح الأسواق ولوحة التحكم باش تحدد الأسواق اللي غادي تسالي قريب. توقيت التسوية كيأثر على المدة اللي يقدر يبقى فيها رأس المال معرّض، بينما واجهة Positions كتبيّن العدّ التنازلي للأسواق المفتوحة.

طبّق ضوابط المخاطر قبل الاستعمال المباشر

هيّأ واحترم الحد الأقصى المتاح للتعرّض بـ USDC، والسقف لكل سوق، وحدّ الخسارة اليومية. هاد الضوابط مهمة بزاف خصوصاً ملي كتكون الاستراتيجيات مربوطة بقوالب الأوامر المباشرة.

خلي مساري التجربة والاستعمال المباشر منفصلين

استعمل --demo ملي كتتعلم اختصارات لوحة المفاتيح، وكتجرب تركيبات الاستراتيجيات، وكتراقب التنفيذات المحاكاة. دوز للوضع المباشر ببيانات الاعتماد غير من بعد ما تتأكد بلي الواجهة، وفهم الإشارات، وإعدادات المخاطر خدامين كيفما متوقع.

بنية المشروع

المستودع كيفصل بين التشغيل من سطر الأوامر، والإعدادات، ومنطق الاستراتيجيات، ونماذج البيانات، وواجهة الطرفية:

polymarket-prediction-bot/
├── main.py
├── polymarket_bot/
│   ├── __main__.py
│   ├── cli.py
│   ├── config.py
│   ├── core/
│   └── tui/
├── support/
├── requirements.txt
├── run.bat
├── run.sh
└── release/

main.py هو نقطة الدخول الرئيسية، بينما polymarket_bot/core/ فيها النماذج، ومحرك الاستراتيجيات، والبيانات الوهمية. المجلد polymarket_bot/tui/ فيه شاشات Textual، والأدوات، والأنماط. المجلد release/ مخصص للملفات التنفيذية المترجمة مسبقاً والمخطط لها.

الخلاصة

Polymarket Prediction Bot كيوفّر مسار عمل موحّد فـ الطرفية لتصفح أسواق التوقعات، وفحص سيولة CLOB، وتوليد إشارات الاستراتيجيات، وتتبع المراكز والتنفيذات. بدا بـ python main.py --demo، وتعلم الواجهة اللي كتخدم بلوحة المفاتيح، وقيّم الإشارات فالسياق ديالها، وطبّق ضوابط صارمة على التعرّض قبل ما تفكر فالوضع المباشر ببيانات الاعتماد.

المشروع موزّع بموجب رخصة MIT، ومقصود به يكون أداة تعليمية مستقلة وماشي نصيحة مالية.