Genesis Arbitrage

Genesis Arbitrage · · 14 मिनट में पढ़ें

Polymarket API और Kalshi API: भाव, order book और दोनों के बीच आर्बिट्राज

संक्षेप में

  • Polymarket और Kalshi बाज़ार, भाव और order book आधिकारिक REST API से बिना key के देते हैं। ऑर्डर लगाने के लिए key और साइन की हुई रिक्वेस्ट चाहिए, और Kalshi पर WebSocket कनेक्शन खोलने के लिए भी।
  • कॉन्ट्रैक्ट का भाव एक डॉलर का हिस्सा है: 0.42 का मतलब 42¢ और बाज़ार के अनुमान में लगभग 42% संभावना। किसी साइज़ की असली कीमत सिर्फ़ order book दिखाती है।
  • प्लेटफ़ॉर्म के बीच आर्बिट्राज में इवेंट मिलाने पड़ते हैं, resolution के नियम और तारीखें जाँचनी पड़ती हैं, order book में चलाकर देखना पड़ता है और फ़ीस घटानी पड़ती है। Genesis API का /predictions/arbitrage endpoint यह सब गिना हुआ बंडल लौटाता है; ट्रेड आप खुद लगाते हैं।

Polymarket API और Kalshi API दो prediction market प्लेटफ़ॉर्म के आधिकारिक प्रोग्रामिंग इंटरफ़ेस हैं: इनसे प्रोग्राम बाज़ार, YES और NO कॉन्ट्रैक्ट के भाव और order book पढ़ता है, और key व साइन की हुई रिक्वेस्ट से ऑर्डर लगाता है। दोनों प्लेटफ़ॉर्म पर market data बिना key के पढ़ा जा सकता है। दोनों के बीच आर्बिट्राज के लिए भाव काफ़ी नहीं हैं: इवेंट मिलाने होते हैं और मुनाफ़ा order book से फ़ीस समेत निकालना होता है। तैयार बंडल Genesis API के /predictions/arbitrage endpoint से आते हैं।

Prediction market का डेटा कैसे बना होता है

Prediction market किसी इवेंट के नतीजे पर कॉन्ट्रैक्ट का ट्रेड करता है। हर बाज़ार हाँ या ना वाला सवाल है: YES कॉन्ट्रैक्ट इवेंट होने पर $1 देता है, और NO कॉन्ट्रैक्ट न होने पर। प्लेटफ़ॉर्म बाज़ार कैसे resolve करते हैं और उनके भाव अलग क्यों हो जाते हैं, यह लेख Prediction market क्या हैं: Polymarket और Kalshi कैसे काम करते हैं और पाठ Prediction market क्या हैं में है। यहाँ देखते हैं कि यही चीज़ें API में कैसी दिखती हैं।

PolymarketKalshi
बाज़ारों का समूहएक या अधिक बाज़ार वाला इवेंटइवेंट समेटने वाली सीरीज़ (series)
बाज़ारYes और No नतीजों वाली बाइनरी शर्तticker वाला बाइनरी बाज़ार
API में नतीजाYes और No हर एक का token IDएक बाज़ार के YES और NO पक्ष
भाव$0.00 से $1.00डॉलर की स्ट्रिंग, जैसे "0.4200"
Order bookहर नतीजे के लिए bids और asksसिर्फ़ YES और NO के bids

भाव एक डॉलर का हिस्सा है: 0.42 का मतलब उस कॉन्ट्रैक्ट के 42¢, जो नतीजा सही होने पर $1 देता है। इसीलिए भाव को बाज़ार की संभावना का अनुमान माना जाता है, यहाँ लगभग 42%। Polymarket साइट सबसे अच्छे bid और ask का मध्य दिखाती है, या आख़िरी ट्रेड का भाव, जब स्प्रेड $0.10 से ज़्यादा हो (Polymarket docs)। ट्रेड की कीमत लगाने के लिए आप order book इस्तेमाल करते हैं।

