Casplay Sports APIVeri API · v2
ENTR
iframeVeri API
← Tüm dokümanlar

Casplay Veri Besleme API

Maç öncesi ve canlı bülten, tam oran kataloğu, canlı durum, anlık akış ve seçenek bazında sonuç — kendi bahis motorunu çalıştıran operatörler için.

Marj, limit, bahis kabulü ve ödeme sizde; veriyi ve her seçeneğin sonucunu biz veririz. iframe ve cüzdan callback'i yoktur — yalnız veri ürünüdür (iframe spor sitesi için iframe entegrasyon dökümanına bakın).

İki kanal: (1) REST https://spor.casplay.net/v2/feed — anlık görüntü: bülten, tek maç, sonuçlar. (2) Anlık akış wss://spor.casplay.net/v2/feed/stream — her değişiklik olduğu anda. İkisi de aynı Bearer SPORTS_API_TOKEN ile.

Sözlük

TerimAnlamı
Event (maç)Bir maç (veya uzun vadeli / özel bahis). Kalıcı metin ID.
MarketBir maçın bahis türü, ör. maç sonucu, toplam gol 2.5. Anahtarı + params ile tanımlanır.
SeçenekMarketin bir sonucu (ör. “2.5 Üst”) ve oranı. Sonuçlar seçenek bazında verilir.
settleMarkette true = sonucunu biz yayımlarız; false = bizden sonuç gelmez.
schemaYanıt biçiminin sürümü. Yalnız geriye uyumsuz değişiklikte artar; yeni alanlar her zaman eklenebilir.

Hızlı başlangıç

  • Erişim alın. Veri beslemesini hesabınız için bayiniz (veya Casplay) açar — durumu panelinizde Entegrasyon sekmesinde görürsünüz. Açılana kadar her çağrı 403 feed_disabled döner.
  • Token'ı kopyalayın. Panel → Entegrasyon → SPORTS_API_TOKEN. Yalnız sunucunuzda tutun.
  • Sunucu IP'nizi ekleyin. Aynı sekme → İzinli IP'ler. Liste boşsa her çağrı reddedilir.
  • Bülteni yükleyin: GET /fixtures, gösterdiğiniz maçlar için GET /event/{id}.
  • Anlık akışı açın ve değişiklikleri durumunuza işleyin.
  • Bahislerinizi sonuçlandırın: bet_settlement veya GET /results.

Canlı oran nasıl güncellenir

Oranlar olay tetiklidir, saat tık'ı değil. Bir oran yalnız gerçekten değiştiğinde gönderilir — sakin bir market aynı oranı birkaç saniye tutabilir; bu doğrudur, arıza da bloke de değildir. Mesaj yoksa oran değişmemiştir ve hâlâ geçerlidir. Saniyede bir güncelleme beklemeyin; öyle bir şey yok.

GördüğünüzAnlamı
birkaç saniye odds_change yokoran hareket etmedi — elinizdeki oranı göstermeye devam edin
odds_changeoran (ya da frozen) değişti — yeni market satırlarını uygulayın
frozen: true olan seçeneko seçenek bir an askıda (gol, VAR, son dakika parası) — kendiliğinden açılır; sistem bloğu değil
her 10 sn aliveakış canlı — canlılık sinyali, veri değil; üst üste üçünü kaçırırsanız yeniden bağlanın
Anlık akışı kullanın; saniyede bir sorgulamayın. Akış, her değişikliği bize ulaşmasından ~yarım saniye içinde iletir. /fixtures veya /event/{id}'i saniyede bir döngüyle çekmek yalnız gecikme ekler ve hız limitinizi tüketir — üstelik oran sabitken yeni bir şey de döndürmez. Soketi gerçekten açık tutamıyorsanız canlı maçları 2–5 sn'de bir çekin (Önerilen akış), daha sık değil.
İki değişiklik arasındaki boşluğu spor ve an belirler, biz değil: aksiyon anında saniyede birkaç güncelleme, sakin anda onlarca saniye sessizlik olağandır. Düzenli 2–3 sn'lik bir ritim neredeyse her zaman zamanlayıcıyla poll yaptığınız anlamına gelir — değişiklikleri olduğu an almak için akışa geçin.

Kimlik & erişim

Her REST çağrısında ve WebSocket el sıkışmasında

