اپنے ٹرمینل میں پولی مارکیٹ پیش گوئی بوٹ بنائیں اور چلائیں

Polymarket Prediction Bot کیا ہے؟

Polymarket Prediction Bot ایک اوپن سورس، کی بورڈ سے چلنے والی ٹرمینل ایپلیکیشن ہے جو Polymarket پر پیش گوئی کی مارکیٹس کا جائزہ لینے کے لیے بنائی گئی ہے۔ یہ Textual اور Rich پر مبنی ٹرمینل انٹرفیس میں مارکیٹس براؤزر، لائیو سینٹرل لِمٹ آرڈر بُک ویو، اسٹریٹیجی انجن، پوزیشن ٹریکر اور فل لاگ کو یکجا کرتی ہے۔

Polymarket کی مارکیٹس میں عموماً YES اور NO شیئرز شامل ہوتے ہیں، جو حقیقی دنیا کے کسی واقعے کے نتیجے کے مطابق $1 یا $0 پر طے ہوتے ہیں۔ چونکہ مارکیٹ کی قیمت کو مضمر امکان کے طور پر سمجھا جا سکتا ہے، اس لیے بوٹ مارکیٹ کی قیمتوں کا منصفانہ امکان کے تخمینوں سے موازنہ کرتا ہے، آرڈر بُک کی صورتحال کا جائزہ لیتا ہے، اور ممکنہ برتری یا آربیٹریج کے اشارے نمایاں کرتا ہے۔

اہم: یہ ایک غیر سرکاری تعلیمی منصوبہ ہے اور Polymarket سے وابستہ نہیں ہے۔ یہ مالی مشورہ نہیں ہے، اور شامل کردہ کوئی بھی اسٹریٹیجی منافع کی ضمانت نہیں دیتی۔ --demo سے آغاز کریں، جو بنڈل کردہ ڈیٹاسیٹ اور نقلی فلز استعمال کرتا ہے اور والٹ کو متاثر نہیں کرتا۔

اہم خصوصیات

• مارکیٹس براؤزر: مارکیٹس کو حجم، اسپریڈ، زمرے اور حل ہونے تک باقی وقت کے لحاظ سے فلٹر کریں۔
• CLOB آرڈر بُک: YES اور NO کی بولیاں اور آفرز، اسپریڈز، درمیانی قیمتیں اور بُک کا عدم توازن دیکھیں۔
• اسٹریٹیجی انجن: امکان کی برتری، بُک کے عدم توازن اور لیکویڈیٹی اسٹریٹیجیز کو الگ الگ یا ایک ساتھ چلائیں۔
• سگنل ٹریکنگ: 0 سے 1 تک تجویز کردہ سائیڈز اور اعتماد کی قدروں کا جائزہ لیں۔
• پوزیشن مانیٹرنگ: کھلی YES اور NO مقدار، اوسط لاگت، USDC میں غیر حقیقی PnL اور حل ہونے کی الٹی گنتی دیکھیں۔
• فل لاگ: سگنلز، نقلی یا 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

شامل کردہ بیچ لانچر چلائیں:

run.bat

Linux اور macOS

شیل لانچر کو قابلِ اجرا بنائیں، پھر اسے چلائیں:

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. ایک مارکیٹ منتخب کریں اور اس کی YES اور NO آرڈر بُک دیکھنے کے لیے Enter یا b دبائیں۔

5. بہترین بولیوں اور آفرز، اسپریڈ، درمیانی قیمت اور نسبتی حجم کے عدم توازن کا جائزہ لیں۔

6. فعال اسٹریٹیجیز کے ساتھ واچ لسٹ اسکین کرنے کے لیے s دبائیں۔

7. 4 کے ذریعے اسٹریٹیجی ویو کھولیں اور ہر سگنل کے اعتماد اور تجویز کردہ سائیڈ کا جائزہ لیں۔

8. جب آپ کسی سگنل کو آزمانا چاہیں تو پیپر آرڈر تیار کرنے کے لیے o دبائیں۔

9. پوزیشنز اور غیر حقیقی PnL دیکھنے کے لیے 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 سیکرٹ یا پاس فریز کو کبھی بھی سورس کنٹرول میں شامل نہ کریں۔ پروجیکٹ کے مطابق کیز مقامی رہتی ہیں اور لاگ نہیں کی جاتیں۔

اسناد ترتیب دینے کے بعد لائیو موڈ اس کمانڈ سے شروع کیا جا سکتا ہے:

python main.py

لائیو آرڈر دینا واضح کنفیگریشن کے پیچھے محدود ہے۔ پہلے ڈیمو موڈ میں سیٹ اپ کی توثیق کریں، اپنے ایکسپوژر کنٹرولز کی تصدیق کریں، اور جانچیں کہ آیا Polymarket آپ کے دائرۂ اختیار میں دستیاب ہے۔ پروجیکٹ جغرافیائی پابندیوں کو نظرانداز نہیں کرتا۔

اعلیٰ استعمال کی تجاویز

حکمتِ عملی کے سیاق کو یکجا کریں

بلٹ اِن حکمتِ عملیاں منتخب اور باہم مرکب کی جا سکتی ہیں۔ صرف ایک پیمانے پر عمل کرنے کے بجائے امکان کے فائدے، آرڈر بُک کے عدم توازن، اسپریڈ کی چوڑائی اور اشارے کے اعتماد کا موازنہ کریں۔ اشاروں کے درمیان اتفاق مزید سیاق فراہم کر سکتا ہے، اگرچہ اس سے ٹریڈنگ کا خطرہ ختم نہیں ہوتا۔

اشارے پر غور کرنے سے پہلے لیکویڈیٹی دیکھیں

دکھائی گئی مارکیٹ قیمت یہ نہیں بتاتی کہ اس قیمت پر کتنا حجم انجام دیا جا سکتا ہے۔ کسی فائدے یا آربیٹریج اشارے کا جائزہ لینے سے پہلے بُک کھولیں اور بولی و طلب کی گہرائی، اسپریڈ، مڈ پوائنٹ اور عدم توازن دیکھیں۔

لاگ کو ریکارڈ کے طور پر استعمال کریں

بوٹ اشاروں، مکمل ہونے والے آرڈرز اور منسوخیوں کا لاگ رکھتا ہے۔ لاگ کا جائزہ لینے سے آپ حکمتِ عملی کے نتائج کا بعد کے مصنوعی نتائج سے موازنہ کر سکتے ہیں اور ان صورتوں کی شناخت کر سکتے ہیں جہاں زیادہ اعتماد والا اشارہ توقع کے مطابق عمل نہیں کر سکا۔

نتیجے کے وقت کی نگرانی کریں

جلد نتیجہ دینے والی مارکیٹس کی شناخت کے لیے مارکیٹس براؤزر اور ڈیش بورڈ استعمال کریں۔ نتیجے کا وقت اس امر پر اثر انداز ہوتا ہے کہ سرمایہ کتنی دیر تک خطرے میں رہ سکتا ہے، جبکہ 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 لائسنس کے تحت تقسیم کیا جاتا ہے اور مالی مشورے کے بجائے ایک آزاد تعلیمی ٹول کِٹ کے طور پر پیش کیا گیا ہے۔