Order book: bids, asks और आईने वाले भाव

Order book खरीद ऑर्डर (bids) और बिक्री ऑर्डर (asks) की सूची है, उनके भाव और साइज़ के साथ। Polymarket पर हर नतीजे की अपनी book है, जो token_id से माँगी जाती है। Kalshi दोनों पक्षों के सिर्फ़ bids लौटाता है: भाव X पर YES bid बराबर है $1.00 − X पर NO ask के (Kalshi docs)।

एक उदाहरण: Kalshi पर NO का सबसे अच्छा bid 0.58 है। तो YES 1 − 0.58 = 0.42 पर उपलब्ध है, यानी 42¢।

आधिकारिक Polymarket और Kalshi API

Polymarket

Polymarket का डेटा तीन REST API और WebSocket स्ट्रीम से आता है (API का परिचय)। Market data, जिसमें CLOB के भाव और order book शामिल हैं, के लिए key नहीं चाहिए।

APIक्या देता है
Gamma APIइवेंट और बाज़ार: मेटाडेटा, तारीखें, नतीजों के ID
CLOB APIभाव और order book; keys के साथ ऑर्डर
Data APIवॉलेट की पोज़िशन और गतिविधि, भाव का इतिहास
WebSocketbook और भाव के लिए market चैनल; खाते के ऑर्डर और ट्रेड के लिए user चैनल

ऑर्डर के लिए दो चरणों वाला CLOB authentication है: वॉलेट का साइन (L1) CLOB credentials (L2) जारी करता है, जो ट्रेडिंग रिक्वेस्ट साइन करते हैं। book के लिए नतीजे का ID Gamma API से मिलता है: v1 बाज़ार में वह JSON स्ट्रिंग clobTokenIds में होता है, v2 बाज़ार में positionIds में; इंडेक्स 0 YES है और 1 NO (बाज़ार के फ़ील्ड)। कच्ची रिक्वेस्ट की जगह आप आधिकारिक Python SDK, यानी polymarket-client पैकेज, इस्तेमाल कर सकते हैं।

Kalshi

Prediction market के लिए Kalshi REST API (Trade API v2), WebSocket और FIX देता है। REST का सुझाया गया होस्ट external-api.kalshi.com है; पुराना api.elections.kalshi.com अब भी चलता है, और टेस्टिंग के लिए अलग demo environment है (API environments)। सीरीज़, इवेंट, बाज़ार, order book और ट्रेड सार्वजनिक हैं।

ट्रेडिंग रिक्वेस्ट प्राइवेट key (Ed25519 या RSA) से साइन होती है: key ID, टाइमस्टैम्प और सिग्नेचर KALSHI-ACCESS-KEY, KALSHI-ACCESS-TIMESTAMP और KALSHI-ACCESS-SIGNATURE हेडर में जाते हैं (Kalshi API keys)। बाज़ार की शर्तें, resolution के नियमों समेत, टेक्स्ट के रूप में rules_primary और rules_secondary में आती हैं; सबसे अच्छे भाव yes_bid_dollars, yes_ask_dollars, no_bid_dollars और no_ask_dollars में हैं।

Key कब चाहिए

क्याPolymarketKalshi
बाज़ार, भाव, book (REST)key नहींkey नहीं
Book स्ट्रीम (WebSocket)market चैनल, key नहींkey ज़रूरी, सार्वजनिक चैनल के लिए भी
ऑर्डरवॉलेट का साइन और CLOB credentialsप्राइवेट key से साइन की हुई रिक्वेस्ट

बिना key के order book पढ़ना: 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 के asks पर सबसे अच्छे से शुरू करके चलता है और सबसे अच्छा, औसत और सबसे ख़राब भाव लौटाता है:

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 है: खरीद book में जितनी गहराई तक जाती है, सबसे अच्छे भाव से उतनी दूर होती है। यह अंतर स्लिपेज है, और सबसे अच्छे भाव के पास पड़ी मात्रा मार्केट डेप्थ।

