결과를 판정해 주는 베팅 정산 API
보유한 베팅 목록 중 어떤 베팅이 적중했는지 알고 싶다면, 경기, 마켓, 라인, 사이드를 보내세요. 21개 스포츠 172개 마켓에 대해 최종 스코어로 판정한 적중, 미적중, 무효, 절반 적중, 절반 미적중 결과를 받습니다.
- 마켓
- 172
- 스포츠
- 21
- 요청당 베팅 수
- 50
- 엔드포인트
- 2
요청 한 번으로 베팅 3건 정산
이 경기는 90분에 3-2, 연장전 후 3-3으로 끝났습니다. 축구는 90분 기준으로 정산하므로 홈 머니라인은 적중이며, basis에 판정에 사용한 스코어가 표시됩니다.
curl -X POST "https://api.odds-api.io/v3/settlements/grade?apiKey=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"selections": [
{ "ref": "bet-1", "eventId": 74919888, "market": "ML", "side": "home" },
{ "ref": "bet-2", "eventId": 74919888, "market": "Spread", "hdp": -0.75, "side": "home" },
{ "ref": "bet-3", "eventId": 74919888, "market": "Totals", "hdp": 5.5, "side": "over" }
]
}'{
"grades": [
{ "ref": "bet-1", "eventId": 74919888, "result": "won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-2", "eventId": 74919888, "result": "half_won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-3", "eventId": 74919888, "result": "lost", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } }
]
}베팅 정산 방식
엔드포인트는 두 개입니다. GET /v3/settlements는 최대 50개 경기의 결과를 알려 줍니다. POST /v3/settlements/grade는 베팅의 적중 여부를 알려 줍니다.
- 1
베팅 저장
베팅이 접수되면 경기 ID, 마켓, 라인, 사이드를 저장하세요. /v3/odds에서 이미 받는 네 가지 필드와 같으므로 따로 매핑할 필요가 없습니다.
- 2
판정 요청
경기가 끝나면 최대 50개 셀렉션을 /v3/settlements/grade로 POST합니다. 각 셀렉션은 won, lost, void, half_won, half_lost 중 하나로 반환됩니다. 대부분의 스코어 마켓은 판정의 근거가 된 스코어도 함께 반환합니다.
- 3
결과가 확정되면 정산
모든 응답에는 final 플래그가 있습니다. final이 false인 셀렉션은 보관했다가 나중에 다시 보내세요. 1분에 한 번이면 충분합니다.
일곱 가지 응답
저장된 결과로 답을 입증할 수 있을 때만 베팅을 판정합니다. 데이터가 누락되었거나 맞지 않으면 추측 대신 사유와 함께 ungradeable을 반환합니다.
- won
- 베팅 적중
- lost
- 베팅 미적중
- half_won
- 쿼터 라인: 베팅 금액의 절반은 적중, 절반은 반환
- half_lost
- 쿼터 라인: 베팅 금액의 절반은 미적중, 절반은 반환
- void
- 베팅 금액 반환. 사유는 push 또는 event_cancelled
- pending
- 아직 결정되지 않음. 사유에 무엇을 기다리는지 표시
- ungradeable
- 답을 입증할 수 없음. 사유에 그 이유를 표시
누구나 읽을 수 있는 정산 규칙
규칙은 일반적인 북메이커 관행을 따릅니다. 세부 사항은 북메이커마다 다르므로 자사 약관과 비교해 확인하세요.
축구는 90분 기준으로 정산
축구, 풋살, 핸드볼, 럭비 마켓은 정규 시간 기준으로 정산합니다. 경기 스코어에 포함되더라도 연장전과 승부차기는 절대 반영하지 않습니다.
북메이커가 반영하는 경우 연장 포함
농구, 미식축구, 야구, 아이스하키에서는 머니라인, 스프레드, 토탈에 연장전과 연장 이닝이 포함됩니다. 3-Way Result, Double Chance, Draw No Bet, Regulation 토탈과 스프레드는 정규 시간 기준으로 정산합니다.
쿼터 라인은 베팅 금액을 나눔
아시안 핸디캡 -0.75는 절반이 -0.5, 절반이 -1입니다. 홈팀이 1점 차로 이기면 응답은 half_won입니다. 정수 라인에서 정확히 맞아떨어지면 사유 push와 함께 void가 됩니다.
취소된 경기는 무효
취소된 경기의 모든 베팅은 사유 event_cancelled와 함께 void로 반환됩니다. 경기 일정이 다시 잡히면 해당 경기는 같은 ID로 pending 상태로 돌아갑니다.
코너킥과 카드는 경기 통계로 판정
축구의 코너킥, 카드, 선제골 팀은 경기 종료 약 30분 후 경기 통계로 판정합니다. 그 전까지 응답은 사유 awaiting_stats와 함께 pending입니다.
선수 프롭은 박스 스코어로 판정
프롭은 농구, 야구, 아이스하키, 미식축구에서 판정합니다. 선수는 이름으로 매칭하며, 동명이인일 가능성이 있으면 판정하지 않습니다.
21개 스포츠, 172개 마켓
마켓 이름은 /v3/odds가 제공하는 이름과 같습니다. 정산 가이드에서 스포츠별 전체 마켓을 확인할 수 있습니다.
메인 라인
ML, 3-Way Result, Spread 및 아시안 핸디캡, Totals, Team Totals, European Handicap, Double Chance, Draw No Bet, Both Teams To Score, Odd/Even
하프, 쿼터, 이닝
메인 라인의 전반 및 후반 버전, Half Time / Full Time, 농구와 미식축구의 모든 쿼터, 아이스하키의 모든 피리어드, 야구의 First 5 Innings 및 1st Inning 마켓
테니스와 e스포츠
테니스, 배구, 탁구의 게임 핸디캡, 총 게임 수, 선수별 게임 수, 세트 베팅, 세트 핸디캡, 세트 승자, 세트 토탈, 세트 정확한 스코어. e스포츠의 Map Handicap, Total Maps, 맵 승자, 맵별 라운드 및 킬 라인, 스누커의 프레임 라인
축구 통계
코너킥, 카드, 카드 합계, 유효 슈팅, 슈팅, 골키퍼 선방, 오프사이드, 파울과 태클, 코너킥 레이스, 첫 번째와 마지막 코너킥, 첫 번째, 마지막, 두 번째부터 다섯 번째 득점 팀, 정확한 스코어, 승리 점수 차, 정확한 골 수와 팀 골 수, 무실점 승리, 클린시트
선수 프롭
농구, 야구, 아이스하키, 미식축구의 공식 박스 스코어 기반 오버/언더 라인
아직 판정하지 않는 마켓
득점자 마켓, 축구 선수 프롭, 다트 라인, 크리켓, 아웃라이트. 이들은 unsupported_market으로 반환됩니다
베팅이 판정되는 비율
자사 베팅 트래커가 2026년 10월 12일까지 30일 동안 정산한 베팅 22,903건을 이 API로 판정했습니다. 아래는 판정 결과가 반환된 비율입니다.
- 야구, 스코어 마켓
- 99.6%
- 아이스하키, 스코어 마켓
- 99.2%
- 농구, 스코어 마켓
- 99.1%
- 미식축구, 스코어 마켓
- 98.5%
- 축구, 스코어 마켓
- 98.0%
- 축구 카드
- 88.3%
- 축구 코너킥
- 82.4%
이 수치는 참고용으로 보세요. 한 제품의 한 달치 베팅으로, 대부분 축구 메인 마켓이며 이미 한 번 정산된 경기들입니다. 나머지는 사유와 함께 ungradeable로 반환되었습니다.
베팅 정산 API FAQ
API로 베팅을 자동 정산하려면 어떻게 하나요?
베팅이 접수될 때 경기 ID, 마켓, 라인, 사이드를 저장합니다. 경기가 끝나면 이를 Odds-API.io v3 API의 POST /v3/settlements/grade로 보냅니다. 응답은 각 베팅에 대해 won, lost, void, half_won, half_lost 중 하나를 알려 주며, final 플래그로 결과가 확정되었는지 알 수 있습니다.
베팅 정산 API란 무엇인가요?
베팅 정산 API는 보유한 베팅을 받아 그 결과를 알려 주는 API입니다. 경기, 마켓, 라인, 사이드를 보내면 최종 스코어 기준의 결과를 반환합니다. 베팅 트래커, 팁스터 플랫폼, 예측 게임, 스포츠북 백오피스가 마켓과 스포츠마다 판정 규칙을 직접 작성하지 않으려고 사용합니다.
API로 판정할 수 있는 마켓과 스포츠는 무엇인가요?
21개 스포츠의 172개 마켓입니다. 머니라인, 스프레드와 아시안 핸디캡, 토탈, 양 팀 득점, 더블 찬스, 드로 노 벳, 전반 마켓, 테니스 게임과 세트, e스포츠 맵, 축구 코너킥, 카드, 득점 순서, 그리고 농구, 야구, 아이스하키, 미식축구의 선수 프롭을 지원합니다.
쿼터 라인 아시안 핸디캡 베팅도 정산할 수 있나요?
네. Spread로 보내고 라인은 hdp에 넣으세요. 핸디캡은 항상 홈팀 기준입니다. -0.75 같은 쿼터 라인은 베팅 금액의 절반이 반환될 때 half_won 또는 half_lost를 반환하고, 정수 라인에서 정확히 맞아떨어지면 사유 push와 함께 void를 반환합니다.
축구 베팅은 90분 기준인가요, 연장전 이후 기준인가요?
추가 시간을 포함한 90분 기준입니다. 축구, 풋살, 핸드볼, 럭비 베팅은 경기가 연장전이나 승부차기까지 가더라도 정규 시간 기준으로 정산합니다. 대부분의 스코어 마켓은 판정의 근거가 된 스코어도 함께 반환하므로 사용자에게 보여 줄 수 있습니다. Half Time / Full Time, 코너킥, 카드, 선수 프롭은 판정 결과만 반환합니다.
경기가 연기되거나 취소되면 어떻게 되나요?
대부분의 경우 경기 상태가 cancelled로 바뀌고 해당 경기의 모든 베팅은 사유 event_cancelled와 함께 void로 판정됩니다. 경기 일정이 다시 잡히면 해당 경기는 같은 ID로 pending 상태로 돌아갑니다. 끝내 결과가 나오지 않는 경기는 킥오프 72시간 후 사유 result_unavailable과 함께 ungradeable이 됩니다.
경기 후 얼마나 지나야 베팅을 정산할 수 있나요?
스코어 마켓은 보통 경기 종료 몇 분 후에 준비됩니다. 코너킥, 카드, 선수 프롭은 약 30분이 걸립니다. 그 전까지 응답은 pending입니다. final 플래그는 결과가 공식 결과와 대조된 시점, 또는 경기 종료 48시간 후에 true가 됩니다.
정산 API는 어떤 플랜에 포함되나요?
두 정산 엔드포인트는 모든 유료 플랜에서 사용할 수 있으며 호출 1회는 요청 1건으로 계산됩니다. GET /v3/settlements는 최대 50개 경기 ID를, POST /v3/settlements/grade는 최대 50개 셀렉션을 받습니다.