كيف تبني بوت تداول على Polymarket

بوت Polymarket ست قطع: اكتشاف الأسواق، وقراءة الأسعار، واتخاذ القرار، وتقديم الأوامر، وإدارة المراكز، والبقاء حيًا. الأوليان سهلتان، والرابعة مزعجة التفاصيل، والسادسة هي حيث تموت معظم البوتات فعلًا. يمر هذا الدليل بالمسار كله مع شيفرة متحقَّق منها، ويتحدث بصراحة عن الأجزاء الصعبة حقًا.

الخطوة 0: حدّد ما يتداوله بوتك

يستحق القيام بذلك قبل أن تكتب سطرًا واحدًا، لأنه يحدد كل ما يليه. تنقسم أسواق Polymarket إلى عائلتين لا يجمعهما شيء تقريبًا:

إذا كنت تؤتمت، فأنت مهتم على الأرجح بالعائلة الثانية — عالية التردد، ومتواصلة، وآلية بما يكفي لترميزها. وهي مغطاة بالتفصيل في شرح أسواق Up/Down.

الخطوة 1: ثبّت حزمة SDK الحالية

تمنحك كلتا الحزمتين واجهة عميل واحدة لكل واجهات API الخاصة بـ Polymarket، ونماذج ذات أنواع محددة، وترقيمًا متسقًا للصفحات، وتوقيعًا مدمجًا — وهذا قدر كبير من العمل المزعج الذي لا تريد إعادة تنفيذه.

pip install polymarket-client
# or: uv add polymarket-client / poetry add polymarket-client

هناك أربعة عملاء في Python، واختيار الصحيح منها أهم مما يبدو:

الخطوة 2: اعثر على الأسواق

اكتشاف الأسواق العامة لا يتطلب أي بيانات اعتماد. أداة الترقيم في SDK متسقة عبر كل دوال السرد، لذا يمكن تعميم هذا النمط.

import asyncio
from polymarket import AsyncPublicClient


async def main() -> None:
    async with AsyncPublicClient() as client:
        pages = client.list_markets(closed=False, page_size=50)

        # Iterate items directly when page boundaries do not matter.
        async for market in pages.iter_items():
            if "updown" in (market.slug or ""):
                print(market.slug, market.condition_id)


asyncio.run(main())

أمران يجب استيعابهما هنا. أولًا، page.next_cursor مؤشر معتم — خزّنه حرفيًا إذا أردت استئناف المسح لاحقًا، ولا تحاول تحليله أو تكوينه. ثانيًا، تحمل /markets أضيق حد معدل في المنصة كلها عند 300 طلب / 10 ثوانٍ، لذا خزّن البيانات الوصفية للأسواق مؤقتًا بدلًا من إعادة سردها في حلقة ساخنة. الأرقام الكاملة في مرجع حدود المعدل.

الخطوة 3: المصادقة

التداول يتطلب محفظة. تبني حزمة Python SDK الموقِّع من مفتاح خاص محلي:

import os
from polymarket import AsyncSecureClient

client = await AsyncSecureClient.create(
    private_key=os.environ["POLYMARKET_PRIVATE_KEY"],
    wallet=os.environ["POLYMARKET_WALLET_ADDRESS"],
)

في العمق، تستخدم Polymarket طبقتي مصادقة: L1 توقيع محفظة EIP-712 يثبت أنك تتحكم في العنوان ويتيح لك إنشاء بيانات اعتماد API أو اشتقاقها؛ وL2 توقّع كل طلب خاص بتلك البيانات باستخدام HMAC-SHA256. تتولى SDK كلتيهما، وهذا هو السبب الرئيسي لاستخدامها.

الخطوة 4: احصل على الأسعار الآنية

الخطأ المعماري الأكثر شيوعًا في أول بوت هو استطلاع /book على مؤقت. فهذا يستهلك ميزانية حد المعدل، ويضيف تأخيرًا، ويتوسع بشكل سيئ. اشترك بدلًا من ذلك — تدمج SDK عدة تغذيات في تدفق أحداث واحد.

