Genesis Arbitrage

Genesis Arbitrage · · 13 دقائق قراءة

Polymarket API وKalshi API: الأسعار ودفاتر الأوامر والأربيتراج بينهما

باختصار

  • يقدّم Polymarket وKalshi الأسواق والأسعار ودفاتر الأوامر عبر REST API رسمية بلا مفتاح. المفتاح والطلب الموقَّع مطلوبان لإرسال الأوامر، وفي Kalshi أيضاً لفتح اتصال WebSocket.
  • سعر العقد جزء من الدولار: 0.42 يعني 42 سنتاً وتقريباً احتمال 42% في تقدير السوق. وحده دفتر الأوامر يُظهر كم يكلّف حجم معيّن.
  • الأربيتراج بين المنصات يعني مطابقة الأحداث، والتحقق من قواعد التسوية وتواريخها، وتمرير الأوامر عبر الدفاتر، وخصم الرسوم. تعيد نقطة النهاية /predictions/arbitrage في Genesis API حزماً محسوبة بكل ذلك؛ وتنفّذ الصفقات بنفسك.

Polymarket API وKalshi API هما الواجهتان البرمجيتان الرسميتان لمنصتين من منصات أسواق التنبؤ: عبرهما يقرأ البرنامج الأسواق وأسعار عقود YES وNO ودفاتر الأوامر، وبمفتاح وطلب موقَّع يرسل الأوامر. بيانات السوق على المنصتين مقروءة بلا مفتاح. وللأربيتراج بين المنصتين لا تكفي الأسعار: يجب مطابقة الأحداث وحساب الربح عبر دفاتر الأوامر مع الرسوم. والحزم الجاهزة تأتي من نقطة النهاية /predictions/arbitrage في Genesis API.

كيف تُبنى بيانات أسواق التنبؤ

يتداول سوق التنبؤ عقوداً على نتيجة حدث ما. كل سوق سؤال بنعم أو لا: عقد YES يدفع 1$ إن وقع الحدث، وعقد NO يدفع 1$ إن لم يقع. كيف تُسوّي المنصات الأسواق ولماذا تتباعد أسعارها شرحناه في مقال أسواق التنبؤ: كيف يعمل Polymarket وKalshi وفي الدرس ما هي أسواق التنبؤ. وهنا نرى كيف تبدو الكائنات نفسها في الـ API.

PolymarketKalshi
مجموعة الأسواقحدث فيه سوق واحد أو أكثرسلسلة (series) تضم أحداثاً
السوقشرط ثنائي بنتيجتين Yes وNoسوق ثنائي له رمز (ticker)
النتيجة في الـ APIلكل من Yes وNo معرّف tokenجانبا YES وNO في سوق واحد
السعرمن 0.00$ إلى 1.00$سلسلة نصية بالدولار، مثل "0.4200"
دفتر الأوامرطلبات شراء وعروض بيع لكل نتيجةطلبات شراء YES وNO فقط

السعر جزء من الدولار: 0.42 تعني 42 سنتاً لعقد يدفع 1$ إذا تحققت نتيجته. ولهذا يُقرأ السعر كتقدير السوق للاحتمال، وهنا نحو 42%. يعرض موقع Polymarket النقطة الوسطى بين أفضل طلب شراء وأفضل عرض بيع، أو سعر آخر صفقة حين يتجاوز السبريد مبلغ 0.10$ (وثائق Polymarket). ولتسعير صفقة تستخدم دفتر الأوامر.

دفتر الأوامر: طلبات الشراء وعروض البيع والأسعار المرآتية

دفتر الأوامر قائمة أوامر الشراء (bids) وأوامر البيع (asks) بأسعارها وأحجامها. في Polymarket لكل نتيجة دفترها الخاص، ويُطلب بواسطة token_id. أما Kalshi فيعيد طلبات الشراء فقط للجانبين: طلب شراء YES بسعر X يساوي عرض بيع NO بسعر 1.00$ − X (وثائق Kalshi).

مثال توضيحي: أفضل طلب شراء NO في Kalshi هو 0.58. إذن YES معروض بسعر 1 − 0.58 = 0.42، أي 42 سنتاً.

واجهتا Polymarket وKalshi الرسميتان

Polymarket

