আপনার টার্মিনালে Polymarket প্রেডিকশন বট তৈরি ও চালান

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 দিয়ে Strategy ভিউ খুলুন এবং প্রতিটি সংকেতের আত্মবিশ্বাস ও প্রস্তাবিত পক্ষ পর্যালোচনা করুন।

8. কোনো সংকেত পরীক্ষা করতে চাইলে পেপার অর্ডার তৈরি করতে o চাপুন।

9. পজিশন ও অবাস্তবায়িত PnL দেখতে 5 ব্যবহার করুন, তারপর সংকেত ও সিমুলেটেড ফিল পর্যালোচনা করতে 6 ব্যবহার করুন।

অন্তর্নির্মিত স্ট্র্যাটেজিগুলো বুঝুন

সম্ভাবনা-এজ স্ট্র্যাটেজি

এই স্ট্র্যাটেজি মার্কেট মূল্যকে একটি ন্যায্য-সম্ভাবনা মডেলের সঙ্গে তুলনা করে। পার্থক্য কনফিগার করা সীমা অতিক্রম করলে এটি একটি সংকেত তৈরি করে। উদাহরণস্বরূপ, মডেলের ন্যায্য সম্ভাবনা বর্তমান YES মূল্যের তুলনায় যথেষ্ট বেশি হলে, সংকেতটি YES পক্ষের পরামর্শ দিতে পারে।

এই সংকেতের মান নির্ভর করে স্ট্র্যাটেজিতে সরবরাহ করা ন্যায্য-সম্ভাবনা মডেলের ওপর। আত্মবিশ্বাসকে নিশ্চয়তা নয়, বরং বিশ্লেষণাত্মক আউটপুট হিসেবে বিবেচনা করুন।

বুক-ইমব্যালান্স স্ট্র্যাটেজি

বুক-ইমব্যালান্স কৌশলটি YES এবং NO পাশে উপলভ্য আকারের আপেক্ষিক পরিমাণ বিশ্লেষণ করে। আকারের বড় অসমতা দিকনির্দেশক সংকেত হিসেবে বিবেচিত হতে পারে। এটি অর্ডার-বুকের তথ্য, বাজার সেই দিকে এগোবে বা নিষ্পত্তি হবে—তার প্রমাণ নয়।

লিকুইডিটি কৌশল

লিকুইডিটি কৌশলটি প্রশস্ত স্প্রেড এবং মধ্যবিন্দুর দিকে সম্ভাব্য গড়-প্রত্যাবর্তনের সুযোগ খোঁজে। প্রশস্ত স্প্রেড সুযোগ তৈরি করতে পারে, তবে এগুলো দুর্বল লিকুইডিটি বা বেশি এক্সিকিউশন ঝুঁকির ইঙ্গিতও হতে পারে।

ক্রস-মার্কেট সংকেত

বটটি YES-plus-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"

private key হলো Polygon EOA private key, আর proxy_address হলো Polymarket proxy বা signer address। অ্যাপ্লিকেশনটি কেবল এই স্থানীয় কনফিগারেশন ফাইল থেকেই ক্রেডেনশিয়াল পড়ে।

Unix ফাইল-অনুমতি সমর্থনকারী সিস্টেমে ফাইলটির অ্যাক্সেস সীমিত করুন:

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

নিরাপত্তা সতর্কতা: কনফিগারেশন ফাইল, private key, API secret বা passphrase কখনোই source control-এ commit করবেন না। প্রকল্পটি জানায় যে key স্থানীয়ই থাকে এবং log-এ লেখা হয় না।

ক্রেডেনশিয়াল কনফিগার করার পর লাইভ মোড চালু করা যায়:

python main.py

লাইভ অর্ডার স্থাপন স্পষ্ট কনফিগারেশনের আড়ালে সুরক্ষিত। প্রথমে demo mode-এ সেটআপ যাচাই করুন, আপনার exposure control নিশ্চিত করুন এবং আপনার এখতিয়ারে Polymarket উপলভ্য কি না পরীক্ষা করুন। প্রকল্পটি geofencing এড়িয়ে যায় না।

