Polymarket बॉट बनाएं: स्कैनर, साइजिंग, निष्पादन, मॉनिटरिंग

यह गाइड एक ऐसा Polymarket बॉट कैसे बनाएं दिखाती है जो लगातार मार्केट्स को स्कैन करता है, अवसरों का साइज निकलता है, CLOB के माध्यम से निष्पादित करता है और प्रदर्शन मॉनिटर करता है। यह आर्किटेक्चर और डेवलपर पैटर्न पर केंद्रित है जिन्हें आप Polymarket की सार्वजनिक APIs और Relayer मॉडल का उपयोग करके लागू कर सकते हैं।

मुख्य निष्कर्ष

बॉट को चार स्वतंत्र सेवाओं के रूप में आर्किटेक्ट करें: scanner, sizer, executor, और monitor।
लिस्टिंग और ऑर्डर प्लेसमेंट के लिए Polymarket के Gamma और CLOB APIs का उपयोग करें; रीयल-टाइम बुक अपडेट्स के लिए WebSocket का प्रयोग करें।
तेज़ निष्पादन के लिए FAK मार्केट ऑर्डर्स प्राथमिकता दें लेकिन स्लिपेज और फीस हमेशा ध्यान में रखें।
ऑरेकल विवाद, सेटलमेंट देरी, या अनपेक्षित फाइल्स के लिए मॉनिटरिंग और फास्ट किल-स्विचेज़ को उपकरणबद्ध करें।

क्यों यह संरचना

जब जिम्मेदारियाँ अलग-अलग होती हैं तो ट्रेडिंग सिस्टम को समझना आसान होता है। एक scanner संभावित edges ढूंढ़ता है, एक sizer edge को पोजिशन में बदलता है, एक executor CLOB के माध्यम से ऑर्डर रखता है, और एक monitor सुरक्षा और शुद्धता सुनिश्चित करता है। यह अलगाव आपको लेटेंसी और जोखिम को स्वतंत्र रूप से स्केल, टेस्ट और तर्कसंगत बनाने देता है।

H2: डेटा स्रोत और APIs

इन Polymarket endpoints को अपनी सेवाओं में जोड़कर शुरू करें:

Gamma (मार्केट मेटाडेटा): https://gamma-api.polymarket.com — markets, events, tags, series. after_cursor के साथ पेजिनेशन का उपयोग करें; offset से बचें।
CLOB (ऑर्डर बुक और ट्रेडिंग): https://clob.polymarket.com — ऑर्डरबुक रीड सार्वजनिक हैं; ट्रेडिंग के लिए API key + HMAC की आवश्यकता होती है। CLOB SDKs ऑर्डर प्लेसमेंट संभालते हैं।
Market WebSocket (रीयल-टाइम बुक): wss://ws-subscriptions-clob.polymarket.com/ws/market — book, price_change, best_bid_ask, और tick_size_change के लिए सब्सक्राइब करें। हर 10s पर PING।
Data API (पोजिशन्स, ओपन इंटरेस्ट): पोस्ट-ट्रेड एनालिटिक्स के लिए https://data-api.polymarket.com.

डिज़ाइन नोट: प्रभावी लाइव स्कैनिंग के लिए Gamma लिस्टिंग्स को WebSocket फीड के साथ मिलाएं। Gamma की रेट लिमिट्स (उदा., /markets कैप्स) और ऑर्डर प्लेसमेंट के लिए CLOB के कुंजी-आवश्यकताओं का सम्मान करें।

H2: Scanner — संभावित अवसर ढूँढना

फंक्शन

Scanner उन अवसरों को खोजता है जो आपकी स्ट्रेटेजी से मेल खाते हैं: intra-market binary स्प्रेड्स, multi-outcome समतलियाँ, या endgame पैटर्न। यह stateless, horizontally scalable और मूल edges की गणना पर केंद्रित होना चाहिए।

इनपुट और कैडेंस