تأتي بيانات Polymarket من ثلاث REST API ومن تدفقات WebSocket (نظرة عامة على الـ API). بيانات السوق، ومنها أسعار CLOB ودفاتر الأوامر، لا تحتاج مفتاحاً.

APIماذا تعطيك
Gamma APIالأحداث والأسواق: البيانات الوصفية والتواريخ ومعرّفات النتائج
CLOB APIالأسعار ودفاتر الأوامر؛ وبالمفاتيح الأوامر
Data APIمراكز المحافظ ونشاطها، وسجل الأسعار
WebSocketقناة market للدفاتر والأسعار؛ وقناة user لأوامر الحساب وصفقاته

تمر الأوامر بـمصادقة CLOB على خطوتين: توقيع المحفظة (L1) يُصدر بيانات اعتماد CLOB (L2) التي توقّع طلبات التداول. ويأتي معرّف النتيجة للدفتر من Gamma API: أسواق v1 تحمله في سلسلة JSON باسم clobTokenIds، وأسواق v2 في positionIds؛ والفهرس 0 هو YES و1 هو NO (حقول السوق). وبدل الطلبات الخام يمكنك استخدام SDK الرسمية بلغة Python، وهي حزمة polymarket-client.

Kalshi

لأسواق التنبؤ يقدّم Kalshi واجهة REST (Trade API v2) وWebSocket وFIX. مضيف REST الموصى به هو external-api.kalshi.com؛ والمضيف الأقدم api.elections.kalshi.com ما زال يعمل، وتوجد بيئة تجريبية (demo) منفصلة للاختبار (بيئات الـ API). السلاسل والأحداث والأسواق ودفاتر الأوامر والصفقات عامة.

يُوقَّع طلب التداول بمفتاح خاص (Ed25519 أو RSA): معرّف المفتاح والطابع الزمني والتوقيع تُرسَل في الترويسات KALSHI-ACCESS-KEY وKALSHI-ACCESS-TIMESTAMP وKALSHI-ACCESS-SIGNATURE (مفاتيح Kalshi API). وشروط السوق، ومنها قواعد التسوية، تأتي نصاً في rules_primary وrules_secondary؛ وأفضل الأسعار في yes_bid_dollars وyes_ask_dollars وno_bid_dollars وno_ask_dollars.

متى تحتاج مفتاحاً

ماذاPolymarketKalshi
الأسواق والأسعار والدفاتر (REST)بلا مفتاحبلا مفتاح
تدفق الدفتر (WebSocket)قناة market، بلا مفتاحالمفتاح مطلوب، حتى للقنوات العامة
الأوامرتوقيع المحفظة وبيانات اعتماد CLOBطلب موقَّع بمفتاح خاص

قراءة دفتر الأوامر بلا مفتاح: curl وPython

# Polymarket: the book of one outcome by token_id
curl "https://clob.polymarket.com/book?token_id=$TOKEN_ID"

# Kalshi: the book of a market by ticker
K=https://external-api.kalshi.com/trade-api/v2
curl "$K/markets/$TICKER/orderbook"

يعيد Polymarket الحقلين bids وasks، وهما مستويات فيها price وsize كسلاسل نصية، إضافة إلى tick_size وmin_order_size. ويعيد Kalshi كائن orderbook_fp فيه المصفوفتان yes_dollars وno_dollars، وكل مستوى فيهما زوج: السعر بالدولار وعدد العقود.

كلفة حجم معيّن لا تظهر إلا عند المرور على المستويات. تمرّ هذه الدالة على عروض بيع Polymarket بدءاً من أفضلها وتعيد أفضل سعر ومتوسطه وأسوأه:

import requests

CLOB = "https://clob.polymarket.com"


def walk_asks(token_id: str, shares: float):
    """Best, average and worst price to buy `shares` shares.

    The platform fee is not included here.
    """
    r = requests.get(f"{CLOB}/book", params={"token_id": token_id},
                     timeout=10)
    r.raise_for_status()
    left, cost, prices = shares, 0.0, []
    for level in reversed(r.json()["asks"]):  # the best ask is last
        price, size = float(level["price"]), float(level["size"])
        take = min(left, size)
        cost += take * price
        prices.append(price)
        left -= take
        if left <= 1e-9:
            return prices[0], round(cost / shares, 4), prices[-1]
    return None  # the book is too thin for the full size


