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/arbitrageendpoint'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.
| Polymarket | Kalshi | |
|---|---|---|
| Piyasa grubu | Bir veya daha fazla piyasası olan olay | Olayları içeren seri |
| Piyasa | Yes ve No sonuçlu ikili koşul | Ticker'lı ikili piyasa |
| API'de sonuç | Yes ve No'nun her birinin token ID'si var | Tek piyasanın YES ve NO tarafları |
| Fiyat | 0,00 $ ile 1,00 $ arası | Dolar dizesi, ör. "0.4200" |
| Emir defteri | Her sonuç için bid ve ask | Yalnı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.
| API | Ne verir |
|---|---|
| Gamma API | Olaylar ve piyasalar: meta veriler, tarihler, sonuç ID'leri |
| CLOB API | Fiyatlar ve emir defterleri; anahtarlarla emirler |
| Data API | Cüzdan pozisyonları ve hareketleri, fiyat geçmişi |
| WebSocket | Defterler 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
| Ne | Polymarket | Kalshi |
|---|---|---|
| Piyasalar, fiyatlar, defterler (REST) | Anahtar yok | Anahtar yok |
| Defter akışı (WebSocket) | Market kanalı, anahtarsız | Herkese açık kanallar için bile anahtar gerekir |
| Emirler | Cü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.
| Kontrol | Neden zor |
|---|---|
| Olay eşleştirme | Sorular 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 tarihleri | Piyasalar farklı günlerde kapanır; para, geç olan tarihe kadar kilitli kalır |
| Komisyonlar | Formüller farklıdır: Polymarket'te yalnızca taker'lar öder, Kalshi'de komisyon türü seriye göre belirlenir |
| Defter derinliği | En 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.
| Bacak | Defter seviyeleri | Maliyet |
|---|---|---|
| Polymarket'te YES | 0,40'tan 500 ve 0,41'den 500 | 200 + 205 = 405 $ |
| Kalshi'de NO | 0,55'ten 600 ve 0,56'dan 400 | 330 + 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.
mode | Ne elde edersiniz | API planları |
|---|---|---|
exact | İki platformda tam eşleşen olaylar, varsayılan | Start, Pro, Max |
dutch | Bir platformda tek olayın her sonucuna YES | Start, Pro, Max |
llm | Yapay zekâ ile doğrulanmış olay çiftleri | Pro, Max |
sport | 13 platformda surebet'ler, yalnızca maç öncesi | Pro, 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
| Endpoint | Ne döndürür | API planları |
|---|---|---|
/predictions/platforms | Platformun akış modu (ws, rest, down), son fiyatların ve tam taramanın zamanı, piyasa sayısı | Start, Pro, Max |
/predictions/analytics | Açık pozisyon ve hacim, 1 saatlik ve 24 saatlik fiyat hareketleri, para akışları | Pro, Max |
/predictions/smart-money | 24 saatte büyük işlemler ve whale'ler, insider kalıpları, pozisyon yoğunlaşması | Pro, Max |
/predictions/trades | Polymarket 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 $'dan | Pro, Max |
/predictions/traders | 30 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.