Polymarket–Kalshi आर्बिट्राज मुश्किल क्यों है

प्लेटफ़ॉर्म के बीच prediction आर्बिट्राज का मतलब है एक प्लेटफ़ॉर्म पर YES और दूसरे पर NO खरीदना, जब दोनों मिलकर $1 से सस्ते हों: अगर दोनों एक ही तरह resolve हों, तो कुछ भी हो एक लेग $1 देता है। आधिकारिक API से दो भावों की तुलना आसान है; जोड़ी ट्रेड तभी बनती है, जब पाँच जाँचें पूरी हों।

जाँचमुश्किल क्यों है
इवेंट मिलानासवाल अलग शब्दों में लिखे जाते हैं, ID और ढाँचा भी अलग: Polymarket पर बाज़ारों वाला इवेंट, Kalshi पर इवेंट वाली सीरीज़
Resolution के नियमएक ही शीर्षक के नीचे स्रोत, शब्दावली और किनारे के मामले अलग हो सकते हैं
Resolution की तारीखेंबाज़ार अलग दिनों पर बंद होते हैं; पैसा बाद वाली तारीख़ तक फँसा रहता है
फ़ीसफ़ॉर्मूले अलग हैं: Polymarket पर सिर्फ़ taker देते हैं, Kalshi पर फ़ीस का प्रकार सीरीज़ के हिसाब से तय होता है
Book की गहराईसबसे अच्छे भाव पर सीमित संख्या में ही कॉन्ट्रैक्ट बिकते हैं

Polymarket पर फ़ीस सिर्फ़ taker देता है, और रकम शेयर के भाव और बाज़ार की श्रेणी पर निर्भर है (Polymarket की फ़ीस)। Kalshi पर फ़ीस का प्रकार और गुणक सीरीज़ में रहते हैं, fee_type और fee_multiplier फ़ील्ड में (Kalshi API में सीरीज़)। दोनों प्लेटफ़ॉर्म पर पहले से फ़ंड चाहिए, और हर एक तक पहुँच आपके देश और प्लेटफ़ॉर्म के नियमों पर निर्भर है।

गिना हुआ उदाहरण: Polymarket पर YES, Kalshi पर NO

एक उदाहरण: «इवेंट X 31 दिसंबर तक होगा» बाज़ार दोनों प्लेटफ़ॉर्म पर एक जैसे नियमों के साथ लिस्ट है और 46 दिन में resolve होता है। आपको हर पक्ष के 1,000 शेयर चाहिए।

लेगBook के लेवललागत
Polymarket पर YES0.40 पर 500 और 0.41 पर 500200 + 205 = $405
Kalshi पर NO0.55 पर 600 और 0.56 पर 400330 + 224 = $554

Kalshi पर NO के asks YES के bids से बनते हैं: 600 कॉन्ट्रैक्ट के लिए 0.45 का YES bid 0.55 पर NO ask है, और 400 के लिए 0.44 का bid 0.56 पर ask।

सबसे अच्छे भावों पर जोड़ी की लागत 0.40 + 0.55 = 0.95 है: प्रति शेयर 5¢ का फ़ायदा, यानी लगाए पैसे पर 0.05 / 0.95 = 5.26%। book से चलने पर औसत भराव भाव 0.405 और 0.554 हैं, कुल 0.959, इसलिए फ़ायदा घटकर 4.1¢ रह जाता है। उदाहरण में फ़ीस Polymarket पर $6 और Kalshi पर $17 है, कुल $23।

मुनाफ़ा भुगतान में से दोनों लेग की लागत और फ़ीस घटाने पर मिलता है, और सालाना दर (APR) resolution तक के दिनों से निकलती है:

उदाहरण में: 1,000 − 959 − 23 = $18 मुनाफ़ा, 18 / 982 × 100 = लगाए पैसे पर 1.83%, और 1.83 × 365 / 46 = सालाना 14.5%। सबसे अच्छे भावों वाले 5.26% में से book और फ़ीस के बाद लगभग एक तिहाई बचता है।

