Genesis Arbitrage

Genesis Arbitrage · · 14 دقیقه مطالعه

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 اگر رخ ندهد. اینکه پلتفرم‌ها بازارها را چگونه تسویه می‌کنند و چرا قیمت‌هایشان از هم فاصله می‌گیرد، در مقاله بازارهای پیش‌بینی چیستند: 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 سنت.

API های رسمی 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 رسمی پایتون، یعنی بسته polymarket-client، استفاده کنید.

Kalshi

برای بازارهای پیش‌بینی Kalshi یک REST API (نسخه 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 فقط تیکرها می‌پردازند، در 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اوپن اینترست و حجم، حرکت قیمت در 1 ساعت و 24 ساعت، جریان‌های پولPro، Max
/predictions/smart-moneyمعاملات بزرگ و نهنگ‌ها در 24 ساعت، الگوهای خودی، تمرکز موقعیت‌هاPro، Max
/predictions/tradesنوار معاملات Polymarket: زنده از 1,000 دلار و معاملات کیف‌پول‌های هوشمند از 100 دلار، تیکرهای امروز و 7 روز از 5,000 دلارPro، Max
/predictions/traders300 معامله‌گر برتر 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 می‌آید، پس صرفه‌جویی اینجا در فاصله polling است: polling سریع‌تر از 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 نشان می‌دهد.

برای آربیتراژ Polymarket و Kalshi کدام پلن Genesis API لازم است؟

Start: حالت‌های exact و dutch و وضعیت پلتفرم‌ها را دارد. حالت‌های llm و sport، تحلیل، پول هوشمند، معاملات و رتبه‌بندی معامله‌گران در Pro و Max هستند.