Genesis Arbitrage

Genesis Arbitrage · · 15 dk okuma

Polymarket API ve Kalshi API: fiyatlar, emir defterleri ve aralarındaki arbitraj

Kısaca

  • Polymarket ve Kalshi, piyasaları, fiyatları ve emir defterlerini resmî REST API'leriyle anahtarsız sunar. Emir vermek için anahtar ve imzalı istek gerekir; Kalshi'de WebSocket bağlantısı açmak için de anahtar şarttır.
  • Bir kontrat fiyatı doların bir kesridir: 0,42, 42¢ demektir ve piyasanın gözünde yaklaşık %42 ihtimale işaret eder. Belirli bir büyüklüğün ne kadara mal olacağını yalnızca emir defteri gösterir.
  • Platformlar arası arbitraj; olayları eşleştirmek, sonuçlanma kurallarını ve tarihlerini kontrol etmek, emir defterlerinde ilerlemek ve komisyonları düşmek demektir. Genesis API'deki /predictions/arbitrage endpoint'i tüm bunların hesaplandığı paketleri döndürür; işlemleri kendiniz açarsınız.

Polymarket API ve Kalshi API, iki tahmin piyasası platformunun resmî programlama arayüzleridir: bir program bunlar aracılığıyla piyasaları, YES ve NO kontrat fiyatlarını ve emir defterlerini okur; anahtar ve imzalı istekle de emir verir. İki platformda da piyasa verisi anahtarsız okunabilir. İkisi arasındaki arbitraj için fiyatlar yetmez: olayların eşleştirilmesi ve kârın komisyonlarla birlikte emir defterleri üzerinden hesaplanması gerekir. Hazır paketler Genesis API'deki /predictions/arbitrage endpoint'inden gelir.

Tahmin piyasası verisi nasıl yapılandırılır

Tahmin piyasasında bir olayın sonucuna dair kontratlar işlem görür. Her piyasa evet-hayır sorusudur: olay gerçekleşirse YES kontratı 1 $ öder, gerçekleşmezse NO kontratı 1 $ öder. Platformların piyasaları nasıl sonuçlandırdığı ve fiyatların neden birbirinden ayrıştığı Tahmin piyasaları nedir: Polymarket ve Kalshi nasıl çalışır makalesinde ve Tahmin piyasaları nedir dersinde anlatılıyor. Burada aynı nesnelerin API'lerde nasıl göründüğüne bakıyoruz.

PolymarketKalshi
Piyasa grubuBir veya daha fazla piyasası olan olayOlayları içeren seri
PiyasaYes ve No sonuçlu ikili koşulTicker'lı ikili piyasa
API'de sonuçYes ve No'nun her birinin token ID'si varTek piyasanın YES ve NO tarafları
Fiyat0,00 $ ile 1,00 $ arasıDolar dizesi, ör. "0.4200"
Emir defteriHer sonuç için bid ve askYalnızca YES bid'leri ve NO bid'leri

Fiyat doların bir kesridir: 0,42, sonucu gerçekleşirse 1 $ ödeyen bir kontrat için 42¢ demektir. Fiyatın piyasanın olasılık tahmini gibi okunmasının nedeni budur; burada yaklaşık %42. Polymarket sitesi, en iyi bid ile ask arasındaki orta noktayı, spread 0,10 $'dan genişse son işlem fiyatını gösterir (Polymarket dokümanları). Bir işlemin fiyatını belirlemek için emir defteri kullanılır.

Emir defteri: bid'ler, ask'ler ve yansıtılmış fiyatlar

Emir defteri, alış emirlerinin (bid) ve satış emirlerinin (ask) fiyat ve büyüklükleriyle listesidir. Polymarket'te her sonucun kendi defteri vardır ve token_id ile istenir. Kalshi iki taraf için de yalnızca bid döndürür: X fiyatlı bir YES bid'i, 1,00 $ − X fiyatlı bir NO ask'ine eşittir (Kalshi dokümanları).

Açıklayıcı bir örnek: Kalshi'de en iyi NO bid'i 0,58. Yani YES, 1 − 0,58 = 0,42'den, yani 42¢'ten satışta.

Resmî Polymarket ve Kalshi API'leri

Polymarket

Polymarket verisi üç REST API ve WebSocket akışlarından gelir (API genel bakış). CLOB fiyatları ve emir defterleri dahil piyasa verisi için anahtar gerekmez.

APINe verir
Gamma APIOlaylar ve piyasalar: meta veriler, tarihler, sonuç ID'leri
CLOB APIFiyatlar ve emir defterleri; anahtarlarla emirler
Data APICüzdan pozisyonları ve hareketleri, fiyat geçmişi
WebSocketDefterler ve fiyatlar için market kanalı; hesap emirleri ve işlemleri için user kanalı

