API Polymarket dan API Kalshi: harga, order book, dan arbitrase di antara keduanya
Ringkasan
- Polymarket dan Kalshi menyediakan pasar, harga, dan order book lewat REST API resmi tanpa key. Key dan request bertanda tangan dibutuhkan untuk memasang order, dan di Kalshi juga untuk membuka koneksi WebSocket.
- Harga kontrak adalah pecahan dari satu dolar: 0,42 berarti 42¢ dan kira-kira peluang 42% menurut pandangan pasar. Hanya order book yang menunjukkan berapa biaya untuk ukuran tertentu.
- Arbitrase antarplatform berarti mencocokkan event, memeriksa aturan dan tanggal penyelesaian, menelusuri order book, lalu mengurangi fee. Endpoint
/predictions/arbitragedi Genesis API mengembalikan bundle dengan semua perhitungan itu; transaksinya Anda buka sendiri.
API Polymarket dan API Kalshi adalah antarmuka pemrograman resmi dari dua platform pasar prediksi: lewat keduanya program membaca pasar, harga kontrak YES dan NO, serta order book, dan dengan key serta request bertanda tangan program memasang order. Data pasar di kedua platform bisa dibaca tanpa key. Untuk arbitrase di antara keduanya, harga saja tidak cukup: event harus dicocokkan dan profit dihitung lewat order book beserta fee. Bundle siap pakai datang dari endpoint /predictions/arbitrage di Genesis API.
Bagaimana data pasar prediksi disusun
Pasar prediksi memperdagangkan kontrak atas hasil sebuah event. Setiap pasar adalah pertanyaan ya-atau-tidak: kontrak YES membayar $1 jika event terjadi, dan kontrak NO membayar $1 jika tidak terjadi. Cara platform menyelesaikan pasar dan mengapa harganya bisa berbeda dibahas di artikel Pasar prediksi: cara kerja Polymarket dan Kalshi dan pelajaran Apa itu pasar prediksi. Di sini kita lihat bagaimana objek yang sama muncul di API.
| Polymarket | Kalshi | |
|---|---|---|
| Kelompok pasar | Event dengan satu pasar atau lebih | Seri yang berisi event |
| Pasar | Kondisi biner dengan hasil Yes dan No | Pasar biner dengan ticker |
| Hasil di API | Yes dan No masing-masing punya token ID | Sisi YES dan NO dari satu pasar |
| Harga | $0,00 sampai $1,00 | String dolar, mis. "0.4200" |
| Order book | Bid dan ask untuk tiap hasil | Hanya bid YES dan bid NO |
Harga adalah pecahan dari satu dolar: 0,42 berarti 42¢ untuk kontrak yang membayar $1 jika hasilnya terjadi. Karena itu harga terbaca sebagai perkiraan probabilitas oleh pasar, di sini kira-kira 42%. Situs Polymarket menampilkan titik tengah antara bid dan ask terbaik, atau harga transaksi terakhir ketika spread lebih lebar dari $0,10 (dokumentasi Polymarket). Untuk menentukan harga sebuah transaksi, gunakan order book.
Order book: bid, ask, dan harga cermin
Order book adalah daftar order beli (bid) dan order jual (ask) beserta harga dan ukurannya. Di Polymarket setiap hasil punya book sendiri, yang diminta lewat token_id. Kalshi hanya mengembalikan bid untuk kedua sisi: bid YES di harga X sama dengan ask NO di $1,00 − X (dokumentasi Kalshi).
Contoh ilustrasi: bid NO terbaik di Kalshi adalah 0,58. Jadi YES ditawarkan di 1 − 0,58 = 0,42, atau 42¢.
API resmi Polymarket dan Kalshi
Polymarket
Data Polymarket datang dari tiga REST API dan stream WebSocket (ikhtisar API). Data pasar, termasuk harga dan order book CLOB, tidak butuh key.
| API | Yang diberikan |
|---|---|
| Gamma API | Event dan pasar: metadata, tanggal, ID hasil |
| CLOB API | Harga dan order book; dengan key, order |
| Data API | Posisi dan aktivitas wallet, riwayat harga |
| WebSocket | Kanal market untuk book dan harga; kanal user untuk order dan transaksi akun |
Order memakai autentikasi CLOB dua langkah: tanda tangan wallet (L1) menerbitkan kredensial CLOB (L2) yang menandatangani request trading. ID hasil untuk book berasal dari Gamma API: pasar v1 membawanya di string JSON clobTokenIds, pasar v2 di positionIds; indeks 0 adalah YES dan 1 adalah NO (field pasar). Sebagai ganti request mentah, Anda bisa memakai SDK Python resmi, paket polymarket-client.
Kalshi
Untuk pasar prediksi, Kalshi menawarkan REST API (Trade API v2), WebSocket, dan FIX. Host REST yang direkomendasikan adalah external-api.kalshi.com; api.elections.kalshi.com yang lama masih berfungsi, dan ada lingkungan demo terpisah untuk pengujian (lingkungan API). Seri, event, pasar, order book, dan transaksi bersifat publik.
Request trading ditandatangani dengan private key (Ed25519 atau RSA): ID key, timestamp, dan tanda tangan dikirim di header KALSHI-ACCESS-KEY, KALSHI-ACCESS-TIMESTAMP, dan KALSHI-ACCESS-SIGNATURE (key API Kalshi). Ketentuan pasar, termasuk aturan penyelesaian, datang sebagai teks di rules_primary dan rules_secondary; harga terbaik ada di yes_bid_dollars, yes_ask_dollars, no_bid_dollars, dan no_ask_dollars.
Kapan Anda butuh key
| Apa | Polymarket | Kalshi |
|---|---|---|
| Pasar, harga, book (REST) | Tanpa key | Tanpa key |
| Stream book (WebSocket) | Kanal market, tanpa key | Key wajib, bahkan untuk kanal publik |
| Order | Tanda tangan wallet dan kredensial CLOB | Request ditandatangani dengan private key |
Membaca order book tanpa key: curl dan 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 mengembalikan bids dan asks, level dengan price dan size sebagai string, ditambah tick_size dan min_order_size. Kalshi mengembalikan objek orderbook_fp dengan array yes_dollars dan no_dollars, di mana setiap level adalah pasangan harga dolar dan jumlah kontrak.
Biaya untuk ukuran tertentu baru terlihat ketika level-level ditelusuri. Fungsi ini menelusuri ask Polymarket mulai dari yang terbaik dan mengembalikan harga terbaik, rata-rata, dan terburuk:
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))
Harga rata-rata di sini adalah VWAP order: semakin dalam pembelian masuk ke book, semakin jauh harganya dari harga terbaik. Selisih itu adalah slippage, dan volume yang menunggu di dekat harga terbaik adalah market depth.
Apa yang membuat arbitrase Polymarket–Kalshi sulit
Arbitrase prediksi antarplatform berarti membeli YES di satu platform dan NO di platform lain ketika keduanya bersama-sama lebih murah dari $1: jika keduanya diselesaikan dengan hasil yang sama, satu leg membayar $1 apa pun yang terjadi. Membandingkan dua harga lewat API resmi itu mudah; pasangan itu baru menjadi transaksi setelah lima pemeriksaan.
| Pemeriksaan | Mengapa sulit |
|---|---|
| Pencocokan event | Pertanyaan dirumuskan berbeda, dan ID serta strukturnya berbeda: event dengan pasar di Polymarket, seri dengan event di Kalshi |
| Aturan penyelesaian | Sumber, redaksi, dan kasus tepi bisa berbeda di bawah judul yang sama |
| Tanggal penyelesaian | Pasar ditutup di hari yang berbeda; dana terkunci sampai tanggal yang lebih akhir |
| Fee | Rumusnya berbeda: di Polymarket hanya taker yang membayar, di Kalshi jenis fee ditentukan per seri |
| Depth book | Hanya sejumlah terbatas kontrak yang terjual di harga terbaik |
Di Polymarket hanya taker yang membayar fee, dan besarnya bergantung pada harga share dan kategori pasar (fee Polymarket). Di Kalshi jenis fee dan pengalinya ada di seri, pada field fee_type dan fee_multiplier (seri di API Kalshi). Anda perlu punya dana di kedua platform sebelumnya, dan akses ke masing-masing bergantung pada negara Anda dan aturan platform.
Contoh perhitungan: YES di Polymarket, NO di Kalshi
Contoh ilustrasi: pasar "Event X terjadi sebelum 31 Desember" terdaftar di kedua platform dengan aturan identik dan diselesaikan dalam 46 hari. Anda menginginkan masing-masing 1.000 share.
| Leg | Level book | Biaya |
|---|---|---|
| YES di Polymarket | 500 di 0,40 dan 500 di 0,41 | 200 + 205 = $405 |
| NO di Kalshi | 600 di 0,55 dan 400 di 0,56 | 330 + 224 = $554 |
Ask NO di Kalshi berasal dari bid YES: bid YES 0,45 untuk 600 kontrak adalah ask NO di 0,55, dan bid 0,44 untuk 400 adalah ask di 0,56.
Pada harga terbaik, pasangan itu berbiaya 0,40 + 0,55 = 0,95: selisih 5¢ per share, atau 0,05 / 0,95 = 5,26% dari dana yang ditanam. Harga isi rata-rata lewat book adalah 0,405 dan 0,554, totalnya 0,959, sehingga selisih menyusut menjadi 4,1¢. Fee dalam contoh ini $6 di Polymarket dan $17 di Kalshi, total $23.
Profit adalah pembayaran dikurangi biaya kedua leg dan fee, dan tingkat tahunan (APR) mengikuti dari jumlah hari hingga penyelesaian:
Dalam contoh: 1.000 − 959 − 23 = $18 profit, 18 / 982 × 100 = 1,83% dari dana yang ditanam, dan 1,83 × 365 / 46 = 14,5% setahun. Dari 5,26% pada harga terbaik, sekitar sepertiganya bertahan setelah book dan fee.
Jika kedua platform menyelesaikan dengan hasil yang sama, satu leg membayar $1.000 apa pun yang terjadi: $982 masuk dan $18 lagi kembali. Jika aturan berbeda dan kedua leg kalah, kerugiannya adalah seluruh $982.
Arbitrase prediksi di Genesis API
Endpoint /predictions/arbitrage mengembalikan bundle dengan pekerjaan itu sudah selesai. Pasar di Polymarket, Kalshi, Limitless, Predict.fun, dan Opinion dicocokkan, setiap leg ditelusuri lewat book-nya beserta fee, dan profit dalam $ dan %, APR, serta hari hingga penyelesaian dihitung. Ini adalah data halaman Arbitrase prediksi, dalam bentuk JSON.
mode | Yang Anda dapat | Paket API |
|---|---|---|
exact | Event yang cocok persis di dua platform, default | Start, Pro, Max |
dutch | YES pada setiap hasil satu event di satu platform | Start, Pro, Max |
llm | Pasangan event yang diverifikasi AI | Pro, Max |
sport | Surebet di 13 platform, hanya pra-pertandingan | Pro, Max |
Bundle dari contoh di atas akan terlihat seperti ini dalam respons, field dipangkas:
{
"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
}
]
}
Pada sebuah leg, side menyatakan apa yang dibeli: yes, no, atau bet, taruhan di bandar. price_best, price_avg, dan price_worst adalah harga terbaik, rata-rata, dan terburuk saat menelusuri book; cost_usd dan fee_usd adalah biaya dan fee leg; url menautkan ke pasar. apr_pct bernilai null ketika penyelesaian kurang dari sehari lagi.
Kode di risks menandai hal yang tidak bisa diperiksa oleh perhitungan: rules_differ berarti aturan penyelesaian platform mungkin berbeda, end_mismatch berarti tanggal penyelesaiannya berbeda. Dalam mode sport, bundle dengan leg bandar memiliki profit_usd = null, karena batas taruhan tidak diketahui. Surebet dibahas di artikel tentang API odds bandar.
Filter bundle dengan min_profit_pct, min_profit_usd, min_apr, max_days, platform, dan category. Semua filter dan field ada di panduan Pasar prediksi dan surebet di Genesis API. Tanpa kode, bundle yang sama ada di halaman layanan; kolom dan tag-nya dijelaskan di panduan Arbitrase prediksi.
Status platform, analitik, dan transaksi
| Endpoint | Mengembalikan | Paket API |
|---|---|---|
/predictions/platforms | Mode feed platform (ws, rest, down), waktu kuotasi terbaru dan pemindaian penuh, jumlah pasar | Start, Pro, Max |
/predictions/analytics | Open interest dan volume, pergerakan harga 1 jam dan 24 jam, aliran dana | Pro, Max |
/predictions/smart-money | Transaksi besar dan whale selama 24 jam, pola insider, konsentrasi posisi | Pro, Max |
/predictions/trades | Tape transaksi Polymarket: live mulai $1.000 dan transaksi wallet smart mulai $100, hari ini dan 7d taker mulai $5.000 | Pro, Max |
/predictions/traders | 300 trader Polymarket teratas menurut PnL selama 30 hari, 7 hari, atau sepanjang waktu | Pro, Max |
Minta /predictions/platforms bersama bundle: jika feed sebuah platform down, harganya di dalam bundle mungkin sudah basi. Setiap transaksi di tape membawa label wallet (tags), flag insider, peran taker atau maker, dan bid_now serta ask_now hasil saat ini. Label insider menggambarkan bagaimana sebuah wallet berperilaku dan tidak membuktikan apa pun.
Di Trial, endpoint ini mengembalikan 403 plan_restricted. Start berharga $50 sebulan dan memperbarui data tiap 30 dtk, Pro $100 dan 10 dtk, Max $200 dan 5 dtk. Bandingkan paket di harga Genesis API; layar yang sama di situs adalah Analitik dan Smart Money.
Python: bundle exact dengan min_profit_pct dan max_days
Setiap meta.freshness_sec detik, skrip mengambil bundle exact dengan profit minimal 1% yang diselesaikan dalam 60 hari. Skrip melewati bundle dengan platform berstatus down dan mencetak sisanya beserta harga penelusuran book. Key diambil dari variabel lingkungan GENESIS_API_KEY; cara mendapatkannya ada di mulai cepat.
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: # kuota periode habis
raise SystemExit(f"Wait {wait} s: quota exhausted")
time.sleep(wait)
continue
r.raise_for_status() # 403: endpoint atau mode tidak ada di paket Anda
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 # harga platform ini mungkin sudah basi
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"])
Setiap siklus melakukan dua panggilan. Di Start itu 2 × 86.400 / 30 = 5.760 panggilan sehari dan 5.760 × 30 = 172.800 per 30 hari terhadap kuota 2 juta. Respons yang difilter datang tanpa ETag, sehingga penghematan di sini ada pada interval polling: polling lebih cepat dari meta.freshness_sec tidak membawa data baru. Selengkapnya di panduan Batas Genesis API dan respons dan error.
Tanya jawab
Apakah Polymarket punya API resmi?
Ya. Gamma API menyediakan event dan pasar, CLOB API harga, order book, dan order, Data API posisi, aktivitas, dan riwayat harga, dan pembaruan book mengalir lewat WebSocket. Data pasar tidak butuh key; order butuh tanda tangan wallet dan kredensial CLOB. Lihat dokumentasi Polymarket.
Apakah saya butuh key untuk membaca pasar Kalshi?
Tidak untuk REST: seri, event, pasar, order book, dan transaksi bersifat publik (mulai cepat Kalshi). Key wajib untuk order dan untuk terhubung ke WebSocket, bahkan jika Anda hanya ingin kanal publik.
Bisakah saya bertransaksi lewat Genesis API?
Tidak. Genesis API hanya membaca data dan tidak memasang order. Anda membuka bundle sendiri di platform lewat tautan legs[].url. Trading otomatis lewat API resmi Polymarket dan Kalshi berada di luar Genesis API dan menjadi risiko Anda sendiri.
Seberapa sering data diperbarui?
Genesis API menyajikan snapshot baru setiap meta.freshness_sec: 30 dtk di Start, 10 dtk di Pro, dan 5 dtk di Max. Seberapa segar kuotasi milik platform sendiri ditunjukkan oleh quotes_at dan full_scan_at di /predictions/platforms.
Paket Genesis API mana yang saya butuhkan untuk arbitrase Polymarket dan Kalshi?
Start: sudah mencakup mode exact dan dutch serta status platform. Mode llm dan sport, analitik, smart money, transaksi, dan papan peringkat trader ada di Pro dan Max.