উন্নত ব্যবহারের পরামর্শ

কৌশলগত প্রেক্ষাপট একত্র করুন

অন্তর্নির্মিত কৌশলগুলো বেছে নেওয়া এবং একত্রে ব্যবহার করা যায়। শুধু একটি মেট্রিকের ওপর নির্ভর না করে probability edge, order-book imbalance, spread width এবং signal confidence তুলনা করুন। সূচকগুলোর মধ্যে সামঞ্জস্য আরও প্রেক্ষাপট দিতে পারে, যদিও এতে trading risk দূর হয় না।

সংকেত বিবেচনার আগে লিকুইডিটি পরীক্ষা করুন

প্রদর্শিত বাজারমূল্য ওই দামে কতটা পরিমাণে লেনদেন করা যাবে তা দেখায় না। কোনো edge বা arbitrage signal মূল্যায়নের আগে book খুলে bid ও ask depth, spread, midpoint এবং imbalance পরীক্ষা করুন।

লগকে রেকর্ড হিসেবে ব্যবহার করুন

বটটি signal, fill এবং cancellation log করে। লগ পর্যালোচনা করলে পরবর্তী simulated outcome-এর সঙ্গে strategy output তুলনা করা যায় এবং high-confidence signal প্রত্যাশামতো কাজ করেনি—এমন ঘটনা শনাক্ত করা যায়।

নিষ্পত্তির সময় পর্যবেক্ষণ করুন

শিগগির নিষ্পত্তি হবে এমন market শনাক্ত করতে markets browser এবং dashboard ব্যবহার করুন। নিষ্পত্তির সময়ের ওপর নির্ভর করে capital কতক্ষণ ঝুঁকিতে থাকতে পারে, আর Positions view খোলা market-এর জন্য countdown দেখায়।

লাইভ ব্যবহারের আগে ঝুঁকি নিয়ন্ত্রণ প্রয়োগ করুন

উপলভ্য সর্বোচ্চ USDC exposure, per-market cap এবং daily loss limit কনফিগার ও মেনে চলুন। strategy-গুলো live order template-এর সঙ্গে সংযুক্ত থাকলে এই নিয়ন্ত্রণগুলো বিশেষভাবে গুরুত্বপূর্ণ।

Demo ও Live workflow আলাদা রাখুন

keybinding শেখা, strategy combination পরীক্ষা এবং simulated fill পর্যবেক্ষণের সময় --demo ব্যবহার করুন। interface, signal interpretation এবং risk setting প্রত্যাশামতো কাজ করছে নিশ্চিত করার পরই credential-যুক্ত live mode-এ যান।

প্রকল্পের কাঠামো

repository-টি command-line startup, configuration, strategy logic, data model এবং terminal interface আলাদা করে:

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 হলো প্রধান entry point, আর polymarket_bot/core/-এ model, strategy engine এবং mock data রয়েছে। polymarket_bot/tui/ directory-তে Textual screen, widget এবং style রয়েছে। release/ directory ভবিষ্যতে পরিকল্পিত precompiled binary-এর জন্য সংরক্ষিত।

উপসংহার

Polymarket Prediction Bot prediction market ব্রাউজ করা, CLOB liquidity পরীক্ষা করা, strategy signal তৈরি করা এবং position ও fill পর্যবেক্ষণের জন্য একটি সমন্বিত terminal workflow প্রদান করে। python main.py --demo দিয়ে শুরু করুন, keyboard-নির্ভর interface শিখুন, প্রেক্ষাপটসহ signal মূল্যায়ন করুন এবং credential-যুক্ত live mode বিবেচনার আগে কঠোর exposure control প্রয়োগ করুন।

প্রকল্পটি MIT License-এর অধীনে বিতরণ করা হয় এবং financial advice-এর পরিবর্তে একটি স্বাধীন শিক্ষামূলক toolkit হিসেবে ব্যবহারের জন্য তৈরি।