Blog

Kalshi API Kullanımı: Tahmin Piyasaları Rehberi

Ashley Goolam

Ashley Goolam

6 February 2026

Kalshi API Kullanımı: Tahmin Piyasaları Rehberi

CFTC tarafından düzenlenen bir borsada, tahmin piyasalarını programlı olarak işlem yapmak için kurumsal düzeyde API'leri kullanabildiğinizi hayal edin. ABD'deki federal olarak yetkilendirilmiş ilk tahmin piyasasına REST, WebSocket ve FIX 4.4 arayüzleri sunan Kalshi tam da bunu yapıyor. Sadece 2025 yılının ilk yarısında şirket 200 milyon dolardan fazla gelir elde etti.

Tahmin piyasaları popülaritesinde patlama yaşadı, ancak geliştiriciler düzenlenmiş altyapı ile kripto-yerel esneklik arasında bir seçimle karşı karşıya. Düzenlenmemiş platformlar yasal gri alanlarda faaliyet gösterir, blockchain cüzdanları gerektirir ve kullanıcıları akıllı sözleşme risklerine maruz bırakır. Kalshi, CFTC gözetimi altında Belirlenmiş Sözleşme Piyasası olarak faaliyet göstererek, fiat tabanlı ödeme, geleneksel API kalıpları ve ABD finansal düzenlemelerine uygunluk sunarak bu sürtünme noktalarını ortadan kaldırır. Kurumların gerçekten kullanabileceği ticaret uygulamaları oluşturursunuz.

İçindekiler:

💡
Tahmin piyasası entegrasyonları oluşturmak, REST, WebSocket ve FIX protokollerinde güvenilir API testleri gerektirir. Apidog, finansal ticaret uygulamaları için özel olarak tasarlanmış görsel API testleri, otomatik dokümantasyon üretimi ve ekip işbirliği özellikleri sunar. Kalshi API geliştirmenizi kolaylaştırmak için Apidog'u ücretsiz deneyin—kredi kartı gerekmez.
button

Kalshi'nin Mimarisini Anlamak

Kalshi, kendi kendini onaylamış etkinlik sözleşmelerine sahip merkezi bir borsa olarak faaliyet göstermektedir. Bu mimariyi anlamak, sağlam entegrasyonlar tasarlamanıza yardımcı olur.

Belirlenmiş Sözleşme Piyasası Durumu

Kalshi, ABD'nin 50 eyaletinde etkinlik sözleşmeleri sunmasını sağlayan bir CFTC lisansına sahiptir. Eyalet tarafından düzenlenen spor bahislerinin aksine, Kalshi federal yargı yetkisi altında faaliyet göstererek, parçalanmış eyalet kumar yasalarının karmaşasını aşar. Bu durum sıkı uyumluluk gerektirir: her piyasa CFTC incelemesinden geçer, ödemeler yayınlanmış kural kitaplarını takip eder ve borsa manipülasyonu tespit etmek için gözetim sistemleri sürdürür.

Merkezi Limit Emir Defteri (CLOB)

