배당 데이터 API
북메이커 10곳·7개 종목·리그 69개의 프리매치 배당을 기계가 읽는 JSON 으로 드립니다. 가입 없이 무료 키로 바로 시작하세요.
- 10
- 북메이커
- 7
- 종목
- 69
- 리그
- 296
- 7일 안 경기
- 3194
- 마감 배당 기록 경기
사이트 화면과 무엇이 다른가요
사이트 화면은 지금처럼 무료이고 추가 지연이 없습니다. API 는 화면에 없는 것을 드립니다.
- 기계용 JSON경기·리그·팀·북메이커를 한 가지 ID 체계로, 북메이커 10곳이 같은 형식
- 한 번에 전부경기마다 모든 북메이커·시장·라인(화면은 고른 표만)
- 줄마다 신선도changed_at · seen_at · age_sec · suspended 로 오래된 값을 기계가 판단
- 바뀐 것만since 커서로 지난 요청 뒤 바뀐 경기만
- 마감 배당 기록 준비 중끝난 경기의 북메이커별 마감 값과 결과
- 자체 배당 준비 중결과로 만든 모델의 확률·공정 배당, 성적표 공개
- 조합·미들·괴리 전체 목록 준비 중다리마다 경과 초와 실제 확인 상태
가격 준비 중
유료 사용은 준비 중입니다. 지금은 무료 단계만 열려 있고, 아래는 예정 가격입니다.
경기를 처음 받을 때 한 번 0.03 USDT. 그 뒤 그 경기는 시작할 때까지 추가 비용 없이 부를 수 있습니다(요청 한도 분당 120회). 한 달 합계는 49 USDT 를 넘지 않습니다. 필터로 줄이 하나도 남지 않은 경기와 배당이 없는 경기는 차감하지 않습니다.
| 상품 | 가격 | 조건 |
|---|---|---|
| 배당(최신) | 0.03 USDT / 경기 | 북메이커 전부·모든 시장·모든 라인, 시작 뒤 마감 배당·결과 포함 · 월 상한 49 USDT · 실측 지연 표 → |
| 자체 배당 | +0.01 USDT / 경기 | 축구 승무패 확률·공정 배당 · 월 상한 9 USDT |
| 조합·미들·괴리 | 5 USDT / 30일 | 전체 목록·필터 · 30일 이용권, 자동 연장 선택 |
| 마감 배당 기록 | 0.01 USDT / 경기 | 끝난 경기의 북메이커별 마감 값(메인 라인) · 월 상한 밖(월 지출 한도에는 포함) |
| 무료 | 0 | 5~10분 늦은 스냅숏 · 메인 라인만 · 하루 20경기 · 시간당 100회 |
| 받을 범위 | 한 달 경기 | 비용 |
|---|---|---|
| 특정 경기 5개 | 5 | 0.15 USDT |
| 세계: 국제친선경기 만 | 약 91 | 약 2.73 USDT |
| 축구 전체 | 약 699 | 약 20.97 USDT |
| 전부 | 약 2240 | 상한 49 USDT |
결제: USDT 선불(BSC·TRON), 최소 충전 10 USDT. 가입 없이 키에 충전합니다.
가격·월 상한을 올리거나 무료·요청 한도를 줄이는 변경은 알린 날부터 7일이 지난 뒤 처음 오는 달 1일부터 적용합니다. 유리한 변경은 바로 적용합니다.
무료 키 받기
이 키는 지금 한 번만 보입니다. 복사해 안전한 곳에 두세요. 잃어버려도 새 무료 키를 받으면 됩니다(같은 IP 에서 하루 3개).
빠른 시작
세 단계: ① 키 받기 ② 범위 고르기(/meta/leagues) ③ /quote 로 비용을 본 뒤 /odds.
export ODDSBUNCH_KEY=obd_... # the key from POST /keys
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/meta/leagues?sport=soccer"
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/quote?league=386"
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/odds?league=386&limit=5&main_only=true&markets=1x2"import os, requests
H = {"Authorization": f"Bearer {os.environ['ODDSBUNCH_KEY']}"}
r = requests.get("https://oddsbunch.com/api/data/v1/odds", params={"league": 386, "limit": 5}, headers=H, timeout=30).json()
print(r["billing"], len(r["data"]))const H = { Authorization: `Bearer ${process.env.ODDSBUNCH_KEY}` };
const r = await (await fetch("https://oddsbunch.com/api/data/v1/odds?league=386&limit=5", { headers: H })).json();
console.log(r.billing, r.data.length);
예시는 키를 환경 변수 ODDSBUNCH_KEY 에서 읽습니다. 키를 코드에 직접 쓰지 마세요.
자체 배당(oddsbunch-model-v1) 준비 중
축구 승무패 확률과 공정 배당(1÷확률). 과거 경기 결과와 선수 기록으로 만든 추정치이며, 북메이커 배당을 옮긴 값이 아닙니다.
응답마다 근거(basis: lineup·time), 경기 전 데이터가 완전한지(pre_complete), 계산 시각(computed_at), 라인업이 바뀌어 다시 계산한 이력이 붙습니다. 완전 여부의 최종 판정(complete)은 경기 뒤에 나옵니다.
실전 성적(2026-10-20 ~ 2026-11-18, 같은 시점 북메이커 합의와 같은 경기로 비교)
| 완전 데이터 348경기 | 뚜렷한 차이 없음 | Brier 차이 +0.0045 ± 0.0059 |
| 불완전 데이터 244경기 | 북메이커보다 나쁨 | Brier 차이 +0.0469 ± 0.0126 |
| 라인업 없이 낸 값(time) 101경기 | 북메이커보다 나쁨 | Brier 차이 +0.0603 ± 0.0215 |
완전 여부는 경기 뒤에 판정합니다 · 경기 전에는 pre_complete 로 표시합니다. 불완전 데이터 경기의 값은 참고용입니다. 성적표는 매일 갱신되며 무료입니다.
가상 픽 수익률(가상 — 실제 베팅 아님): +3.7% · 322픽
AI 에이전트
사람 손을 거의 거치지 않고 붙일 수 있게 만들었습니다.
- OpenAPI 3.1 명세 —
https://oddsbunch.com/api/data/v1/openapi.json - 마크다운 전문(docs.md) —
https://oddsbunch.com/api/data/v1/docs.md - llms.txt
- /quote 는 차감 없이 비용을 계산합니다 — 에이전트가 사람에게 먼저 물어볼 수 있습니다. max_charge·buy=false·월 지출 한도로 쓰는 돈을 서버에서 묶을 수 있습니다.
- 오류마다 다음에 할 일(fix)과 문서 주소(docs)가 붙습니다.
- MCP 서버는 준비 중입니다.
회원 분석글을 AI 에이전트로 쓰는 API 는 따로 있습니다. 공지사항 "API · AI 에이전트" →
자주 묻는 질문
사이트 화면을 프로그램으로 읽어도 되나요?
화면은 사람이 보는 용도이고, 자동 수집은 이용약관에서 금지합니다. 기계로 읽으려면 이 API 를 쓰세요. 무료 키는 지연된 메인 라인부터 시작합니다.
같은 경기를 여러 번 부르면 여러 번 내나요?
(준비 중) 아니요. 경기마다 처음 한 번만 차감하고, 같은 계정의 모든 키가 그 경기를 시작까지(시작 뒤 마감 배당·결과 포함) 공유합니다.
월 상한에 닿으면 어떻게 되나요?
(준비 중) 그 달(UTC 달력 월) 남은 경기의 배당 차감은 없습니다. 전체를 받아도 한 달 49 USDT 를 넘지 않습니다. 상한은 경기가 시작하는 달 기준이라, 다음 달 경기는 다음 달 상한에 듭니다.
잔액이 모자라면요?
(준비 중) 이미 받은 경기는 그대로 주고, 새 경기는 빼고 몇 경기를 못 받았는지(unpaid_matches)와 충전 방법을 함께 알려 드립니다. 몰래 지연 데이터로 바꾸지 않습니다.
충전한 돈을 돌려받을 수 있나요?
(준비 중) 키로 만든 계정의 잔액은 출금할 수 없고 API 사용에만 씁니다(데이터 API 를 끝낼 때의 반환은 예외). 사이트 회원 키는 사이트 출금 규칙을 따릅니다. 수집이 멈춘 동안 그 경기를 샀거나 그 경기가 시작했고, 멈춘 동안 그 경기 배당이 갱신되지 않았다면(멈춘 데이터를 산 경우) 그 차감을 경기 시작 뒤 자동으로 돌려 드리며(자체 배당·마감 기록 제외), 돌려준 경기는 무효가 되고 그 금액은 그 달 상한 계산에서도 빠집니다. 취소된 경기도 자동으로 돌려 드립니다.
데이터는 얼마나 늦나요?
북메이커 갱신에서 우리 반영까지 보통 1분 안팎, 늦으면 몇 분입니다(문서에 종목별 실측 표). 줄마다 age_sec 가 있으니 기준을 정해 거르세요. 무료 키는 5~10분 늦은 스냅숏입니다.
받은 데이터를 다시 팔거나 공개해도 되나요?
값 묶음을 다시 팔거나 넘기는 것은 이용약관 7-2 에서 금지합니다. 자기 분석·결과 화면에 일부 값을 보여 주는 것은 괜찮으며, 이때 출처를 Oddsbunch 로 표기해 주세요. 금지된 사용이 보이면 그 계정의 API 사용을 정지할 수 있습니다.