print(walk_asks("TOKEN_ID_YES", 1000))

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

ما الذي يجعل أربيتراج Polymarket وKalshi صعباً

الأربيتراج بين منصات التنبؤ يعني شراء YES على منصة وNO على الأخرى حين يكلّفان معاً أقل من 1$: إذا حُسم الحدث بالطريقة نفسها على المنصتين، تدفع إحدى الساقين 1$ مهما حدث. مقارنة سعرين عبر الـ API الرسمية سهلة؛ ولا يصير الزوج صفقة إلا بعد خمسة فحوصات.

الفحصسبب صعوبته
مطابقة الأحداثصياغة الأسئلة مختلفة، والمعرّفات والبنية تختلف: حدث فيه أسواق في Polymarket، وسلسلة فيها أحداث في Kalshi
قواعد التسويةقد يختلف المصدر والصياغة والحالات الحدّية تحت العنوان نفسه
تواريخ التسويةتُغلق الأسواق في أيام مختلفة؛ وتبقى الأموال مجمّدة حتى التاريخ الأبعد
الرسومصيغ مختلفة: في Polymarket يدفع الـtakers فقط، وفي Kalshi يُحدَّد نوع الرسم لكل سلسلة
عمق الدفترعدد محدود فقط من العقود يُباع بأفضل سعر

في Polymarket يدفع الـtaker وحده الرسم، ويعتمد مقداره على سعر السهم وفئة السوق (رسوم Polymarket). وفي Kalshi يقيم نوع الرسم والمضاعِف على مستوى السلسلة، في الحقلين fee_type وfee_multiplier (السلسلة في Kalshi API). تحتاج أموالاً على المنصتين مسبقاً، ويعتمد الوصول إلى كل منهما على بلدك وقواعد المنصة.

مثال محسوب: YES على Polymarket وNO على Kalshi

مثال توضيحي: سوق «يقع الحدث X قبل 31 ديسمبر» مدرج على المنصتين بقواعد متطابقة ويُسوّى بعد 46 يوماً. تريد 1,000 سهم من كل جانب.

الساقمستويات الدفترالكلفة
YES على Polymarket500 بسعر 0.40 و500 بسعر 0.41200 + 205 = 405$
NO على Kalshi600 بسعر 0.55 و400 بسعر 0.56330 + 224 = 554$

عروض بيع NO في Kalshi تأتي من طلبات شراء YES: طلب شراء YES بسعر 0.45 لـ600 عقد هو عرض بيع NO بسعر 0.55، وطلب بسعر 0.44 لـ400 عقد هو عرض بسعر 0.56.

بأفضل الأسعار يكلّف الزوج 0.40 + 0.55 = 0.95: هامش 5 سنتات للسهم، أي 0.05 / 0.95 = 5.26% على المال المدفوع. ومتوسطا سعر التنفيذ عبر الدفاتر 0.405 و0.554، ومجموعهما 0.959، فيتقلص الهامش إلى 4.1 سنت. الرسوم في المثال 6$ على Polymarket و17$ على Kalshi، أي 23$ في المجموع.

الربح هو العائد ناقص كلفة الساقين والرسوم، والمعدل السنوي (APR) يُشتق من أيام التسوية:

في المثال: 1,000 − 959 − 23 = 18$ ربحاً، و18 / 982 × 100 = 1.83% على المال المدفوع، و1.83 × 365 / 46 = 14.5% سنوياً. ومن الـ5.26% بأفضل الأسعار يبقى نحو الثلث بعد الدفاتر والرسوم.

إذا حُسم الحدث بالطريقة نفسها على المنصتين، تدفع إحدى الساقين 1,000$ مهما حدث: يدخل 982$ ويعود 18$ إضافية. وإذا اختلفت القواعد وخسرت الساقان معاً، فالخسارة هي 982$ كاملة.

أربيتراج التنبؤات في Genesis API

تعيد نقطة النهاية /predictions/arbitrage حزماً أُنجز فيها هذا العمل. تُطابَق الأسواق على Polymarket وKalshi وLimitless وPredict.fun وOpinion، وتُمرَّر كل ساق عبر دفترها مع الرسوم، ويُحسب الربح بالدولار والنسبة المئوية وAPR وأيام التسوية. هذه هي بيانات صفحة مراجحة التنبؤات بصيغة JSON.