from polymarket.streams import MarketSpec

async with await client.subscribe([MarketSpec(token_ids=[token_id])]) as stream:
    async for event in stream:
        # MarketBookEvent | MarketPriceChangeEvent | MarketLastTradePriceEvent
        # | MarketTickSizeChangeEvent | MarketBestBidAskEvent
        # | NewMarketEvent | MarketResolvedEvent
        handle(event)

إذا اتصلت بـ WebSocket الخام بدلًا من استخدام SDK، فيجب أن ترسل PING كل 10 ثوانٍ وإلا يُقطع الاتصال، وتحتاج إلى custom_feature_enabled: true لتلقي أحداث best_bid_ask وnew_market وmarket_resolved أصلًا. هذه الأمور وأنماط إعادة الاتصال مشروحة في دليل WebSocket. وبشكل منفصل، انتقلت الأسعار المرجعية إلى PolyBolt في 15 سبتمبر 2026 — إذا كان بوتك يبث الأسعار الفورية، فراجع دليل الانتقال.

الخطوة 5: قدّم أمرًا

أمر السوق هو أبسط شيء يعمل، وamount مقوّم بعملة pUSD التي أنت مستعد لإنفاقها لا بالأسهم:

market = await client.get_market(slug="<market-slug>")
token_id = market.outcomes.yes.token_id
assert token_id is not None

response = await client.place_market_order(
    token_id=token_id,
    side="BUY",
    amount="10",          # spend up to 10 pUSD
)

if not response.ok:
    raise RuntimeError(response.message)

# Settlement is on-chain and asynchronous — this waits for it.
hashes = await client.wait_for_order_fill_settlement(response)

بالنسبة لأوامر الحد القائمة، ستلدغك قاعدتان قبل أي شيء آخر. يجب أن تقع الأسعار على شبكة التيك الخاصة بالسوق — استدعِ GET /tick-size لكل سوق بدلًا من افتراض 0.01، لأن حجم التيك يختلف وقد يضيق مع نضج السوق. والأوامر التي تقل عن الحد الأدنى للحجم في السوق تُرفض مباشرة. وكلاهما يعود كأخطاء 400 برسائل محددة، مدرجة في مرجع الأخطاء.

الخطوة 6: اعرف ما إذا كانت الاستراتيجية تنجح

كل ما سبق توصيلات، والتوصيلات هي النصف السهل. السؤال الصعب هو ما إذا كانت استراتيجيتك تجني المال — وهنا يفترق بناء بوتات Polymarket بحدة عن بناء بوتات العملات المشفرة الفورية.

لا توجد شبكة اختبار. لا sandbox، ولا API تجريبية، ولا نقطة نهاية للتداول الورقي. هذه الكلمات لا تظهر في أي مكان من وثائق Polymarket. أول أمر حقيقي لك هو أموال حقيقية مقابل أطراف مقابلة حقيقية. راجع هل لدى Polymarket شبكة اختبار للبدائل الأربعة.

ولا يوجد دفتر أوامر تاريخي. بمجرد حسم السوق، يُرجع دفتره 404. وتحتفظ بسلسلة أسعار بمعدل نقطة واحدة تقريبًا في الدقيقة، وفقط إذا طلبتها ببداية ونهاية صريحتين:

TOK=<token_id_of_a_resolved_market>
START=<epoch seconds the window opened>
END=$((START + 300))

curl -s "https://clob.polymarket.com/book?token_id=$TOK"
# {"error":"No orderbook exists for the requested token id"}   HTTP 404

curl -s "https://clob.polymarket.com/prices-history?market=$TOK&startTs=$START&endTs=$END&fidelity=1"
# about 6 points for a 5-minute market; interval=max returns [] for older ones