Kalshi, emirleri geleneksel bir CLOB aracılığıyla eşleştirir—alış ve satış emirleri belirli fiyatlarda görünür derinlikle buluşur. Bu, merkezi olmayan borsalar tarafından kullanılan otomatik piyasa yapıcılarından (AMM'ler) farklıdır. CLOB, fiyat şeffaflığı sağlar, limit emirlere izin verir ve piyasa yapım stratejilerini mümkün kılar. Piyasa yapıcılar, daha az aktif piyasalarda bile sıkı spreadler sağlamak için günlük yaklaşık 35.000 ABD Doları (yıllık ~12.7 milyon ABD Doları) likidite teşvikleri alır.

Etkinlik Sözleşmeleri Yapısı

Her sözleşme ikili bir sonucu temsil eder: Evet 1.00 ABD Doları, Hayır 0.00 ABD Doları öder. Fiyatlar 0.01 ABD Doları ile 0.99 ABD Doları arasında dalgalanarak piyasanın ima ettiği olasılıkları yansıtır. 0.63 ABD Doları'ndan işlem gören bir sözleşme, olayın gerçekleşme olasılığının %63 olduğunu ima eder. Ödeme, sonuç doğrulandıktan sonra 1.00 ABD Doları veya 0.00 ABD Doları olarak gerçekleşir.

Sözleşmeler kesin ödeme koşullarını belirtir: olay tanımı, yetkili veri kaynağı ve çözüm metodolojisi. Örneğin, "Ocak ayında TÜFE %3,5'i aşacak mı?" sözleşmesi, kesin Çalışma İstatistikleri Bürosu yayınını ve mevsimsel düzeltmelerin nasıl yorumlanacağını belirtir.

Oracle ve Ödeme

Kalshi, borsa personeli tarafından işletilen merkezi bir oracle kullanır. Sonuçlar, resmi kaynaklara—hükümet raporları, saygın veri sağlayıcıları veya köklü haber kuruluşları—dayalı olarak çözümlenir. Çözümleme genellikle olayın bitiminden sonra birkaç saat içinde tamamlanır. Bu merkezi model, merkeziyetçilik yerine hız ve netliği önceliklendirirken, CFTC gözetimi hesap verebilirliği sağlar.

kalshi

Kimlik Doğrulama ve Kurulum

Kalshi'nin kimlik doğrulaması, hesap panonuzda oluşturulan özel anahtarlar kullanılarak RSA imzalı istekler gerektirir. Bu, API çağrılarının kriptografik doğrulanmasını sağlar.

Ortam Kurulumu

Kalshi iki ortam sunar:

Her zaman önce demoda geliştirme yapın. Ortamlar işlevsel olarak aynıdır, ancak demo piyasaları simüle edilmiş likiditeye sahip olabilir.

API Anahtarları Oluşturma

Kalshi panonuzdaki Ayarlar → API'ye gidin. Yeni bir anahtar çifti oluşturun:

  1. "API Anahtarı Oluştur"a tıklayın
  2. API Anahtar Kimliğini (kalshi_prod_ veya kalshi_demo_ ile başlar) saklayın
  3. Özel anahtarı hemen indirin—Kalshi bir daha asla göstermez
  4. Özel anahtarı dosya izinleriyle güvence altına alın (chmod 600)

Özel anahtar RSA-PSS imzalaması kullanır. Kalshi, otomatik olarak imzalama işlemini gerçekleştiren resmi SDK'lar sağlar veya standart kriptografik kütüphaneleri kullanarak manuel olarak uygulayabilirsiniz.

SDK Kurulumu

Kalshi, Python (senkron ve asenkon) ve TypeScript için resmi SDK'lar sunar:

# Python senkron
pip install kalshi-python-sync

# Python asenkron  
pip install kalshi-python-async

# TypeScript/Node.js
npm install @kalshi/sdk

Go ve diğer diller için topluluk SDK'ları mevcuttur, ancak resmi SDK'lar en güvenilir imzalama uygulamalarını ve tip güvenliğini sağlar.

kalshi sdk

Manuel Kimlik Doğrulama (SDK Olmadan)

Özel imzalama uyguluyorsanız, şu akışı izleyin:

import requests
from cryptography.hazmat.primitives import hashes, serialization
from cryptography.hazmat.primitives.asymmetric import padding
import base64
import json
from datetime import datetime, timezone

class KalshiAuth:
    def __init__(self, api_key_id, private_key_path):
        self.api_key_id = api_key_id
        with open(private_key_path, "rb") as key_file:
            self.private_key = serialization.load_pem_private_key(
                key_file.read(),
                password=None
            )
        self.base_url = "https://api.kalshi.com/v1"
    
    def sign_request(self, method, path, body=None):
        # Zaman damgası oluştur
        timestamp = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S.%fZ")[:-3] + "Z"
        
        # İmzalanacak dizeyi oluştur
        string_to_sign = f"{timestamp}{method}{path}"
        if body:
            string_to_sign += json.dumps(body, separators=(',', ':'))
        
        # RSA-PSS ile imzala
        signature = self.private_key.sign(
            string_to_sign.encode('utf-8'),
            padding.PSS(mgf=padding.MGF1(hashes.SHA256()), salt_length=32),
            hashes.SHA256()
        )
        
        return {
            "KALSHI-ACCESS-KEY": self.api_key_id,
            "KALSHI-ACCESS-TIMESTAMP": timestamp,
            "KALSHI-ACCESS-SIGNATURE": base64.b64encode(signature).decode('utf-8'),
            "Content-Type": "application/json"
        }
    
    def request(self, method, path, body=None):
        url = f"{self.base_url}{path}"
        headers = self.sign_request(method, path, body)
        
        if method == "GET":
            response = requests.get(url, headers=headers)
        elif method == "POST":
            response = requests.post(url, headers=headers, json=body)
        elif method == "DELETE":
            response = requests.delete(url, headers=headers)
        
        return response.json()

# Kullanım
kalshi = KalshiAuth(
    api_key_id="kalshi_prod_abc123",
    private_key_path="~/.kalshi/private_key.pem"
)

# Piyasa verilerini al
markets = kalshi.request("GET", "/markets")
print(markets)

İmzalama dizesi, zaman damgası, HTTP metodu, yol ve JSON gövdesini (varsa) birleştirir. SHA-256 ile RSA-PSS, isteklerin hesabınızdan kaynaklandığına dair kriptografik doğrulama sağlar.

Jeton Tabanlı Oturumlar

İlk kimlik doğrulamasından sonra, sonraki istekler için bir oturum jetonu alın:

# Oturum jetonu almak için giriş yapın
login_response = kalshi.request("POST", "/log_in")
session_token = login_response["token"]

# Sonraki istekler için jetonu kullanın (30 dakika geçerlidir)
headers = {
    "Authorization": f"Bearer {session_token}",
    "Content-Type": "application/json"
}

Jetonlar her 30 dakikada bir sona erer. Sürekli oturumları sürdürmek için sona ermeden önce otomatik yenileme mantığı uygulayın.

Profesyonel ipucuApidog

Temel API Uç Noktaları

Kalshi'nin REST API'si, kaynak türüne göre mantıksal uç nokta yapısıyla standart kuralları takip eder.

Piyasa Verileri (Halka Açık)

Mevcut piyasaları alın:

curl "https://api.kalshi.com/v1/markets" \
  -H "Content-Type: application/json"

Belirli piyasa detaylarını alın:

curl "https://api.kalshi.com/v1/markets/INXCHI-25JAN31-T69.5" \
  -H "Content-Type: application/json"

Hisse senedi sembolü formatı sözleşme detaylarını kodlar: INXCHI-25JAN31-T69.5, 31 Ocak 2025'te sona eren, 69.5 eşiğine sahip bir Enflasyon/Chicago Fed Ulusal Aktivite Endeksi piyasasını temsil eder.

Emir defteri derinliğini sorgulayın:

curl "https://api.kalshi.com/v1/markets/INXCHI-25JAN31-T69.5/orderbook" \
  -H "Content-Type: application/json"

Yanıt, sipariş vermeden önce likiditeyi değerlendirmenizi sağlayan miktarlarla birlikte alış ve satış seviyelerini döndürür.

İpucuApidog'un

Ticaret İşlemleri (Kimliği Doğrulanmış)

Bir alış emri verin:

order = kalshi.request("POST", "/orders", {
    "market_id": "INXCHI-25JAN31-T69.5",
    "side": "yes",
    "order_type": "limit",
    "price": 6500,  # 0.65 ABD Doları sent olarak
    "quantity": 100,  # Sözleşme sayısı
    "client_order_id": "my-strategy-001"  # İsteğe bağlı takip kimliği
})

Kalshi fiyatları sent cinsindendir (1 = 0.01 ABD Doları). 6500'deki bir limit emri, 0.65 ABD Doları veya daha iyi bir fiyattan yürütülür.

Açık bir emri iptal edin:

kalshi.request("DELETE", f"/orders/{order['id']}")

Açık emirlerinizi listeleyin:

curl "https://api.kalshi.com/v1/orders" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Portföy ve Hesap

Hesap bakiyesini kontrol edin:

curl "https://api.kalshi.com/v1/portfolio/balance" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Pozisyonları alın:

curl "https://api.kalshi.com/v1/portfolio/positions" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Pozisyonlar uç noktası, son işlem fiyatlarına göre gerçekleşmemiş kar/zarar da dahil olmak üzere tüm piyasalardaki mevcut varlıklarınızı döndürür.

İşlem geçmişini alın:

curl "https://api.kalshi.com/v1/portfolio/fills" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Gerçekleşen işlemler, zaman damgaları, fiyatlar ve ödenen ücretlerle birlikte yürütülen emirleri içerir.

Ödeme ve Çözümleme

Süresi dolmuş piyasalar için ödeme durumunu sorgulayın:

curl "https://api.kalshi.com/v1/markets/INXCHI-25JAN31-T69.5/settlement" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Çözümlendikten sonra, kazanan sözleşmeler hesabınıza hisse başına 1.00 ABD Doları yatırır; kaybeden pozisyonlar 0.00 ABD Doları'ndan çözümlenir.

kalshi api docs

WebSocket ile Gerçek Zamanlı Veri

REST yoklaması gecikmeye neden olur. Kalshi'nin WebSocket API'si gerçek zamanlı emir defteri güncellemeleri, ticaret yürütmeleri ve piyasa durumu değişikliklerini yayınlar.

WebSocket'e Bağlanma

const WebSocket = require('ws');

const ws = new WebSocket('wss://api.kalshi.com/v1/ws', {
  headers: {
    'Authorization': `Bearer ${sessionToken}`
  }
});

ws.on('open', () => {
  console.log('Kalshi WebSocket\'e bağlandı');
  
  // Belirli piyasa için emir defteri güncellemelerine abone ol
  ws.send(JSON.stringify({
    type: 'subscribe',
    channels: ['orderbook:INXCHI-25JAN31-T69.5']
  }));
});

ws.on('message', (data) => {
  const message = JSON.parse(data);
  
  switch(message.type) {
    case 'orderbook_update':
      console.log('Emir defteri değişti:', message.data);
      break;
    case 'trade':
      console.log('İşlem gerçekleşti:', message.data);
      break;
    case 'market_status':
      console.log('Piyasa durumu:', message.data);
      break;
  }
});

// Bağlantıyı sürdürmek için kalp atışı
setInterval(() => {
  ws.send(JSON.stringify({ type: 'ping' }));
}, 30000);

WebSocket bağlantıları, zaman aşımını önlemek için periyodik kalp atışları (her 30 saniyede bir) gerektirir. Üretim uygulamaları için otomatik yeniden bağlantı mantığı uygulayın.

Abonelik Kanalları

Mevcut kanallar şunları içerir:

Verimli veri akışı için tek bir mesajda birden fazla kanala abone olun.

Apidog'un
Apidog ile API Testi
Apidog ile API Testi
button

Geliştiriciler için Kalshi ve Polymarket Karşılaştırması

Her iki platform da tahmin piyasası API'leri sunar, ancak mimarileri farklı kullanım durumlarına hizmet eder.

Yasal Durum

Kalshi, CFTC tarafından düzenlenen Belirlenmiş Sözleşme Piyasası olarak faaliyet göstermektedir. Bu, ABD kullanıcıları için yasal netlik sağlar ancak KYC/AML uyumluluğu gerektirir ve 42 eyalete (Arizona, Illinois, Massachusetts, Maryland, Michigan, Montana, New Jersey, Ohio hariç) erişimi kısıtlar.

Polymarket kısa süre önce QCX LLC'nin satın alınması yoluyla CFTC onayını aldı ve No-Action Letter ile bir DCM lisansına sahip. Şu anda tam dağıtımın beklemesiyle uluslararası olarak sınırlı ABD erişimiyle faaliyet gösteriyor. Daha önce tescilsiz faaliyet göstermekten 1,4 milyon dolar para cezasına çarptırıldı (Ocak 2022).

Teknik Mimari

Kalshi, zincir dışı emir eşleştirme ve fiat USD ödemesi ile merkezi bir altyapı kullanır. API erişimi geleneksel kalıpları takip eder: HTTPS üzerinden REST, akış için WebSocket, kurumsal ticaret için FIX 4.4. Yanıt süreleri milisaniye cinsinden ölçülür.

Polymarket, Polygon blok zinciri üzerinde hibrit CLOB mimarisiyle çalışır—zincir dışı emir eşleştirme, Koşullu Jetonlar Çerçevesi aracılığıyla zincir içi ödeme. Entegrasyon, blok zinciri etkileşimi gerektirir: EIP-712 imzalı emirler, akıllı sözleşme çağrıları, USDC işlemleri. Ödeme kesinliği blok zinciri onayını gerektirir (saniyeler ila dakikalar).

Kimlik Doğrulama Modelleri

Kalshi, API anahtarlarıyla RSA-PSS imzalı istekler kullanır, 30 dakikada bir sona eren jeton tabanlı oturumlar kullanır. Güvenli özel anahtar depolama ve kriptografik imzalama gerektirir.

Polymarket, blok zinciri cüzdan imzalarını (MetaMask, WalletConnect) kullanır. Kullanıcılar, Polygon adreslerini kontrol eden özel anahtarlarla emirleri imzalar. Oturum jetonu yok—her işlem yeni bir imza gerektirir.

Ödeme Para Birimi

Kalshi, banka havalesi, ACH, banka kartı, PayPal, Apple Pay, Google Pay aracılığıyla USD olarak ödeme yapar. Minimum çekim genellikle 10 ABD Doları'dır. İşlem süresi ACH için 1-3 iş günü, havaleler için daha hızlıdır.

Polymarket, Polygon blok zincirinde USDC olarak ödeme yapar. Çözümlendikten sonra anında ödeme, ancak kripto cüzdanı ve on-ramp/off-ramp altyapısı gerektirir. Çekimler için gaz ücretleri uygulanır.

API Protokolleri

Kalshi üç protokol sunar:

Polymarket şunları gerektirir:

Kullanım Durumu Önerileri

Şunlar için Kalshi'yi seçin:

Şunlar için Polymarket'i seçin:

Entegrasyon Karmaşıklığı

Kalshi entegrasyonu, REST API deneyimine sahip olduğu varsayılarak temel piyasa verileri ve ticaret işlevselliği için 2-4 hafta gerektirir. Tanıdık HTTP kalıpları öğrenme eğrisini azaltır.

Polymarket entegrasyonu, güvenlik denetimi (50K-200K ABD Doları bütçe), oracle entegrasyonu ve likidite önyüklemesi dahil olmak üzere üretime hazır akıllı sözleşme piyasaları için 3-6 ay gerektirir. Blok zinciri uzmanlığı zorunludur.

Maliyet Yapısı

Kalshi, beklenen kazançlara dayalı olarak ticaret ücretleri alır (%0,7-3,5, ortalama %0,8). API erişimi ücretsizdir—yalnızca ticaret ücretlerini ödersiniz. ACH için çekim ücreti yoktur.

Polymarket, temel piyasalarda %0,01 alıcı ücreti alır, blok zinciri işlemleri için gaz ücretleri uygulanır. Bazı piyasalarda ücret yoktur, ancak ağ maliyetleri geçerlidir.

Sonuç

Kalshi'nin API'si, tanıdık REST ve WebSocket protokolleri aracılığıyla tahmin piyasalarına düzenlenmiş erişim sağlar. RSA imzalı isteklerle kimlik doğrulaması yapar, merkezi limit emir defteri aracılığıyla etkinlik sözleşmeleri ticareti yapar ve geleneksel bankacılık aracılığıyla USD olarak ödeme yaparsınız. CFTC gözetimi, ABD uygulamaları için yasal uyumluluk sağlarken, 200 milyon dolarlık gelir oranı kurumsal uygulanabilirliği göstermektedir.

Entegrasyon kalıplarını test etmek için demo ortamıyla başlayın. Üretime geçmeden önce uygun anahtar yönetimi ve istek imzalama işlemlerini uygulayın. Düşük gecikme gerektiren gerçek zamanlı uygulamalar için WebSocket akışını kullanın. 30 dakikalık jeton son kullanma süresini izleyin ve sürekli çalışma için yenileme mantığını uygulayın.

Apidog ile bugün başlayın—Kalshi API uç noktalarınızı saniyeler içinde içe aktarın ve sıfır yapılandırma ile tahmin piyasası stratejilerinizi test etmeye başlayın.

button

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin

Ücretsiz Kaydolİndir