modeماذا تحصلخطط API
exactأحداث متطابقة تماماً على منصتين، وهو الافتراضيStart وPro وMax
dutchYES على كل نتائج حدث واحد على منصة واحدةStart وPro وMax
llmأزواج أحداث تحقق منها الذكاء الاصطناعيPro وMax
sportسيربيت المراهنات عبر 13 منصة، قبل المباراة فقطPro وMax

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

{
  "kind": "cross",
  "match": "exact",
  "title": "Will event X happen by December 31?",
  "days_left": 46,
  "shares": 1000,
  "size_usd": 959,
  "fees_usd": 23,
  "profit_usd": 18,
  "profit_pct": 1.83,
  "apr_pct": 14.5,
  "risks": [],
  "legs": [
    {
      "platform": "polymarket",
      "side": "yes",
      "price_best": 0.4,
      "price_avg": 0.405,
      "price_worst": 0.41,
      "cost_usd": 405,
      "fee_usd": 6
    },
    {
      "platform": "kalshi",
      "side": "no",
      "price_best": 0.55,
      "price_avg": 0.554,
      "price_worst": 0.56,
      "cost_usd": 554,
      "fee_usd": 17
    }
  ]
}

في الساق يحدد side ما تشتريه: yes أو no أو bet، أي رهان لدى شركة مراهنات. وprice_best وprice_avg وprice_worst هي أفضل سعر ومتوسطه وأسوأه عند المرور على الدفتر؛ وcost_usd وfee_usd كلفة الساق ورسمها؛ وurl رابط السوق. وتكون قيمة apr_pct هي null حين يقل الوقت إلى التسوية عن يوم.

تنبّه الرموز في risks إلى ما لا تستطيع الحسابات التحقق منه: rules_differ تعني أن قواعد التسوية على المنصتين قد تختلف، وend_mismatch تعني اختلاف تواريخ التسوية. وفي وضع sport تكون قيمة profit_usd في الحزمة ذات ساق شركة المراهنات هي null، لأن حد الرهان غير معروف. وسيربيت المراهنات مشروحة في مقال API احتمالات شركات المراهنات.

صفِّ الحزم بـmin_profit_pct وmin_profit_usd وmin_apr وmax_days وplatform وcategory. كل الفلاتر والحقول في دليل أسواق التنبؤ وسيربيت المراهنات في Genesis API. ودون كود، الحزم نفسها في صفحة الخدمة؛ وأعمدتها ووسومها مشروحة في دليل مراجحة التنبؤات.

حالة المنصات والتحليلات والصفقات

نقطة النهايةماذا تعيدخطط API
/predictions/platformsوضع تغذية المنصة (ws أو rest أو down)، ووقت آخر الأسعار وآخر مسح كامل، وعدد الأسواقStart وPro وMax
/predictions/analyticsالفائدة المفتوحة وحجم التداول، وتحركات الأسعار خلال ساعة و24 ساعة، وتدفقات الأموالPro وMax
/predictions/smart-moneyالصفقات الكبيرة والحيتان خلال 24 ساعة، وأنماط المطّلعين، وتركّز المراكزPro وMax
/predictions/tradesشريط صفقات Polymarket: مباشرة من 1,000$، وصفقات المحافظ الذكية من 100$، وtakers اليوم وخلال 7 أيام من 5,000$Pro وMax
/predictions/tradersأفضل 300 متداول في Polymarket بحسب PnL خلال 30 يوماً أو 7 أيام أو كل الفترةPro وMax

اطلب /predictions/platforms مع الحزم: إذا كانت تغذية منصة ما down، فقد تكون أسعارها في الحزم قديمة. تحمل كل صفقة في الشريط وسوم المحفظة (tags) وعلم insider ودور taker أو maker وbid_now وask_now الحاليين للنتيجة. ووسم insider يصف سلوك المحفظة ولا يثبت شيئاً.

على Trial تعيد هذه النقاط 403 plan_restricted. تكلّف Start مبلغ 50$ شهرياً وتتحدّث البيانات كل 30 ث، وPro مبلغ 100$ وكل 10 ث، وMax مبلغ 200$ وكل 5 ث. قارن الخطط في أسعار Genesis API؛ والشاشات نفسها على الموقع هي التحليلات والأموال الذكية.