لذا لا يمكنك إجراء اختبار رجعي من Polymarket. تحتاج إلى لقطات عند لحظات زمنية محددة سجّلها أحدهم أثناء تشغيل الأسواق. وهذا ما توفره PolyTest لأسواق Up/Down للعملات المشفرة — 240M+ لقطة، و8 مستويات من عمق الدفتر لكل جانب، وطوابع زمنية بدقة أقل من الثانية، مع الاحتفاظ بالأسواق المحسومة:

import os, requests

BASE = "https://api.polytest.io/api/v1"
H = {"X-API-Key": os.environ["POLYTEST_KEY"]}

markets = requests.get(f"{BASE}/markets",
                       params={"coin": "btc", "market_type": "5m", "limit": 50},
                       headers=H).json()["markets"]

snaps = requests.get(f"{BASE}/markets/{markets[0]['id']}/snapshots",
                     params={"include_orderbook": "true"},
                     headers=H).json()["snapshots"]


def simulate_fill(levels, qty):
    """Walk the ladder. Mid-price is not a price you can trade at."""
    filled = cost = 0.0
    for lvl in levels:
        take = min(lvl["size"], qty - filled)
        cost += take * lvl["price"]
        filled += take
        if filled >= qty:
            break
    return cost / filled if filled >= qty else None


print(simulate_fill(snaps[0]["orderbook"]["asks"], 500))

الخطوة 7: اصمد أمام بيئة الإنتاج

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

• اختبر مسار الإلغاء قبل مسار الدخول. العجز عن الخروج أسوأ بكثير من العجز عن الدخول.
• ضع سقفًا للتعرض في الشيفرة، لا في ذهنك. حد صارم للمركز يحوّل الخطأ المنطقي إلى خسارة صغيرة بدلًا من خسارة غير محدودة.
• ابنِ مفتاح إيقاف طارئ واختبره فعلًا. مفتاح الإيقاف غير المختبَر مجرد تعليق.
• أضف تذبذبًا عشوائيًا إلى المهام المجدولة. العمّال الذين يستيقظون في الثانية نفسها بالضبط يخلقون ذروة متزامنة أعلى بكثير من معدلك المتوسط.
• سجّل كل طلب واستجابة في الأسبوع الأول. ستحتاج إليها، ولا يمكنك إعادة بنائها لاحقًا.
• أطلق التنبيهات حسب الفئات، لا حسب الرسائل. تُضمّن Polymarket معرّفات الأوامر والأسعار في نصوص الأخطاء، لذا فالتنبيه حسب النص الخام مجرد ضوضاء.

ترتيب بناء واقعي

التسلسل الذي يهدر أقل قدر من الوقت والمال:

1. تكامل للقراءة فقط، بالعميل العام، بلا مفاتيح. أثبت الاكتشاف والتحليل وترقيم الصفحات والتراجع. يوم واحد، مجانًا.
2. أجرِ اختبارًا رجعيًا للاستراتيجية على دفاتر تاريخية مع محاكاة صادقة للتنفيذ. معظم الأفكار تموت هنا. وهذا هو المقصود.
3. تداول ورقيًا مباشرة لمدة أسبوع على الأقل — سجّل الأوامر المقصودة بدلًا من إرسالها. يثبت ذلك وقت التشغيل وإعادة الاتصال والتوقيت.
4. ابدأ مباشرة بالحد الأدنى للحجم مع سقف صارم للتعرض ومفتاح إيقاف طارئ مختبَر.
5. لا توسّع إلا حين تطابق الأرقام المباشرة الأرقام الورقية. إذا تباعدت، فنموذج التنفيذ لديك كان خاطئًا — عُد إلى الخطوة 2.

الخطوات 1 و3 و4 يمكنك بناؤها في بضعة أيام. أما الخطوة 2 فتحتاج إلى بيانات لا تحتفظ بها Polymarket، وهي أيضًا الخطوة الأكثر موثوقية في توفير المال. ابدأ فترة تجريبية مجانية على PolyTest — تكفي لتعرف ما إذا كانت فكرتك تصمد أمام الفارق.