스포츠북 API 연동 안내

자체 프론트엔드를 가진 운영사를 위한 배당·베팅 API 구조를 설명합니다.

2026년 10월 5일 업데이트

Nocturn Sport 스포츠북 API는 자체 화면과 지갑을 이미 갖춘 운영사가 배당과 베팅 처리만 가져다 쓸 수 있게 설계되었습니다. 프론트엔드 디자인과 사용자 경험은 운영사가 그대로 유지하고, 가격 계산과 베팅 접수는 우리 쪽 엔진이 맡는 구조입니다.

배당 피드: 스냅샷 다음 델타

연동을 시작하면 클라이언트는 먼저 현재 열린 모든 이벤트와 마켓의 전체 스냅샷을 받습니다. 그 뒤부터는 자신이 마지막으로 받은 버전 번호를 붙여 약 10초 간격으로 요청하고, 서버는 그 이후 바뀐 부분만 델타로 돌려줍니다. 가격 변경, 마켓 중지, 새 이벤트 추가가 모두 이 변경분에 담기므로 트래픽이 가볍고, 버전 번호로 누락 여부를 쉽게 확인할 수 있습니다. 데이터 구조는 배당 피드 안내에서 자세히 다룹니다.

베팅 처리 엔드포인트

• 베팅 접수: 단폴과 다폴더를 받으며, 요청마다 고유 ID를 붙여 네트워크 재시도 시 중복 접수를 막습니다.
• 베팅 내역: 플레이어별 티켓과 상태(진행, 적중, 미적중 등)를 조회합니다.
• 잔액: 플레이어 잔액을 확인해 베팅 가능 여부를 판단합니다.

백오피스 제어

API와 함께 제공되는 백오피스에서 운영사는 특정 이벤트를 중지하고, 원하는 가격을 직접 덮어쓰고, 결과를 정산하고, 현재 노출된 리스크(부채)를 볼 수 있습니다. 최소·최대 배당, 최대 베팅액, 최대 지급액, 티켓당 선택 수 상한, 시작 전 마감 시각, 마진 수준도 운영사가 정합니다. 기본 마감은 경기 시작 1분 전입니다.

현재 범위

피드는 경기 전 배당을 다루며, 경기 중 배당은 개발 단계입니다. 가격은 사내 모델로 직접 계산하므로 별도의 외부 가격 공급 계약이 필요 없습니다. 모델 원리는 자체 배당 페이지를 참고하세요.

데이터 계층 한눈에 보기

피드는 종목 → 대회 → 이벤트 → 마켓 → 결과(아웃컴)의 계층으로 내려오며, 각 아웃컴에 현재 배당이 붙습니다. 운영사는 이 계층을 자기 화면의 메뉴 구조로 그대로 옮길 수 있고, 마켓 상태 값으로 버튼 활성화 여부를 정하면 됩니다. 정산이 끝나면 베팅 내역 엔드포인트에서 결과가 반영된 티켓 상태를 받아 지갑 처리에 연결합니다.

연동 경로와 문의

API는 단독으로도, 카지노 게임과 함께 SoftAggregator 애그리게이터를 거쳐서도 연결할 수 있습니다. 기술 문서와 테스트 환경이 필요하면 문의하기에서 요청하시거나 [email protected] 에 개발 담당자 연락처를 남겨 주세요. 비용은 요청 시 안내합니다.

함께 보면 좋은 페이지