Emirler iki adımlı CLOB kimlik doğrulaması gerektirir: bir cüzdan imzası (L1) CLOB kimlik bilgilerini (L2) üretir, bunlar da işlem isteklerini imzalar. Defter için sonuç ID'si Gamma API'den gelir: v1 piyasalarında clobTokenIds JSON dizesinde, v2 piyasalarında positionIds içinde; 0 indeksi YES, 1 indeksi NO'dur (piyasa alanları). Ham istekler yerine resmî Python SDK'sını, yani polymarket-client paketini kullanabilirsiniz.

Kalshi

Kalshi, tahmin piyasaları için bir REST API (Trade API v2), WebSocket ve FIX sunar. Önerilen REST ana makinesi external-api.kalshi.com'dur; eski api.elections.kalshi.com hâlâ çalışır, test için ayrı bir demo ortamı vardır (API ortamları). Seriler, olaylar, piyasalar, emir defterleri ve işlemler herkese açıktır.

İşlem isteği özel anahtarla (Ed25519 veya RSA) imzalanır: anahtar kimliği, zaman damgası ve imza KALSHI-ACCESS-KEY, KALSHI-ACCESS-TIMESTAMP ve KALSHI-ACCESS-SIGNATURE başlıklarında gider (Kalshi API anahtarları). Sonuçlanma kuralları dahil piyasa koşulları rules_primary ve rules_secondary içinde metin olarak gelir; en iyi fiyatlar yes_bid_dollars, yes_ask_dollars, no_bid_dollars ve no_ask_dollars alanlarındadır.

Anahtar ne zaman gerekir

NePolymarketKalshi
Piyasalar, fiyatlar, defterler (REST)Anahtar yokAnahtar yok
Defter akışı (WebSocket)Market kanalı, anahtarsızHerkese açık kanallar için bile anahtar gerekir
EmirlerCüzdan imzası ve CLOB kimlik bilgileriÖzel anahtarla imzalı istek

Emir defterini anahtarsız okumak: curl ve 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 ve asks döndürür: seviyeler price ve size alanlarıyla, dize olarak gelir; ayrıca tick_size ve min_order_size vardır. Kalshi, yes_dollars ve no_dollars dizilerini içeren bir orderbook_fp nesnesi döndürür; her seviye, dolar fiyatı ve kontrat sayısından oluşan bir çifttir.

Belirli bir büyüklüğün maliyeti ancak seviyelerde ilerlerken ortaya çıkar. Bu fonksiyon Polymarket ask'lerinde en iyisinden başlayarak ilerler ve en iyi, ortalama ve en kötü fiyatı döndürür:

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))

Buradaki ortalama fiyat, emrin VWAP'ıdır: alım defterin ne kadar derinine inerse en iyi fiyattan o kadar uzaklaşır. Bu fark slipajdır; en iyi fiyatın yakınında bekleyen hacim ise piyasa derinliğidir.

Polymarket–Kalshi arbitrajını zorlaştıran nedir

Platformlar arası tahmin arbitrajı, ikisi birlikte 1 $'dan ucuza geldiğinde bir platformda YES, diğerinde NO almak demektir: iki taraf aynı şekilde sonuçlanırsa, ne olursa olsun bir bacak 1 $ öder. İki fiyatı resmî API'lerle karşılaştırmak kolaydır; çift ancak beş kontrolden sonra işleme dönüşür.

KontrolNeden zor
Olay eşleştirmeSorular farklı ifade edilir, ID'ler ve yapı da farklıdır: Polymarket'te piyasaları olan bir olay, Kalshi'de olayları olan bir seri
Sonuçlanma kurallarıAynı başlığın altında kaynak, ifade ve uç durumlar farklı olabilir
Sonuçlanma tarihleriPiyasalar farklı günlerde kapanır; para, geç olan tarihe kadar kilitli kalır
KomisyonlarFormüller farklıdır: Polymarket'te yalnızca taker'lar öder, Kalshi'de komisyon türü seriye göre belirlenir
Defter derinliğiEn iyi fiyattan yalnızca sınırlı sayıda kontrat satılır