best_bid_ask और tick परिवर्तन प्राप्त करने के लिए Market WebSocket को custom_feature_enabled: true के साथ सब्सक्राइब करें।
जब आप किसी नए इंस्ट्रूमेंट के साथ पहली बार मिलें तो Gamma /markets से बैकफिल करें ताकि मेटाडेटा और आउटकम्स मिलें।
प्रत्येक आउटकम के लिए best asks/bids का एक छोटा in-memory view बनाए रखें।

Edge गणना

Binary intra-market: edge = 1.00 - (bestAsk(YES) + bestAsk(NO)). सकारात्मक edge एक कैंडिडेट है।
Multi-outcome: edge = 1.00 - sum(bestAsk(outcomes)).

थ्रेशहोल्ड और फ़िल्टर

न्यूनतम edge थ्रेशहोल्ड (उदा., > configured cents) ताकि taker fees और निष्पादन जोखिम कवर हो सकें।
न्यूनतम लिक्विडिटी चेक: best ask पर डेप्थ को न्यूनतम फिल साइज पूरा करना चाहिए।
Tick-size जागरूकता: tick_size_change इवेंट्स का ध्यान रखें — चरमों के निकट प्राइस ग्रैनुलैरिटी $0.001 तक बदल सकती है।

H2: Sizing — रिस्क और कैपिटल अलोकेशन

लक्ष्य

Sizing कच्चे edge को ऑर्डर प्लान में बदल देता है: हर आउटकम के लिए कितनी शेयर खरीदनी है, और स्लिपेज सीमित करने के लिए ऑर्डर को कैसे विभाजित करना है।

कम्पोनेंट्स

एक्सपोज़र कैप्स: प्रति-मार्केट और ग्लोबल pUSD एक्सपोज़र सीमाएं।
डेप्थ-लिमिटेड साइजिंग: ask साइड पर क्रमिक प्राइस लेवल्स पर उपलब्ध संचयी वॉल्यूम की गणना करें; केवल उतनी ही साइज करें जिससे अपेक्षित स्लिपेज सहनीय सीमा में रहे।
फीस अलाउंस: ग्रॉस edge से अपेक्षित taker fee (वैरिएबल, कुछ कैटेगरी में 1.8% तक) घटाएँ फिर ट्रेड का निर्णय लें।

व्यावहारिक पैटर्न

रूढ़िवादी फील्स से शुरू करें: एक बड़े ऑर्डर के बजाय कई छोटे FAK मार्केट ऑर्डर पसंद करें जब तक कि आप बुक को नियंत्रित न करें।
यदि आप CTF split/merge फ्लोज़ के जरिए पूरा सेट खरीदते हैं, तो split/merge गैस की लागत (Relayer द्वारा संभाली जाती है) और tick size के कारण संभावित राउंडिंग को शामिल करें।

H2: Executor — ऑर्डर रखना और फाइल हैंडल करना

ऑर्डर प्रकार और बाधाएँ

ऑर्डर प्लेसमेंट के लिए CLOB ट्रेडिंग एंडपॉइंट का उपयोग करें: https://clob.polymarket.com. CLOB SDK और Relayer वॉलेट डिप्लॉयमेंट, approvals और ऑर्डर साइनिंग को संभालते हैं।
गति के लिए उपयुक्त जगहों पर FAK (Fill-And-Kill) मार्केट ऑर्डर्स का उपयोग करें। FAKs तुरंत execute करते हैं या cancel; वे lingering एक्सपोज़र से बचाते हैं पर partial-fill कर सकते हैं।

निष्पादन फ्लो

ट्रेड इरादा तैयार करें: outcome token ids और target quantities की सूची जो sizer वापस करता है।
यदि multi-outcome complete-set निष्पादित कर रहे हैं, तो आप CTF split (complete set मिंट करें) और फिर लेग्स बेचने का विकल्प अपनाते हैं — Relayer और SDK CTF ऑप्स को abstract करते हैं।
अगर आप Builder Program का हिस्सा हैं तो उचित attribution headers के साथ CLOB ट्रेडिंग API के माध्यम से ऑर्डर सबमिट करें।
WebSocket के last_trade_price और best_bid_ask अपडेट्स या CLOB trade responses से फाइल्स का अवलोकन करें।