Authorization: Bearer {SPORTS_API_TOKEN}
Accept-Encoding: gzip
KuralAyrıntı
Temel adreshttps://spor.casplay.net/v2/feed · akış wss://spor.casplay.net/v2/feed/stream
İzinli IPYalnız panelinizdeki IP listesinden gelen istekler kabul edilir.
EtkinleştirmeVeri beslemesini hesabınız için bayiniz (veya Casplay) açar; açılana kadar 403 feed_disabled.
LimitlerHesap başına dakikada 1200 REST isteği (aşılırsa 429 rate_limited) · dakikada 300 Bet Builder isteği · hesap başına en fazla 5 akış bağlantısı.
SıkıştırmaAccept-Encoding: gzip gönderin — tüm bülten ~1,2 MB, sıkıştırılmış ~160 KB.
Dil?lang= en tr de fr es pt ar ur he hi zh ko fa (varsayılan en). Takım, lig, kategori, market, seçenek, spor ve periyot adlarının hepsi bu dilde gelir.
Token sızdı mı? Panelde “Token'ları yenile” — eski token yeni isteklerde hemen geçersiz olur; akışınızı yeni token'la yeniden bağlayın.

Yanıtlar & hatalar

Her başarılı yanıt: { ok: true, schema, ts, lang, data }. ts = sunucu zamanı (ms). Tanımadığınız alanı yok sayın — yeni alanlar her zaman eklenebilir.

Hatalar gerçek HTTP durum koduyla ve şu gövdeyle döner:

{ "ok": false, "error": { "code": "ip_not_allowed", "message": "IP not allowed: 203.0.113.7" } }
HTTPcodeAnlamı
401unauthorizedtoken yok veya yanlış
403ip_not_allowedIP izinli listede değil (veya liste boş)
403feed_disabledveri beslemesi bu hesapta açık değil
403account_inactive · subscription_expired · credit_exceededhesap kapalı
404not_foundmaç, sonuç veya uç bulunamadı
405method_not_allowedyanlış yöntem (her yerde GET; yalnız /betbuilder/price POST)
429rate_limited · too_many_connectionsyavaşlayın
500internalsonra tekrar deneyin

ID'ler & anahtarlar

  • Tüm ID'ler metin ve kalıcıdır: maç, takım, lig, kategori.
  • Market anahtarı m{marketType}_p{period}[_s{subPeriod}][_r{resultKind}] — ör. m2_p0 maç sonucu, m5_p0_r4 toplam korner, m5_p1_s85 85. dakikaya kadar toplam gol. Çizgili marketler (alt/üst, handikap) her çizgi için ayrı satırdır; çizgi params içindedir.
  • Seçimin kimliği = maç ID + market anahtarı + params + seçenek type + values. Her bahiste bunları saklayın — sonuçlar aynı kimlikle gelir.
resultKindBirim
1ana birim (gol / sayı / set / harita)
4korner
8kart
16kırmızı kart
2faul
14şut
66isabetli şut
67ofsayt

Maç alanları

