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 چه شکلی دارند.
| Polymarket | Kalshi | |
|---|---|---|
| گروه بازار | رویداد با یک یا چند بازار | سری (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 هستند.
چه زمانی کلید لازم است
| چه چیزی | Polymarket | Kalshi |
|---|---|---|
| بازارها، قیمتها، دفترها (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 در Polymarket | 500 با 0.40 و 500 با 0.41 | 200 + 205 = 405 دلار |
| NO در Kalshi | 600 با 0.55 و 400 با 0.56 | 330 + 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 |
dutch | YES روی همه نتیجههای یک رویداد در یک پلتفرم | 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/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 میآید، پس صرفهجویی اینجا در فاصله 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 هستند.