Polymarket'te komisyonu yalnızca taker öder ve tutar, hisse fiyatına ve piyasa kategorisine bağlıdır (Polymarket komisyonları). Kalshi'de komisyon türü ve çarpanı seride, fee_type ve fee_multiplier alanlarında bulunur (Kalshi API'sinde seri). Her iki platformda da önceden bakiyeniz olmalı; erişim ülkenize ve platformun kurallarına bağlıdır.

Çalışılmış örnek: Polymarket'te YES, Kalshi'de NO

Açıklayıcı bir örnek: "X olayı 31 Aralık'a kadar gerçekleşir" piyasası iki platformda da aynı kurallarla listeleniyor ve 46 gün sonra sonuçlanıyor. Her iki taraftan 1.000'er hisse istiyorsunuz.

BacakDefter seviyeleriMaliyet
Polymarket'te YES0,40'tan 500 ve 0,41'den 500200 + 205 = 405 $
Kalshi'de NO0,55'ten 600 ve 0,56'dan 400330 + 224 = 554 $

Kalshi'deki NO ask'leri YES bid'lerinden gelir: 600 kontratlık 0,45'lik bir YES bid'i 0,55'lik bir NO ask'idir, 400'lük 0,44'lük bid ise 0,56'lık bir ask'tir.

En iyi fiyatlardan çift 0,40 + 0,55 = 0,95'e mal olur: hisse başına 5¢ avantaj, yani yatırılan paranın 0,05 / 0,95 = %5,26'sı. Defterlerde ilerleyerek elde edilen ortalama dolum fiyatları 0,405 ve 0,554, toplam 0,959; avantaj 4,1¢'e düşer. Örnekteki komisyonlar Polymarket'te 6 $, Kalshi'de 17 $, toplam 23 $.

Kâr, ödemeden iki bacağın maliyeti ve komisyonların çıkarılmasıyla bulunur; yıllık oran (APR) ise sonuçlanmaya kalan günden çıkar:

Örnekte: 1.000 − 959 − 23 = 18 $ kâr, 18 / 982 × 100 = yatırılan paranın %1,83'ü ve 1,83 × 365 / 46 = yıllık %14,5. En iyi fiyatlardaki %5,26'nın yaklaşık üçte biri defterlerden ve komisyonlardan sağ çıkar.

İki platform da aynı şekilde sonuçlanırsa, ne olursa olsun bir bacak 1.000 $ öder: 982 $ girer, 18 $ daha geri gelir. Kurallar ayrışır ve iki bacak da kaybederse zarar 982 $'ın tamamıdır.

Genesis API'de tahmin arbitrajı

/predictions/arbitrage endpoint'i, bu işin zaten yapılmış olduğu paketleri döndürür. Polymarket, Kalshi, Limitless, Predict.fun ve Opinion piyasaları eşleştirilir, her bacak komisyonlarla birlikte defterinde yürütülür; kâr ($ ve %), APR ve sonuçlanmaya kalan gün hesaplanır. Bu, Tahmin arbitrajı sayfasının verisidir, JSON olarak.

modeNe elde edersinizAPI planları
exactİki platformda tam eşleşen olaylar, varsayılanStart, Pro, Max
dutchBir platformda tek olayın her sonucuna YESStart, Pro, Max
llmYapay zekâ ile doğrulanmış olay çiftleriPro, Max
sport13 platformda surebet'ler, yalnızca maç öncesiPro, Max

Yukarıdaki örnekteki paket, bir yanıtta alanlar kısaltılmış olarak şöyle görünürdü:

{
  "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
    }
  ]
}

Bir bacakta side neyin alınacağını söyler: yes, no veya bir bahis şirketi bahsi olan bet. price_best, price_avg ve price_worst, defterde ilerlerken en iyi, ortalama ve en kötü fiyatlardır; cost_usd ve fee_usd bacağın maliyeti ve komisyonudur; url piyasaya götürür. Sonuçlanmaya bir günden az kaldıysa apr_pct null olur.

risks içindeki kodlar, matematiğin kontrol edemediği şeyleri işaretler: rules_differ, platformların sonuçlanma kurallarının farklı olabileceği, end_mismatch ise sonuçlanma tarihlerinin farklı olduğu anlamına gelir. sport modunda bahis şirketi bacağı olan bir paketin profit_usd değeri null'dır, çünkü bahis limiti bilinmez. Surebet'ler bahis oranları API'leri makalesinde anlatılıyor.

Paketleri min_profit_pct, min_profit_usd, min_apr, max_days, platform ve category ile filtreleyin. Tüm filtreler ve alanlar Genesis API'de tahmin piyasaları ve surebet'ler rehberindedir. Kod yazmadan aynı paketler servis sayfasında görülür; sütunları ve etiketleri Tahmin arbitrajı rehberinde açıklanıyor.

Platform durumu, analitik ve işlemler