AlanDeğerler
stageprematch · live · finished
statusnot_started started paused finished retired abandoned interrupted cancelled postponed
tradingopen · suspended (maçın tamamı askıda) · closed (başladı, bitti veya güncellenmiyor). open değilse bahis almayın.
phasecanlı: o anki evre, istenen dilde — ör. 1. yarı, Devre arası, 3. çeyrek, 2. set, Penaltılar
scoresporun ana biriminde maç toplamı (gol, sayı, set, harita, run)
periodsperiyot skorları — bkz. Periyotlar
scoreWithExtrafutbol: uzatma ve penaltılar dahil toplam (score'dan farklıysa)
gameScoretenis canlı: o anki oyunun puanı, ör. "40-15"
statsgoals corners cards red_cards fouls shots shots_on_target offsides sets games points maps rounds runs wickets — her biri {home, away}; bilinmeyen kodlar rk<n>
clockcanlı: seconds minute running countdown (geri sayan sporlar)
servingtenis / voleybol / masa tenisi / badminton canlı: home · away
betBuildertrue = aynı maç kombinesi var — bkz. Bet Builder
logo · flag · iconkendi alan adımızda görsel adresleri: takım logosu (competitors[].logo), ülke/kategori bayrağı (category.flag), spor simgesi (/sports → icon) — bkz. Görseller
odd · frozenondalık oran; frozen: true = seçenek şu an askıda
ordermarketin sayfadaki yeri — her dilde aynı olan bir sayı. Marketleri order alanına göre sıralayın; aynı key içindeki çizgiler zaten params sırasıyla (0.5, 1.5, 2.5 …), seçenekler de sabit sırayla (1X2: type 0, 1, 3) gelir. name alanına göre sıralamayın ve eşleştirmeyin — adlar lang ile değişir.
settletrue = bu marketin sonucu bizde (/results, bet_settlement). false = bizden sonuç gelmez; kendi kaynağınızla sonuçlandırın veya sunmayın.
complete/event/{id}: maç öncesi maçta ilk istekte false — yalnız ana marketler; tam katalog birkaç saniye içinde gelir (tekrar isteyin veya akışı kullanın).

Periyotlar

SporPeriyot etiketleri
Futbol (F)1H 2H ET1 ET2 (gol)
Basketbol (B)Q1 Q2 Q3 Q4 OT 1H 2H (sayı; OT = 4. çeyrekten sonrası)
Buz hokeyi (H)P1 P2 P3 OT (gol)
Tenis (T)S1 S2 … set başına oyun (skor = set)
Voleybol, masa tenisi, badminton, plaj voleyboluS1 S2 … set başına sayı (skor = set)
E-spor (CS)M1 M2 … harita başına raunt (skor = harita)
Diğer sporlarproviderPeriods: ham sağlayıcı periyotları (period: 1 = maç toplamı; diğer kodlar garanti edilmez)

Sporlar

GEThttps://spor.casplay.net/v2/feed/sports

Açık maçı olan sporlar. Kodlar: F futbol, B basketbol, T tenis, H buz hokeyi, CS e-spor, TT masa tenisi, VB voleybol, HB hentbol, CK kriket, BB beyzbol…

İstek

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/sports?lang=tr"

Yanıt · 200

{
  "ok": true, "schema": 1, "ts": 1792148629547, "lang": "tr",
  "data": [ { "id": "F", "name": "Futbol", "icon": "https://spor.casplay.net/v2/img/sport/f", "live": 32, "prematch": 555 }, "…" ]
}

Ligler

GEThttps://spor.casplay.net/v2/feed/tournaments

Şu an açık maçı olan tüm ligler / turnuvalar; ülkesi ve maç sayılarıyla. İsteğe bağlı süzgeçler: sport (kod), category (id). id değerini /fixtures'ta tournament olarak kullanın.

İstek

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/tournaments?sport=F&lang=tr"

Yanıt · 200

{
  "ok": true, "schema": 1, "ts": 1792148629547, "lang": "tr",
  "data": [ { "id": "17", "name": "Premier Lig", "sport": "F",
              "category": { "id": "1", "name": "İngiltere", "country": "GB", "flag": "https://spor.casplay.net/v2/img/flag/gb" },
              "live": 2, "prematch": 18 }, "…" ]
}

Bülten

GEThttps://spor.casplay.net/v2/feed/fixtures

Açık maçlar (maç öncesi + canlı), başlama saatine göre sıralı. Bitenler /results'ta.

ParametreZorunluAçıklama
sporthayırspor kodu, ör. F
stagehayırprematch veya live
tournament · categoryhayırlig / kategori ID
from · tohayırbaşlama zamanı aralığı (ISO)
langhayırad dili (varsayılan en)

İstek

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/fixtures?sport=F&stage=live&lang=tr"

Yanıt · 200

{
  "ok": true, "schema": 1, "ts": 1792094101023, "lang": "en",
  "data": [{
    "id": "18898080", "sport": "F",
    "category": { "id": "b7d9493d…", "name": "Guatemala", "country": "GTM", "flag": "https://spor.casplay.net/v2/img/flag/gtm" },
    "tournament": { "id": "e83fc447…", "name": "National League" },
    "name": "Xelaju MC - CD Malacateco",
    "competitors": [ { "id": "18058", "name": "Xelaju MC", "side": "home", "logo": "https://spor.casplay.net/v2/img/team/18058" },
                     { "id": "78117", "name": "CD Malacateco", "side": "away", "logo": "https://spor.casplay.net/v2/img/team/78117" } ],
    "startTime": "2026-10-15T19:00:00.000Z",
    "stage": "live", "status": "started", "trading": "open",
    "betBuilder": true, "marketCount": 78,
    "score": { "home": 2, "away": 1 },
    "periods": [ { "period": "1H", "home": 1, "away": 1 }, { "period": "2H", "home": 1, "away": 0 } ],
    "stats": { "goals": { "home": 2, "away": 1 }, "corners": { "home": 5, "away": 3 } },
    "clock": { "seconds": 5581, "minute": 93, "running": true, "countdown": false }
  }]
}

Maç detayı

GEThttps://spor.casplay.net/v2/feed/event/{id}

Tek maç: tüm marketler ve oranlar. Oranı olmayan seçenekler gönderilmez. Maç öncesi maçlar için Maç alanları'ndaki complete alanına bakın.

İstek

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/event/18680637?lang=tr"

Yanıt · 200

{
  "ok": true, "schema": 1, "ts": 1792094390486, "lang": "en",
  "data": {
    "id": "18680637", "sport": "F", "stage": "prematch", "trading": "open", "…": "same fields as fixtures",
    "markets": [
      { "key": "m2_p0", "marketType": 2, "period": 0, "resultKind": 1, "params": [],
        "name": "Full-time result", "settle": true,
        "outcomes": [ { "type": 0, "values": [], "name": "Hearts", "odd": 1.44, "frozen": false },
                      { "type": 1, "values": [], "name": "Draw", "odd": 4, "frozen": false },
                      { "type": 3, "values": [], "name": "FC Nordsjaelland", "odd": 7.5, "frozen": true } ] },
      { "key": "m5_p0", "marketType": 5, "period": 0, "resultKind": 1, "params": ["2.5"],
        "name": "Total goals", "settle": true,
        "outcomes": [ { "type": 4, "values": [], "name": "Over 2.5", "odd": 1.7, "frozen": false },
                      { "type": 5, "values": [], "name": "Under 2.5", "odd": 2.05, "frozen": false } ] },
      { "key": "m5_p1_s85", "marketType": 5, "period": 1, "subPeriod": 85, "resultKind": 1, "params": ["2.5"],
        "name": "Total goals until minute 85", "settle": true, "outcomes": [ "…" ] }
    ]
  }
}

Ad sözlüğü

GEThttps://spor.casplay.net/v2/feed/dictionary

Tüm market ve seçenek tiplerinin ham ad şablonları (kendi etiketlerinizi üretmek için). cond = spor:resultKind:periyot:param1:param2 koşulları (= eşit, ! değil, >, <, boş = hepsi); ilk eşleşen varyant geçerlidir.

İstek

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/dictionary?lang=tr"

Sonuçlar

GEThttps://spor.casplay.net/v2/feed/results
GEThttps://spor.casplay.net/v2/feed/results/{id}

Biten maçlar ve her settle: true marketin her seçeneğinin sonucu — kendi bahislerimizi sonuçlandıran motorla aynı kurallarla hesaplanır. Liste son 48 saati kapsar — en az günde bir sorgulayın.

ParametreZorunluAçıklama
sincehayırISO zaman, updatedAt'e göre süzer — gördüğünüz son updatedAt ile sorgulayın; yeni sonuçlar ve sonradan gelen düzeltmeler gelir. Varsayılan: son 24 saat; en çok 48 saat geriye (daha eski değer 48 saat sayılır).
sporthayırspor kodu
marketshayır0 = yalnız skorlar
langhayırad dili

Sonuç değerleri

resultS tutarlı, O oranlı bahsin ödemesi
wonS × O
lost0
voidS (iade)
half_wonS/2 × O + S/2 (Asya çizgileri)
half_lostS/2 (Asya çizgileri)
pendinghenüz kesin değil — resmî teyit bekleniyor; sonuçlandırmayın
  • confirmed: true = bekleyen seçenek kalmadı; kayıt artık değişmez.
  • Bazı marketler (futbol yarıları, korner/kart, dakika aralıkları, futbol dışı periyot marketleri, kriket) resmî sonucu bekler — genelde dakikalar, en fazla 48 saat. 48 saatte resmî sonuç gelmezse bekleyen seçenekler void olur ve noResult: true.
  • cancelled: true = maç resmî olarak iptal; seçenekleri void.

İstek

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/results?since=2026-10-15T21:00:00Z&lang=tr"

Yanıt · 200

{
  "ok": true, "schema": 1, "ts": 1792098114821, "lang": "en",
  "data": [{
    "id": "19022083", "sport": "B", "name": "KR Reykjavik - UMFN Njardvik", "stage": "finished", "status": "finished",
    "finishedAt": "2026-10-15T21:01:12.000Z", "updatedAt": "2026-10-15T21:01:45.000Z", "confirmed": true,
    "score": { "home": 84, "away": 73 },
    "periods": [ { "period": "Q1", "home": 18, "away": 24 }, { "period": "Q2", "home": 17, "away": 17 }, "…" ],
    "markets": [
      { "key": "m145_p0", "marketType": 145, "period": 0, "resultKind": 1, "params": [],
        "outcomes": [ { "type": 0, "values": [], "result": "won" }, { "type": 3, "values": [], "result": "lost" } ] },
      { "key": "m800_p0", "marketType": 800, "period": 0, "resultKind": 1, "params": ["-10.75"],
        "outcomes": [ { "type": 86, "values": [], "result": "half_won" }, { "type": 87, "values": [], "result": "half_lost" } ] }
    ]
  }]
}

Bet Builder marketleri

GEThttps://spor.casplay.net/v2/feed/betbuilder/{id}

Bir maçta birlikte oynanabilen marketler (aynı maç kombinesi), adları ve güncel tekli oranlarıyla: { eventId, available, markets:[…] } — market satırı biçimi /event/{id} ile aynı. Maçta betBuilder: true ise vardır.

İstek

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/betbuilder/18012490?lang=tr"

Bet Builder oranı

POSThttps://spor.casplay.net/v2/feed/betbuilder/price

Aynı maçın 2–12 seçimi için korelasyonlu kombine oran.

İstek

POST https://spor.casplay.net/v2/feed/betbuilder/price
Authorization: Bearer {SPORTS_API_TOKEN}
Content-Type: application/json

{ "eventId": "18012490",
  "selections": [ { "key": "m2_p0", "params": [],      "type": 0, "values": [] },
                  { "key": "m5_p0", "params": ["2.5"], "type": 4, "values": [] } ] }

Yanıt · 200

{ "ok": true, "data": { "eventId": "18012490", "available": true, "odd": 3.85, "notAvailable": [] } }
Oranlar değişir — bahsi kabul etmeden hemen önce fiyatı tekrar isteyin.
Sonuçlandırma: Bet Builder bahsi yalnız tüm seçimler won ise kazanır; her seçimi /results'tan sonuçlandırın. settle: false marketlerin sonucu bizden gelmez — bizim verimizle sonuçlandıracağınız kombinelerde sunmayın.

Maç takibi

GEThttps://spor.casplay.net/v2/feed/event/{id}/tracker

Maçın hareketli canlı takip ekranı (saha/kort radarı; canlı istatistik, kadro ve olay akışıyla). url adresini <iframe> içinde gösterin. Çoğunlukla futbol, basketbol, tenis ve diğer büyük sporlarda maç canlıyken vardır; yoksa available: false. Kullanıcı maçı açınca isteyin — adres maç boyunca değişmez.

ParametreZorunluAçıklama
langhayırtakip ekranının dili
themehayırdark (varsayılan) veya light

İstek

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/event/18936236/tracker?lang=tr&theme=dark"

Yanıt · 200

{ "ok": true, "data": { "eventId": "18936236", "available": true, "type": "radar", "url": "https://…" } }

Anlık akış — bağlantı

WSwss://spor.casplay.net/v2/feed/stream

REST ile aynı Authorization başlığı ve IP kuralları. Her mesajda artan seq ve sunucu zamanı ts vardır.

ParametreZorunluAçıklama
langhayırad dili
livehayır1 (varsayılan) = tüm canlı maçlar · 0 = hiçbiri
prematchhayır1 = tüm maç öncesi maçlar (varsayılan 0)
sportshayıryalnız bu sporlar, ör. F,B
eventshayıryalnız bu maçlar, ör. id1,id2 (sonradan abone de olabilirsiniz)
session · sincehayırkopmadan sonra kaldığı yerden devam — bkz. Yeniden bağlanma

Maç öncesi bir maça abone olmak o maçın tüm marketlerini de açar.

Mesajlar

typeNe zaman
helloilk mesaj: sessionId, seçenekleriniz ve resumed
odds_changeoran veya askı değişti — değişen market anahtarlarının tüm satırları, /event/{id} ile aynı biçim. Bir anahtarın gelen satırları, o anahtar için elinizdekilerin yerine geçer (listede artık olmayan çizgi kapanmıştır). removed (isteğe bağlı anahtar dizisi) = artık hiç sunulmayan marketler — silin
event_statusskor, periyot, evre, durum veya bahis durumu değişti — /fixtures'taki nesnenin aynısı
fixture_changechange: "new" yeni maç · change: "removed" maç akıştan kalktı (2 dk güncelleme yok)
bet_settlementbir sonuç hesaplandı veya güncellendi — /results'taki nesnenin aynısı
alive10 sn'de bir canlılık sinyali; üçünü kaçırırsanız yeniden bağlanın
subscribed · unsubscribed · optionsop mesajınızın onayı (gerçekten eklenen/çıkarılan maç ID'leri ya da geçerli seçenekler)
resync_requiredoturum sürdürülemedi — bkz. Yeniden bağlanma
erroraccess_revoked: veri erişimi kaldırıldı (Veri API kapatıldı, hesap kapandı, IP çıkarıldı) — bağlantı 4003 koduyla kapanır · bad_json / unknown_op: mesajınız okunamadı (bağlantı açık kalır)
// server → client
{ "type": "hello", "schema": 1, "ts": 1792098097803, "sessionId": "3f9c…", "resumed": false, "seq": 0, "lang": "en", "live": true, "prematch": false, "sports": null, "eventIds": [] }
{ "type": "odds_change", "seq": 1, "ts": 1792098098265, "eventId": "18968312",
  "markets": [ { "key": "m1_p0", "params": [], "name": "Winner", "settle": true,
                 "outcomes": [ { "type": 0, "values": [], "name": "Cloud9", "odd": 1.38, "frozen": false }, "…" ] } ] }
{ "type": "odds_change", "seq": 9, "ts": 1792098098301, "eventId": "19044714", "markets": [], "removed": [ "m2_p0", "m5_p1" ] }
{ "type": "event_status", "seq": 24, "ts": 1792098098767, "event": { "id": "19044714", "stage": "live", "score": { "home": 1, "away": 5 }, "…": "same as /fixtures" } }
{ "type": "fixture_change", "seq": 143, "ts": 1792098104785, "change": "new", "event": { "…": "same as /fixtures" } }
{ "type": "fixture_change", "seq": 150, "ts": 1792098109785, "change": "removed", "eventId": "19061250" }
{ "type": "bet_settlement", "seq": 217, "ts": 1792098114821, "result": { "…": "same as /results" } }
{ "type": "alive", "seq": 140, "ts": 1792098103731 }

// client → server
{ "op": "subscribe",   "eventIds": ["18680637", "18882446"] }
{ "op": "unsubscribe", "eventIds": ["18680637"] }
{ "op": "options", "live": true, "prematch": false, "sports": ["F", "B"] }

Yeniden bağlanma & kapanma kodları

  • hello'daki sessionId'yi ve işlediğiniz son seq'i saklayın.
  • ?session=<sessionId>&since=<seq> ile yeniden bağlanın. Oturum koptuktan sonra 5 dakika mesaj biriktirir ve sırayla tekrar gönderir (replay: true).
  • resync_required gelirse (oturum bilinmiyor veya çok uzun kopuk kaldınız) durumu /fixtures, /event/{id} ve /results?since= ile tazeleyin.

Sunucu 10 sn'de bir WebSocket ping gönderir — standart istemciler otomatik yanıtlar.

Kapanma koduAnlamı
4003erişim kaldırıldı (hata mesajına bakın)
4000aynı session başka bir bağlantıyla açıldı
1008mesajları çok yavaş okuyorsunuz (birikti)
100175 sn yanıt yok ya da sunucu yeniden başladı — session + since ile yeniden bağlanın
1009gönderdiğiniz mesaj çok büyük

Uçtan uca örnek

En küçük ayrıntısına kadar, çalışan tek bir entegrasyon. {SPORTS_API_TOKEN} panel token'ınız; çağrı yaptığınız sunucu IP'si izinli IP listenizde olmalı.

1 · Bülteni bir kez yükle (REST)

Tüm canlı maçları ana-market oranlarıyla tek çağrıda çekin. --compressed = Accept-Encoding: gzip gönderir (~1,2 MB ham → ~160 KB gzip):

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/fixtures?stage=live&odds=1&lang=tr"

Ve tek bir maçın tam market derinliği:

curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/event/18680637?lang=tr"

2 · Bir marketi oku

Her market — /event/{id}'de ve her odds_change'de — şu biçimdedir:

{ "key": "m2_p0", "name": "Maç sonucu", "settle": true, "params": [],
  "outcomes": [ { "type": 0, "name": "Hearts", "odd": 1.44, "frozen": false },
                { "type": 1, "name": "Beraberlik", "odd": 4, "frozen": false },
                { "type": 3, "name": "FC Nordsjaelland", "odd": 7.5, "frozen": true } ] }
  • Her seçeneği bir demet (tuple) olarak sakla: maç id + key + params + seçenek type + values — burada 18680637 · m2_p0 · [] · 0 · []. Sonuçlar ve bet_settlement tam olarak aynı demeti kullanır; eşleştirmeyi bununla yaparsınız.
  • Çizgili marketler (toplam, handikap) çizgiyi params'ta taşır: m5_p0 + params: ["2.5"] → Üst = type 4, Alt = type 5.
  • Bahsi yalnız maç trading: "open" ve o seçenek frozen: false iken kabul edin.

3 · Akışla canlı kal — polling yok

Kopyala-çalıştır istemci: bağlanır, her değişikliği uygular ve kopma sonrası hiç mesaj kaçırmadan kaldığı yerden devam eder.

// Minimal Node.js stream client  (npm i ws · Node 18+).  Server-to-server only.
import WebSocket from 'ws';

const BASE  = 'wss://spor.casplay.net/v2/feed/stream';
const TOKEN = process.env.SPORTS_API_TOKEN;   // keep on the server, never in a browser

let sessionId = null;        // from the first "hello"
let lastSeq   = 0;           // highest seq you have applied
const book    = new Map();   // eventId -> { markets }  : your in-memory odds

function connect() {
  // First time: ?live=1 . After a drop: resume with session + since so nothing is missed.
  const q = sessionId
    ? '?session=' + sessionId + '&since=' + lastSeq
    : '?live=1&lang=en';
  const ws = new WebSocket(BASE + q, { headers: { Authorization: 'Bearer ' + TOKEN } });

  ws.on('message', (data) => {
    const m = JSON.parse(data);                     // one JSON object per message
    if (typeof m.seq === 'number') lastSeq = Math.max(lastSeq, m.seq);
    switch (m.type) {
      case 'hello':           sessionId = m.sessionId; break;            // store it to resume
      case 'odds_change':     applyOdds(m.eventId, m.markets, m.removed); break;   // full rows of changed keys
      case 'event_status':    applyStatus(m.event); break;              // score / phase / trading
      case 'fixture_change':  m.change === 'new' ? addEvent(m.event) : removeEvent(m.eventId); break;
      case 'bet_settlement':  settle(m.result); break;                  // same shape as /results
      case 'alive':           break;                                    // heartbeat only - no data
      case 'resync_required': bootstrapFromRest(); break;               // reload /fixtures + /results
      case 'error':           console.error('stream', m.code, m.message); break;
    }
  });

  // The server pings every 10 s; the ws library answers the pong automatically.
  ws.on('close',  (code) => { console.log('closed', code, '- reconnecting'); setTimeout(connect, 1000); });
  ws.on('error',  () => {});   // a 'close' event always follows
}

function applyOdds(eventId, markets, removed) {
  const ev = book.get(eventId) || { markets: {} };
  // The message carries ALL current lines of every changed key, and "removed" lists keys
  // that are no longer offered -> first drop every row you hold for those keys, then add
  // the new rows. Otherwise closed lines / withdrawn markets stay on screen with old odds.
  const changed = new Set([...markets.map((mk) => mk.key), ...(removed || [])]);
  for (const id of Object.keys(ev.markets)) if (changed.has(ev.markets[id].key)) delete ev.markets[id];
  // A market with lines (totals, handicaps) shares one key but differs by params,
  // so the identity is key + params - not key alone (never the position in the list).
  for (const mk of markets) ev.markets[mk.key + '|' + (mk.params || []).join(',')] = mk;
  book.set(eventId, ev);
}

connect();
Tarayıcıda WebSocket'e Authorization başlığı koyamazsınız — akışı sunucunuzda çalıştırıp tarayıcıya kendiniz iletin.

4 · Sonuçlandır

Sonuç geldiğinde — akışta bet_settlement ya da dakikada bir GET /results?since= — sakladığınız her seçenek demetini bulup ödeyin:

resultS bahis, O oran için ödeme
wonS × O
voidS (iade)
half_wonS/2 × O + S/2
half_lostS/2
lost0
pendingbekle — henüz kesin değil

Kombine (Bet Builder dahil) yalnız tüm seçenekler won ise kazanır. Yalnız settle: true marketlerin sonucu bizden gelir.

Görseller

Takım logoları, ülke/kategori bayrakları ve spor simgeleri kendi alan adımızdan verilir. Token gerekmez — adresleri doğrudan <img src> içinde kullanın. Tarayıcı önbelleği uzundur (7 gün).

GEThttps://spor.casplay.net/v2/img/team/{competitorId}
GEThttps://spor.casplay.net/v2/img/flag/{country}
GEThttps://spor.casplay.net/v2/img/sport/{sportId}
GörselKaynak alan
takım / oyuncu logosu (WebP)competitors[].logo
ülke veya kategori bayrağıcategory.flag (category.country, küçük harf)
spor simgesi/sports → icon (küçük harf spor kodu)
Her takımın/kategorinin görseli olmayabilir: olmayan görsel 404 döner — kendi yedek görselinizi gösterin (onerror).

Önerilen akış

  • Başlangıç: /fixtures (gösterdiğiniz maçlar için /event/{id}).
  • Akışı açın; odds_change, event_status, fixture_change mesajlarını durumunuza işleyin. Gösterdiğiniz maç öncesi maçlara abone olun (op: subscribe) veya prematch=1 kullanın.
  • Bahsi yalnız maç trading: open ve seçenek frozen değilken kabul edin.
  • Seçeneğin sonucu pending değilken bet_settlement ile (veya dakikada bir /results?since=) sonuçlandırın.
Akışsız kullanım: /fixtures?stage=live 10 sn'de bir, gösterdiğiniz canlı maçlar için /event/{id} 2–5 sn'de bir.

Kapsam

AlanKapsam
Maçlarakıştaki tüm maç öncesi ve canlı maçlar, özel/uzun vadeli bahis "maçları" dahil
Sonuçlartüm seçeneklerin yaklaşık %88'inin sonucu bizden gelir (canlı örnek, Ekim 2026) — futbol ve basketbol ~%100 (futbolda 1. yarı korner dahil; korner yarışı / N. korner yalnız resmî korner sırasını düzenli tam veren liglerde — maç bazında settle alanına bakın), tenis ~%95, buz hokeyi ~%88, voleybol ~%76, masa tenisi ~%70, e-spor ~%60, kriket ~%40–60
Sonucu olmayansettle: false marketler çoğunlukla kaynağın yayımlamadığı maç içi istatistiklerdir: tenis/masa tenisi/voleybol/hokeyde "ilk N'e ulaşan", kriket top-top ve oyuncu marketleri, e-spor kill/hedef marketleri (ilk kan, Baron, ejderha…)
Golcüfutbol — gol atar / 2+ / 3+ gol, gol veya asist, ilk / son / ikinci golcü — maç öncesi ve canlı — maçın gol listesini izlediğimiz maçlarda settle: true; sonuç bitiş düdüğünden yaklaşık 20–30 dk sonra gelir. Goller oyuncuya resmî kadro üzerinden bağlanır ve resmî skorla çapraz kontrol edilir; oynamayan veya kadroda doğrulanamayan oyuncu void. Kendi kalesine gol hiçbir oyuncuya sayılmaz; kendi kalesine gol olan maçta ilk/son/ikinci golcü void. Yarı golcü marketleri settle: false.
Betradar IDkaynakta yok

Sık yapılan hatalar

BelirtiNeden & çözüm
“Oranlar sadece 2–3 sn’de bir güncelleniyor”Zamanlayıcıyla poll yapıyorsunuz. Akışı kullanın — her değişikliği ~0,5 sn'de iter. Bkz. Canlı oran güncellemesi.
“Oranlar durdu / dondu”odds_change gelmemesi oranın hareket etmediği anlamına gelir. Canlılık için alive'ı (10 sn) izleyin; tek bir frozen: true seçenek anlık askıdır, bloke değil.
Her çağrı 403 dönüyorIP whitelist boş ya da sunucu IP'niz listede değil — panelden ekleyin (Entegrasyon → İzinli IP'ler). Veya Veri API henüz açık değil (feed_disabled).
Yanıtlar çok büyük / yavaşAccept-Encoding: gzip gönderin (curl --compressed). /fixtures'i bir kez çekip sonra akışı dinleyin — döngüyle tekrar çekmeyin.
Oranlar yanlış sütunda görünüyor (1 / X / 2)Seçenekleri outcomes dizisindeki sırasına göre yerleştiriyorsunuz. Fiyatı olmayan seçenek listede yer almaz (ör. 0–2'de deplasman galibiyeti çekilmiş olabilir; geriye yalnız ev sahibi ve beraberlik kalır), bu yüzden sıra kayar. Her zaman type alanına göre yerleştirin (1X2: 0 = ev sahibi, 1 = beraberlik, 3 = deplasman); eksik tür için kilit gösterin.
Kapanan çizgi / eski oran ekranda kalıyorodds_change geldiğinde değişen her key için elinizdeki tüm satırları mesajdakilerle değiştirin ve removed listesindeki anahtarları silin. Liste sırasına göre birleştirmeyin.
Sonuçlar bahislerime uymuyorBahsi sonuçtan farklı anahtarladınız. Tam seçenek demetini saklayıp eşleştirin: maç id + key + params + type + values.
Reconnect sonrası mesaj kaçtı?session=&since=<sonSeq> ile bağlanın (5 dk replay). resync_required gelirse /fixtures + /results?since= ile tazeleyin.
429 too_many_connectionsHesap başına en fazla 5 akış bağlantısı, 1200 REST istek/dk. Tek akış yeter — gereken maçlara abone olun.
Tarayıcı WebSocket kimlik doğrulayamıyorEl sıkışma Authorization başlığı ister; tarayıcı sokete başlık koyamaz. Akışı sunucuda çalıştırın.
Betradar ID bekliyorumKaynakta yok — bizim sabit id'lerimiz ve seçenek demeti üzerinden eşleştirin.

Hata bildirimi & sorumluluk

Sistemimizden kaynaklandığını düşündüğünüz bir hata (yanlış oran, yanlış ya da eksik sonuç, hatalı market verisi vb.) fark ettiğinizde bize bildirmeniz yeterlidir.

  • Bildirim süresi: hatanın oluştuğu andan itibaren en geç 24 saat. Bildirimde ilgili maç kimlikleri, market ve seçenek bilgisi ile kısa bir açıklama iletin.
  • Telafi: süresi içinde bildirilen ve incelememizde bizden kaynaklandığı doğrulanan hatalarda oluşan net kaybınız, kullandığınız pakete göre hesabınıza tanımlanır: GGR paketi kullanıyorsanız GGR kredisi, abonelik paketi kullanıyorsanız abonelik süresi olarak. Nakit iade yapılmaz.
  • Net kayıp: hatadan yararlanan oyunculardan geri alınabilen tutarlar düşüldükten sonra kalan tutardır. Bir hatanın bilerek ve tekrar tekrar kullanıldığı durumlarda ilgili ödemeleri oyunculardan geri almanızı bekleriz.
  • Zamanında (24 saat içinde) bildirilmeyen hatalardan doğan kayıplar için sorumluluk kabul edilmez.