Python: حزم exact مع min_profit_pct وmax_days

كل meta.freshness_sec ثانية يجلب السكربت حزم exact بربح لا يقل عن 1% وتُسوّى خلال 60 يوماً. يتخطى الحزم التي فيها منصة بحالة down ويطبع الباقي بأسعار المرور على الدفتر. يأتي المفتاح من متغير البيئة GENESIS_API_KEY؛ وطريقة الحصول عليه في البداية السريعة.

import os
import time

import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PARAMS = {"mode": "exact", "min_profit_pct": 1, "max_days": 60}


def get(path, params=None):
    while True:
        r = requests.get(f"{API}{path}", headers=HEADERS,
                         params=params, timeout=10)
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # the period quota is used up
                raise SystemExit(f"Wait {wait} s: quota exhausted")
            time.sleep(wait)
            continue
        r.raise_for_status()  # 403: endpoint or mode not in your plan
        return r.json()


while True:
    feeds = get("/predictions/platforms")["data"]["platforms"]
    down = {p["platform"] for p in feeds if p["mode"] == "down"}
    body = get("/predictions/arbitrage", PARAMS)
    for b in body["data"]:
        if any(leg["platform"] in down for leg in b["legs"]):
            continue  # this platform's prices may be stale
        print(f"{b['profit_pct']}% · ${b['profit_usd']} · "
              f"APR {b['apr_pct']} · {b['days_left']} d · "
              f"{b['title'][:40]}")
        for leg in b["legs"]:
            print(f"  {leg['platform']} {leg['side']}: "
                  f"{leg['price_best']} / {leg['price_avg']} / "
                  f"{leg['price_worst']}, fee ${leg['fee_usd']}")
        if b["risks"]:
            print("  risks:", ", ".join(b["risks"]))
    time.sleep(body["meta"]["freshness_sec"])

كل دورة تجري طلبين. على Start هذا 2 × 86,400 / 30 = 5,760 طلباً في اليوم و5,760 × 30 = 172,800 كل 30 يوماً مقابل حصة 2M. الاستجابة المصفّاة تأتي بلا ETag، فالتوفير هنا في فاصل الاستعلام الدوري: الاستعلام أسرع من meta.freshness_sec لا يجلب بيانات جديدة. المزيد في دليلي حدود Genesis API والاستجابات والأخطاء.

أسئلة وأجوبة

هل لدى Polymarket API رسمية؟

نعم. تقدّم Gamma API الأحداث والأسواق، وCLOB API الأسعار ودفاتر الأوامر والأوامر، وData API المراكز والنشاط وسجل الأسعار، وتُبث تحديثات الدفتر عبر WebSocket. بيانات السوق لا تحتاج مفتاحاً؛ والأوامر تحتاج توقيع المحفظة وبيانات اعتماد CLOB. راجع وثائق Polymarket.

هل أحتاج مفتاحاً لقراءة أسواق Kalshi؟

ليس مع REST: السلاسل والأحداث والأسواق ودفاتر الأوامر والصفقات عامة (البداية السريعة في Kalshi). والمفتاح مطلوب للأوامر وللاتصال بـWebSocket، حتى لو أردت القنوات العامة فقط.

هل أستطيع التداول عبر Genesis API؟

لا. Genesis API يقرأ البيانات فقط ولا يرسل أوامر. تفتح الحزمة بنفسك على المنصات عبر الروابط legs[].url. أما التداول الآلي عبر API الرسمية في Polymarket وKalshi فخارج Genesis API وعلى مسؤوليتك.

كم مرة تُحدَّث البيانات؟

يقدّم Genesis API لقطة جديدة كل meta.freshness_sec: 30 ث على Start و10 ث على Pro و5 ث على Max. وحداثة أسعار المنصات نفسها يُظهرها quotes_at وfull_scan_at في /predictions/platforms.

أي خطة Genesis API أحتاج لأربيتراج Polymarket وKalshi؟

Start: فهي تشمل الوضعين exact وdutch وحالة المنصات. أما الوضعان llm وsport والتحليلات والأموال الذكية والصفقات وترتيب المتداولين ففي Pro وMax.