EndpointNe döndürürAPI planları
/predictions/platformsPlatformun akış modu (ws, rest, down), son fiyatların ve tam taramanın zamanı, piyasa sayısıStart, Pro, Max
/predictions/analyticsAçık pozisyon ve hacim, 1 saatlik ve 24 saatlik fiyat hareketleri, para akışlarıPro, Max
/predictions/smart-money24 saatte büyük işlemler ve whale'ler, insider kalıpları, pozisyon yoğunlaşmasıPro, Max
/predictions/tradesPolymarket işlem akışı: canlıda 1.000 $'dan, akıllı cüzdan işlemleri 100 $'dan, bugün ve 7g için taker'lar 5.000 $'danPro, Max
/predictions/traders30 gün, 7 gün veya tüm zamanda PnL'ye göre en iyi 300 Polymarket trader'ıPro, Max

Paketlerle birlikte /predictions/platforms endpoint'ini de isteyin: bir platformun akışı down ise paketlerdeki fiyatları eski olabilir. Akıştaki her işlem cüzdan etiketlerini (tags), insider bayrağını, taker veya maker rolünü ve sonucun güncel bid_now ile ask_now değerlerini taşır. insider etiketi bir cüzdanın nasıl davrandığını tarif eder, hiçbir şeyi kanıtlamaz.

Trial'da bu endpoint'ler 403 plan_restricted döndürür. Start ayda 50 $'dır ve veriyi 30 sn'de bir yeniler, Pro 100 $ ve 10 sn, Max 200 $ ve 5 sn. Planları Genesis API fiyatlarında karşılaştırın; sitedeki aynı ekranlar Analitik ve Smart Money sayfalarıdır.

Python: min_profit_pct ve max_days ile exact paketler

Betik, her meta.freshness_sec saniyede bir, en az %1 kâr getiren ve 60 gün içinde sonuçlanan exact paketleri çeker. Bir platformu down olan paketleri atlar, kalanları defterde ilerleme fiyatlarıyla yazdırır. Anahtar, GENESIS_API_KEY ortam değişkeninden gelir; nasıl alınacağı hızlı başlangıçta anlatılıyor.

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:  # dönem kotası doldu
                raise SystemExit(f"Wait {wait} s: quota exhausted")
            time.sleep(wait)
            continue
        r.raise_for_status()  # 403: endpoint veya mod planınızda yok
        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  # bu platformun fiyatları eski olabilir
        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"])

Her döngü iki çağrı yapar. Start'ta bu, günde 2 × 86.400 / 30 = 5.760 çağrı ve 30 günde 5.760 × 30 = 172.800 çağrı eder; kota ise 2 milyon. Filtrelenmiş yanıt ETag olmadan gelir, dolayısıyla buradaki tasarruf polling aralığındadır: meta.freshness_sec değerinden sık sorgulamak yeni veri getirmez. Daha fazlası Genesis API limitleri ve yanıtlar ve hatalar rehberlerinde.

Sorular ve cevaplar

Polymarket'in resmî API'si var mı?

Evet. Gamma API olayları ve piyasaları, CLOB API fiyatları, emir defterlerini ve emirleri, Data API pozisyonları, hareketleri ve fiyat geçmişini sunar; defter güncellemeleri WebSocket üzerinden akar. Piyasa verisi için anahtar gerekmez; emirler için cüzdan imzası ve CLOB kimlik bilgileri gerekir. Bkz. Polymarket dokümanları.

Kalshi piyasalarını okumak için anahtar gerekir mi?

REST için gerekmez: seriler, olaylar, piyasalar, emir defterleri ve işlemler herkese açıktır (Kalshi hızlı başlangıç). Emirler için ve WebSocket'e bağlanmak için anahtar gerekir; yalnızca herkese açık kanalları istiyor olsanız bile.

Genesis API üzerinden işlem yapabilir miyim?

Hayır. Genesis API yalnızca veri okur ve emir vermez. Bir paketi platformlarda legs[].url bağlantılarıyla kendiniz açarsınız. Resmî Polymarket ve Kalshi API'leri üzerinden otomatik işlem Genesis API'nin dışındadır ve sorumluluğu size aittir.

Veriler ne sıklıkla güncellenir?

Genesis API her meta.freshness_sec saniyede yeni bir anlık görüntü sunar: Start'ta 30 sn, Pro'da 10 sn ve Max'te 5 sn. Platformların kendi fiyatlarının ne kadar taze olduğunu /predictions/platforms içindeki quotes_at ve full_scan_at gösterir.

Polymarket ve Kalshi arbitrajı için hangi Genesis API planı gerekir?

Start: exact ve dutch modlarını ve platform durumunu içerir. llm ve sport modları, analitik, smart money, işlemler ve trader sıralaması Pro ve Max'tedir.