सुरक्षा और मेल-मिलाप

पार्टियल फाइल्स को ट्रैक करें और शेष को रद्द करें या तुरंत री-प्राइस करें।
फाइल्स के बाद यह सुनिश्चित करने के लिए ऑन-चेन CTF बैलेंस (Data API के माध्यम से) की reconcile करें कि आप वास्तव में उन outcome tokens के धारक हैं जो आप उम्मीद करते थे।
ऑर्डर retries के लिए idempotency keys और nonce हैंडलिंग लागू करें।

H2: मॉनिटरिंग और ऑपरेशनल सुरक्षा

क्या मॉनिटर करें

फाइल दरें, अपेक्षित के मुकाबले औसत स्लिपेज, फीस के बाद वास्तविकीकृत edge।
WebSocket अपडेट्स और ऑर्डर सबमिशन के बीच लेटेंसी।
असामान्य घटनाएँ: UMA विवाद, tick_size_change, मार्केटप्लेस-व्यापक आउटेज।

अलर्ट्स और किल-स्विचेस

ऑटोमेटेड सॉफ्ट किल: जब नेट वास्तविक P&L किसी थ्रेशहोल्ड से नीचे गिर जाए या फिल स्लिपेज सीमाएँ पार कर जाएँ तो नए ऑर्डर प्लेसमेंट को रोक दें।
हार्ड किल: यदि UMA किसी मार्केट में विवाद रिपोर्ट करे जिसमे आपके पास पोजिशन हैं, या Relayer सेटलमेंट समस्याएँ संकेत करे, तो तुरंत सभी ट्रैफिक रोक दें।

ऑडिट लॉग्स और ऑब्ज़रवबिलिटी

सभी ऑर्डर इरादे, रॉ मार्केट स्नैपशॉट और निष्पादित फाइल्स स्टोर करें। इन लॉग्स का उपयोग पोस्ट-मोर्टेम और बैकटेस्टिंग के लिए करें।
Gamma और CLOB रिकॉर्ड से मिलाने के लिए लॉग्स को market id, condition_ids, और request ids के साथ टैग करें।

H2: Builder Program, क्रेडेंशियल्स, और रेट लिमिट्स

यदि आप attribution के साथ ऑर्डर्स route करने का इरादा रखते हैं तो Builder Program में शामिल हों और Polymarket सेटिंग्स के माध्यम से keys मैनेज करें। Builder tiers दैनिक relayer सीमाएँ और रिवार्ड नियंत्रित करते हैं। CLOB के माध्यम से ट्रेडिंग के लिए आपको API key + HMAC चाहिए और रेट लिमिट्स एवं relayer कोटा का सम्मान करना होगा।

H2: सामान्य जोखिम और निवारण

गणितीय edge को गारंटीकृत न मानें। ध्यान देने योग्य जोखिम:

Resolution risk: UMA विवाद payouts को रोक या बदल सकते हैं।
स्लिपेज और पार्टियल फाइल्स: FAKs पार्टियल-फिल कर सकते हैं; शेष एक्सपोज़र की योजना बनाएं।
फीस: taker fees कैटेगरी के अनुसार बदलती हैं और छोटे edges को कम कर सकती हैं (Geopolitics fee-free है)।
सेटलमेंट समय: redeem/merge का समय और ऑरेकल रेज़ॉल्यूशन देरी पूंजी को बाँध सकती है।
स्मार्ट-कॉन्ट्रैक्ट या Relayer फेल्योर: फ़ॉलबैक और मानवीय अलर्टिंग को उपकरणबद्ध करें।

यह आपके ट्रेडिंग को कैसे प्रभावित करता है

अपने बॉट को इस तरह डिज़ाइन करें कि हर ट्रेड यूनिट छोटा, ऑब्ज़र्वेबल और आपके रिस्क लिमिट्स के भीतर उलटने योग्य हो। रूढ़िवादी साइजिंग, तेज़ मॉनिटरिंग और स्पष्ट किल कंडीशंस टेल रिस्क कम करते हैं। निर्धारित मार्केट स्टेट के लिए Gamma और CLOB endpoints का उपयोग करें और तेज़ निष्पादन के लिए FAK ऑर्डर्स प्राथमिकता दें, पर हमेशा वास्तविकीकृत स्लिपेज को अपेक्षाओं के विरुद्ध मापें।

