NOCTURN SPORT

스포츠북 API 연동 안내

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

2026년 10월 27일 업데이트

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

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

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

베팅 처리 엔드포인트

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

통화와 암호화폐

플레이어 한 명은 하나의 통화로만 베팅하며, 잔액과 베팅액, 지급액이 모두 그 통화로 처리됩니다. 지원 통화는 모두 73종으로, 법정 통화 60종과 암호화폐 단위 13종으로 이루어져 있습니다. 암호화폐는 USDT, USDC, BTC(mBTC와 SATS 단위 표시 가능), ETH, LTC, TRX, DOGE, SOL, XRP, BNB, TON입니다. 환율은 매시간 갱신됩니다. 운영사가 유로로 정한 베팅 한도는 통화별로 자동 환산되므로, USDT를 쓰는 플레이어와 원화를 쓰는 플레이어에게 같은 수준의 상한이 적용됩니다. 현재 통화 목록은 nocturnsport.com/api/currencies에 공개되어 있습니다.

백오피스 제어

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

현재 범위

피드는 경기 전 배당과 함께 주요 종목의 라이브 배당도 다룹니다. 가격은 Nocturn Sport 모델이 계산하므로 별도의 외부 가격 공급 계약이 필요 없습니다. 모델 원리는 배당 엔진 페이지를 참고하세요.

데이터 계층 한눈에 보기

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

연동 경로와 문의

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

Nocturn Sport의 새 기능

  • 라이브 베팅: 축구, 농구, 테니스, 크리켓
  • 킥오프 전 캐시아웃
  • 선수 마켓
  • 코너, 카드, 경기 기록
  • 풍부한 축구 메뉴
  • 배당 부스트
  • 다른 종목도 더 깊게
  • 무결성 알림
  • 운영사별 설정

모든 마켓과 옵션 보기 →

자주 묻는 질문

델타 피드를 얼마나 자주 호출해야 하나요?

약 10초 간격 호출을 기준으로 설계했습니다. 마지막 버전 번호를 보내면 그 이후 변경분만 받습니다.

같은 베팅이 두 번 접수될 위험은 없나요?

베팅 요청마다 고유 요청 ID를 붙이므로, 재전송된 같은 요청은 중복으로 처리되지 않도록 설계되어 있습니다.

경기 중 배당도 API로 받을 수 있나요?

받을 수 있습니다. 라이브 축구·농구·테니스·크리켓은 같은 피드로 스코어, 경기 시계, 중지 상태와 함께 들어옵니다. 선수, 코너, 카드 같은 세부 마켓은 경기별로 요청 시 제공되며, 라이브 베팅 지연은 운영사마다 따로 정할 수 있습니다.

플레이어가 암호화폐로 베팅할 수 있나요?

네. 스테이블코인, Bitcoin, Ether, Tron, Toncoin 등 주요 코인이 법정 통화와 나란히 제공되며, 연동 방식은 그대로입니다. 플레이어의 통화 코드만 넘기면 나머지는 API가 처리합니다.

API 문서는 어떻게 받나요?

문의 페이지나 [email protected] 으로 요청하시면 담당자가 문서와 연동 절차를 안내해 드립니다. 텔레그램 @mentionso도 가능합니다.

함께 보면 좋은 페이지