통계
사용 사례
이 엔드포인트들을 사용하여 팀의 집계된 베팅 및 성과 데이터를 조회합니다. 세 가지 뷰를 제공합니다:
- 개요(Overview) — 모든 브랜드 및 프로바이더에 걸친 단일 요약 정보.
- 브랜드별(By Brand) — 브랜드별 분석으로, 브랜드 간 성과 비교에 유용합니다.
- 프로바이더별(By Provider) — 프로바이더별 분석으로, 게임 프로바이더의 기여도 평가에 유용합니다.
세 엔드포인트 모두 start_date와 end_date를 사용한 선택적 날짜 범위 필터를 지원합니다. 날짜 범위 필터는 베팅 기록에만 적용되며, 개요의 플레이어 수 및 브랜드 수는 전체 기간(All-time) 합계를 나타냅니다.
전체 흐름
단계 1 — 개요 통계 조회
GET /api/stats/overview
라이브/슬롯 베팅과 스포츠 베팅을 모두 포함하는 팀 전체의 집계 통계를 반환합니다.
쿼리 파라미터:
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
start_date | string | 아니오 | 날짜 범위 시작일, YYYY-MM-DD 형식 (해당일 포함) |
end_date | string | 아니오 | 날짜 범위 종료일, YYYY-MM-DD 형식 (해당일 포함) |
요청 예시 — 지난 달:
GET /api/stats/overview?start_date=2026-03-01&end_date=2026-03-31
요청 예시 — 전체 기간 (날짜 필터 없음):
GET /api/stats/overview
응답:
{
"data": {
"total_brands": 5,
"active_brands": 4,
"total_players": 18240,
"total_bets": 320500,
"total_bet_amount": "4820000000.00",
"total_payout_amount": "4430000000.00",
"total_win_loss": "-390000000.00",
"total_sports_bets": 45200,
"total_sports_stake": "680000000.00",
"total_sports_payout": "620000000.00",
"total_sports_win_loss": "-60000000.00"
}
}
| 필드 | 설명 |
|---|---|
total_brands | 해당 팀 하위의 전체 브랜드 수 (전체 기간 합계, 날짜 필터 미적용) |
active_brands | status = 1인 브랜드 수 (전체 기간 합계) |
total_players | 전체 등록 플레이어 수 (전체 기간 합계) |
total_bets | 날짜 범위 내 라이브/슬롯 베팅 기록 수 |
total_bet_amount | 라이브/슬롯 베팅의 총 베팅 금액 |
total_payout_amount | 라이브/슬롯 베팅의 총 지급 금액 |
total_win_loss | 라이브/슬롯의 순 GGR: total_bet_amount - total_payout_amount (양수 = 플랫폼 수익) |
total_sports_bets | 날짜 범위 내 스포츠 베팅 기록 수 |
total_sports_stake | 스포츠 베팅의 총 스테이크 금액 |
total_sports_payout | 스포츠 베팅의 총 지급 금액 |
total_sports_win_loss | 스포츠 베팅의 순 GGR |
참고:
total_win_loss는 플랫폼 관점의 순 GGR을 나타냅니다. 음수 값은 해당 기간 동안 플레이어가 베팅 금액보다 더 많이 수령했음을 의미합니다.
단계 2 — 브랜드별 통계 조회
GET /api/stats/by-brand
각 브랜드별 베팅 통계를 분석하여 반환합니다. 가장 높은 성과를 보이는 운영사를 파악하는 데 유용합니다.
쿼리 파라미터: 개요와 동일 — start_date 및 end_date (모두 선택 사항, YYYY-MM-DD 형식).
요청 예시:
GET /api/stats/by-brand?start_date=2026-04-01&end_date=2026-04-06
응답:
{
"items": [
{
"brand_id": 42,
"brand_name": "Ace Casino",
"brand_code": "ace",
"player_count": 8500,
"bet_count": 125000,
"bet_amount": "1950000000.00",
"payout_amount": "1780000000.00",
"win_loss": "-170000000.00",
"sports_bet_count": 18200,
"sports_stake": "275000000.00",
"sports_payout": "252000000.00",
"sports_win_loss": "-23000000.00"
},
{
"brand_id": 43,
"brand_name": "Star Games",
"brand_code": "star",
"player_count": 4100,
"bet_count": 60000,
"bet_amount": "920000000.00",
"payout_amount": "845000000.00",
"win_loss": "-75000000.00",
"sports_bet_count": 8900,
"sports_stake": "130000000.00",
"sports_payout": "119000000.00",
"sports_win_loss": "-11000000.00"
}
]
}
| 필드 | 설명 |
|---|---|
player_count | 해당 브랜드의 전체 등록 플레이어 수 (전체 기간, 날짜 필터 미적용) |
bet_count | 날짜 범위 내 라이브/슬롯 베팅 수 |
bet_amount / payout_amount | 라이브/슬롯 베팅 합계 |
win_loss | 라이브/슬롯의 순 GGR |
sports_bet_count | 날짜 범위 내 스포츠 베팅 수 |
sports_stake / sports_payout | 스포츠 베팅 합계 |
sports_win_loss | 스포츠의 순 GGR |
날짜 범위 내에 베팅이 없는 브랜드도 포함되며, 모든 금액은 "0.00", 건수는 0으로 표시됩니다.
단계 3 — 프로바이더별 통계 조회
GET /api/stats/by-provider
게임 프로바이더별로 그룹화된 베팅 통계를 반환합니다. 선택적으로 brand_id 필터를 사용하여 단일 브랜드로 범위를 좁힐 수 있습니다.
쿼리 파라미터:
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
start_date | string | 아니오 | 날짜 범위 시작일, YYYY-MM-DD 형식 (해당일 포함) |
end_date | string | 아니오 | 날짜 범위 종료일, YYYY-MM-DD 형식 (해당일 포함) |
brand_id | integer | 아니오 | 결과를 단일 브랜드로 제한 |
요청 예시 — 특정 브랜드의 이번 주 프로바이더 성과:
GET /api/stats/by-provider?start_date=2026-03-31&end_date=2026-04-06&brand_id=42
요청 예시 — 모든 프로바이더, 모든 브랜드, 전체 기간:
GET /api/stats/by-provider
응답:
{
"items": [
{
"provider_id": 3,
"provider_code": "evolution",
"bet_count": 98000,
"bet_amount": "1500000000.00",
"payout_amount": "1380000000.00",
"win_loss": "-120000000.00",
"sports_bet_count": 0,
"sports_stake": "0.00",
"sports_payout": "0.00",
"sports_win_loss": "0.00"
},
{
"provider_id": 12,
"provider_code": "betconstruct",
"bet_count": 0,
"bet_amount": "0.00",
"payout_amount": "0.00",
"win_loss": "0.00",
"sports_bet_count": 18200,
"sports_stake": "275000000.00",
"sports_payout": "252000000.00",
"sports_win_loss": "-23000000.00"
}
]
}
결과는 provider_id 기준 오름차순으로 정렬됩니다. 라이브/슬롯 또는 스포츠 중 한쪽에만 활동이 있는 프로바이더는 다른 카테고리의 값이 0으로 표시됩니다.
주요 참고 사항
- 날짜 필터는 시작일과 종료일 모두 포함됩니다.
start_date=2026-03-01&end_date=2026-03-31은 2026-03-01 00:00:00부터 2026-03-31 23:59:59(UTC)까지의 모든 베팅을 포함합니다. - 날짜 형식은
YYYY-MM-DD만 사용합니다. 시간 요소나 타임존 접미사를 포함하지 마십시오. player_count및 브랜드 합계는 전체 기간 수치입니다. 날짜 범위로 필터링되지 않으며, 베팅 및 스포츠 베팅 집계만 날짜 필터의 영향을 받습니다.win_loss필드는 플랫폼 관점을 사용합니다 (양수 = 플랫폼 수익, 음수 = 플랫폼 순지급). 플레이어 손익을 구하려면 값의 부호를 반전하십시오.- 프로바이더별 결과에는 필터링된 범위 내에 최소 하나의 베팅 기록이 있는 프로바이더만 포함됩니다. 허용 목록에 있지만 베팅이 없는 프로바이더는 표시되지 않습니다.
start_date와end_date를 모두 생략하면 전체 기간의 집계 통계를 반환합니다.