समापन

ऊपर दिया गया आर्किटेक्चर एक व्यवहारिक ब्लूप्रिंट देता है ताकि आप एक Polymarket ट्रेडिंग बॉट बना सकें: हाई-थ्रूपुट स्कैनर, रूढ़िवादी साइज़र, CLOB और Relayer का उपयोग करके मजबूत एग्जीक्यूटर, और लेयर्ड मॉनिटरिंग। छोटे से शुरू करें, कड़ाई से इंस्ट्रूमेंट करें, और लाइव डेटा जमा होने पर साइजिंग और फ़िल्टर्स पर इटरेट करें।

अक्सर पूछे जाने वाले प्रश्न

मार्केट लिस्टिंग और लाइव बुक डेटा पाने के लिए किन APIs का उपयोग करना चाहिए?

रीयल-टाइम ऑर्डर बुक और best_bid_ask इवेंट्स के लिए https://gamma-api.polymarket.com (मार्केट मेटाडेटा, /markets) और wss://ws-subscriptions-clob.polymarket.com/ws/market का उपयोग करें। ऑर्डर-बुक रीड और ट्रेडिंग के लिए https://clob.polymarket.com का उपयोग करें; रीड सार्वजनिक हैं पर ट्रेडिंग के लिए API key + HMAC चाहिए।

Arbitrage के लिए मुझे limit ऑर्डर्स या market (FAK) ऑर्डर्स का उपयोग करना चाहिए?

तेज़ी और lingering एक्सपोज़र से बचने के लिए FAK (Fill-And-Kill) मार्केट ऑर्डर्स सामान्यतः उपयोग किए जाते हैं। वे पार्टियल-फिल कर सकते हैं, इसलिए साइजिंग और रिकॉन्सिलिएशन उसी के अनुसार डिजाइन करें। CLOB SDK FAK मार्केट ऑर्डर्स बनाने के लिए हेल्पर्स एक्सपोज़ करता है।

ट्रेड साइज करते समय फीस का हिसाब कैसे रखें?

ट्रेड करने से पहले अपने ग्रॉस edge में से अपेक्षित taker फीस घटाएँ। Taker फीस कैटेगरी के अनुसार बदलती हैं (वर्तमान में 0% से 1.8% तक)। फीस के साथ-साथ अपेक्षित स्लिपेज और मॉनिटरिंग बफ़र्स को कवर करने वाला नेट-एज थ्रेशहोल्ड उपयोग करें।

लाइव बॉट के लिए कौन सी मॉनिटरिंग आवश्यक है?

फिल दरें, वास्तविकीकृत स्लिपेज, लेटेंसी, UMA विवाद नोटिस, tick_size_change इवेंट्स, और Relayer स्वास्थ्य मॉनिटर करें। बड़े स्लिपेज, P&L ड्रॉडाउन, या ऑरेकल विवादों के लिए सॉफ्ट और हार्ड किल-स्विचेस लागू करें।

क्या मैं Builder Program के माध्यम से ऑर्डर्स route कर सकता/सकती हूँ?

हाँ। Builder Program तीसरे पक्षों को attribution के साथ ऑर्डर्स रूट करने और builder fees कमाने देता है। Tiers दैनिक relayer लिमिट और रिवार्ड नियंत्रित करते हैं; क्रेडेंशियल्स polymarket.com/settings पर प्राप्त होते हैं।

सिर्फ़ शैक्षिक जानकारी। वित्तीय, कानूनी या कर संबंधी सलाह नहीं। संभावित रूप से आपका क्षेत्र Polymarket के लिए उपलब्ध नहीं हो सकता।

Polymarket बॉट बनाएं: स्कैनर, साइजिंग, निष्पादन के लिए आर्किटेक्चर