अगर दोनों प्लेटफ़ॉर्म एक ही तरह resolve करें, तो कुछ भी हो एक लेग $1,000 देता है: $982 लगते हैं और $18 ज़्यादा लौटते हैं। अगर नियम अलग निकलें और दोनों लेग हार जाएँ, तो नुकसान पूरे $982 का है।

Genesis API में prediction आर्बिट्राज

/predictions/arbitrage endpoint ऐसे बंडल लौटाता है, जिनमें यह काम हो चुका है। Polymarket, Kalshi, Limitless, Predict.fun और Opinion के बाज़ार मिलाए जाते हैं, हर लेग फ़ीस समेत अपनी book में चलाया जाता है, और $ व % में मुनाफ़ा, APR और resolution तक के दिन गिने जाते हैं। यह Prediction आर्बिट्राज पेज का डेटा है, JSON में।

modeक्या मिलता हैAPI प्लान
exactदो प्लेटफ़ॉर्म पर ठीक मिलाए गए इवेंट, डिफ़ॉल्टStart, Pro, Max
dutchएक प्लेटफ़ॉर्म पर एक इवेंट के हर नतीजे पर YESStart, Pro, Max
llmAI से सत्यापित इवेंट जोड़ेPro, Max
sport13 प्लेटफ़ॉर्म पर surebet, सिर्फ़ मैच से पहले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 book में चलने पर सबसे अच्छा, औसत और सबसे ख़राब भाव हैं; cost_usd और fee_usd लेग की लागत और फ़ीस हैं; url बाज़ार का लिंक है। जब resolution में एक दिन से कम बचा हो, तो apr_pct null होता है।

risks के कोड वह बताते हैं, जो गणित जाँच नहीं सकता: rules_differ का मतलब है कि प्लेटफ़ॉर्म के resolution नियम अलग हो सकते हैं, end_mismatch का मतलब है कि उनकी resolution तारीखें अलग हैं। sport मोड में बुकमेकर लेग वाले बंडल में profit_usd null होता है, क्योंकि स्टेक की सीमा अज्ञात है। Surebet पर लेख बुकमेकर odds API में है।

बंडल min_profit_pct, min_profit_usd, min_apr, max_days, platform और category से फ़िल्टर करें। सारे फ़िल्टर और फ़ील्ड गाइड Genesis API में prediction market और surebet में हैं। बिना कोड के वही बंडल सर्विस पेज पर हैं; उसके कॉलम और टैग गाइड Prediction आर्बिट्राज में समझाए गए हैं।

प्लेटफ़ॉर्म स्थिति, एनालिटिक्स और ट्रेड

Endpointक्या लौटाता हैAPI प्लान
/predictions/platformsप्लेटफ़ॉर्म की फ़ीड का मोड (ws, rest, down), ताज़ा भावों और पूरे स्कैन का समय, बाज़ारों की संख्याStart, Pro, Max
/predictions/analyticsOpen interest और वॉल्यूम, 1 घंटे और 24 घंटे में भाव की चाल, पैसे का प्रवाहPro, Max
/predictions/smart-money24 घंटे में बड़े ट्रेड और व्हेल, insider पैटर्न, पोज़िशन का संकेंद्रणPro, Max
/predictions/tradesPolymarket की ट्रेड टेप: लाइव $1,000 से और स्मार्ट वॉलेट के ट्रेड $100 से, आज और 7 दिन के taker $5,000 सेPro, Max
/predictions/traders30 दिन, 7 दिन या पूरे समय के PnL के हिसाब से Polymarket के शीर्ष 300 ट्रेडरPro, Max

