Sağlayıcı API/GGR raporları

GGR raporları

API · Operatör → Boss Hub

GET/v1/reports/ggr

Seçtiğiniz aralık için bahis, kazanç ve GGR toplamlarını gün, oyun, site, sağlayıcı veya para birimine göre gruplayarak döndürür. api modülü ve reports.read kapsamı gerekir.

Başlıklar

Başlık	Açıklama
X-Operator-Id	Operatör kimliğiniz
X-Timestamp	Unix saniye. ±30 sn dışı reddedilir
X-Signature	hex(HMAC_SHA256(secret, ts + "." + METHOD + "." + path?query + "." + body))
X-Api-Key	İsteğe bağlı. Birden çok anahtarınız varsa doğru secret’ı seçer

Sorgu parametreleri

fromdate-time

Başlangıç. Günlük toplamlar kullanıldığı için from’un UTC günü bütünüyle sayılır. Verilmezse todan 30 gün önce.

todate-time

Bitiş zamanı, dahil değil; gün ortası verilirse o gün de sayılır. Verilmezse şimdi. Aralık en çok 366 gün.

group_bystring

Gruplama: day (varsayılan), game, site, provider, currency.

currencyISO 4217

USD (varsayılan), EUR, TRY.

site_idstring

Site kodu, örn. site_mrd01. Verilmezse tüm siteler; site anahtarında kendi sitesi.

Hesap tarihi: Tutarlar işlemin muhasebe tarihine (booked_at) yazılır; bahis ve kazanç tur kapanınca bu tarihi alır. Sonradan gelen rollback eksi kayıt olarak kendi tarihine düşer, kapanmış ayın satırları değişmez. Günler UTC’dir. Bugünün satırı kesin değildir; günlük toplamlar birkaç dakikada bir yenilenir. Hareketsiz gün veya grup satır olarak gelmez (sıfırla doldurulmaz); satırlar key’e göre sıralıdır.

GET /v1/reports/ggr?from=2026-11-04T00:00:00Z&to=2026-11-06T00:00:00Z&group_by=day&currency=USD HTTP/1.1
Host: staging.example.com
X-Operator-Id: op_meridyen
X-Timestamp: 1762344000
X-Signature: 2b96e0…d41f

200Rapor satırları

{
  "currency": "USD",
  "rows": [
    {
      "key": "2026-11-04",
      "rounds": 18420,
      "players": 1204,
      "bets": 48210.00,
      "wins": 46329.81,
      "ggr": 1880.19,
      "rtp": 96.10
    },
    {
      "key": "2026-11-05",
      "rounds": 19377,
      "players": 1261,
      "bets": 51240.00,
      "wins": 49190.40,
      "ggr": 2049.60,
      "rtp": 96.00
    }
  ]
}

Yanıt alanları

Alan	Tür	Açıklama
currency	ISO 4217	Satırlardaki tutarların para birimi.
rows[].key	string	Grup değeri: group_by=day için gün, game için oyun kodu, site için site kodu, provider için sağlayıcı kodu, currency için işlemin asıl para birimi (tutarlar yine istenen currency’de).
rows[].rounds	integer	Tur sayısı, kapandığı güne göre; boş ve promosyon kredisi turları sayılmaz.
rows[].players	integer	Grupta aralık boyunca oynayan tekil oyuncu sayısı.
rows[].bets	decimal(18,2)	Toplam bahis.
rows[].wins	decimal(18,2)	Toplam kazanç; jackpot kazancı, free round kazancı ve promosyon kredisi hariç.
rows[].ggr	decimal(18,2)	Bahis eksi kazanç; jackpot ve free round kazancı GGR’ı azaltmaz. bets ve wins ile aynı kurla çevrilir: istenen para birimindeki satır çevrilmez, başkası günün kuruyla. ggr her zaman bets − wins’tir (çevrilen tutarda en çok 0,01 yuvarlama farkı); panel raporlarıyla aynı sayı.
rows[].rtp	number \| null	Gerçekleşen RTP, yüzde, iki ondalık, örn. 96.10: (1 − ggr / bets) × 100, aynı toplamlardan. Bahis yoksa null.

Kendi defterinizle karşılaştırma

Operatör defteri işlem tarihine göre tutulur. Bu rapor ise muhasebe tarihine göredir; gün sınırındaki turlar iki tarafta farklı güne düşebilir. Operatör tarafında işlem tarihi için callback’lerdeki created_at alanını kullanın.

Hata kodları

Kod	HTTP	Anlam
INVALID_SIGNATURE	401	İmza doğrulanamadı
TIMESTAMP_SKEW	401	X-Timestamp ±30 sn dışında
IP_NOT_ALLOWED	403	IP izin listesinde değil
SCOPE_MISSING	403	reports.read kapsamı yok
SCOPE_DENIED	403	site_id sizin değil veya anahtarınızın kapsamı dışında
MODULE_DISABLED	403	api modülü kapalı
VALIDATION_ERROR	422	Geçersiz sorgu parametresi
DATE_RANGE_INVALID	422	from, todan önce değil
DATE_RANGE_TOO_LONG	422	Aralık 366 günden uzun (details.max_days)
RATE_LIMITED	429	Hız limiti aşıldı

← ÖncekiJackpot havuzları Sonraki →Diğer uç noktalar