बंडल के साथ /predictions/platforms भी माँगें: अगर किसी प्लेटफ़ॉर्म की फ़ीड down है, तो बंडल में उसके भाव पुराने हो सकते हैं। टेप के हर ट्रेड में वॉलेट के लेबल (tags), insider फ़्लैग, taker या maker की भूमिका और नतीजे के मौजूदा bid_now व ask_now होते हैं। insider लेबल वॉलेट का व्यवहार बताता है और कुछ साबित नहीं करता।

Trial पर ये endpoint 403 plan_restricted लौटाते हैं। Start $50 प्रति माह का है और डेटा हर 30 सेकंड में रिफ़्रेश करता है, Pro $100 का और हर 10 सेकंड में, Max $200 का और हर 5 सेकंड में। प्लान Genesis API की कीमतें पर मिलाएँ; साइट पर यही स्क्रीन एनालिटिक्स और स्मार्ट मनी हैं।

Python: min_profit_pct और max_days के साथ exact बंडल

हर meta.freshness_sec सेकंड पर स्क्रिप्ट कम से कम 1% मुनाफ़े वाले exact बंडल लाती है, जो 60 दिन के भीतर resolve होते हैं। जिन बंडल में कोई प्लेटफ़ॉर्म down है, उन्हें छोड़ देती है और बाक़ी को book में चलने वाले भावों के साथ प्रिंट करती है। Key GENESIS_API_KEY environment variable से आती है; उसे पाने का तरीक़ा क्विक स्टार्ट में है।

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 कॉल प्रतिदिन है और 30 दिन में 5,760 × 30 = 172,800, जबकि कोटा 2M है। फ़िल्टर वाला रिस्पॉन्स ETag के बिना आता है, इसलिए यहाँ बचत polling के अंतराल में है: meta.freshness_sec से तेज़ polling नया डेटा नहीं लाती। और जानकारी गाइड Genesis API की सीमाएँ और रिस्पॉन्स और एरर में है।

सवाल और जवाब

क्या Polymarket का आधिकारिक API है?

हाँ। Gamma API इवेंट और बाज़ार देता है, CLOB API भाव, order book और ऑर्डर, Data API पोज़िशन, गतिविधि और भाव का इतिहास, और book के अपडेट WebSocket से स्ट्रीम होते हैं। Market data के लिए key नहीं चाहिए; ऑर्डर के लिए वॉलेट का साइन और CLOB credentials चाहिए। देखें Polymarket docs।

क्या Kalshi के बाज़ार पढ़ने के लिए key चाहिए?

REST के लिए नहीं: सीरीज़, इवेंट, बाज़ार, order book और ट्रेड सार्वजनिक हैं (Kalshi क्विक स्टार्ट)। ऑर्डर के लिए और WebSocket से जुड़ने के लिए key ज़रूरी है, भले ही आपको सिर्फ़ सार्वजनिक चैनल चाहिए हों।

क्या मैं Genesis API से ट्रेड कर सकता हूँ?

नहीं। Genesis API सिर्फ़ डेटा पढ़ता है और कोई ऑर्डर नहीं लगाता। बंडल आप खुद प्लेटफ़ॉर्म पर legs[].url लिंक से खोलते हैं। आधिकारिक Polymarket और Kalshi API से ऑटोमैटिक ट्रेडिंग Genesis API के बाहर है और आपके अपने जोखिम पर।

डेटा कितनी बार अपडेट होता है?

Genesis API हर meta.freshness_sec पर नया स्नैपशॉट देता है: Start पर 30 सेकंड, Pro पर 10 सेकंड और Max पर 5 सेकंड। प्लेटफ़ॉर्म के अपने भाव कितने ताज़ा हैं, यह /predictions/platforms में quotes_at और full_scan_at दिखाते हैं।

Polymarket और Kalshi आर्बिट्राज के लिए कौन-सा Genesis API प्लान चाहिए?

Start: इसमें exact और dutch मोड और प्लेटफ़ॉर्म स्थिति शामिल हैं। llm और sport मोड, एनालिटिक्स, स्मार्ट मनी, ट्रेड और ट्रेडर लीडरबोर्ड Pro और Max में हैं।