과거 배당률로 하는 백테스트와 모델링
선택한 북메이커의 마감 배당률을 최종 스코어와 함께 제공합니다. 리그 한 시즌 전체를 몇 번의 요청으로, 또는 이벤트 하나씩, 실시간 배당률에 쓰는 것과 같은 API 키로 가져올 수 있습니다.
최종 업데이트
- 마감 배당률 제공 시작
- 2025년 12월
- 일괄 요청당
- 366일
- 요청당 북메이커 수
- 30
- 요청당 리그 수
- 10
한 달치 마감 배당률을 한 번의 요청으로
/v3/historical/closing-lines는 기간 내 정산 완료된 모든 이벤트를 마감 배당률, 최종 스코어와 함께 반환합니다. 선택한 북메이커의 배당률이 없는 이벤트도 빈 bookmakers 객체와 함께 표시되므로, 배당률이 빠진 것이 경기가 빠진 것처럼 보이지 않습니다.
curl "https://api.odds-api.io/v3/historical/closing-lines?apiKey=YOUR_API_KEY\
&sport=football&leagues=england-premier-league,spain-la-liga\
&from=2026-01-01T00:00:00Z&to=2026-01-31T23:59:59Z\
&markets=ML&bookmakers=Bet365,Unibet&limit=100"[
{
"id": 123456,
"home": "Arsenal",
"away": "Chelsea",
"date": "2026-01-14T20:00:00Z",
"status": "settled",
"league": { "name": "England - Premier League", "slug": "england-premier-league" },
"scores": { "home": 2, "away": 1 },
"bookmakers": {
"Bet365": [
{
"name": "ML",
"updatedAt": "2026-01-14T19:58:12Z",
"odds": [{ "home": "2.10", "draw": "3.40", "away": "3.60" }]
}
]
}
}
]과거 데이터 엔드포인트
과거 데이터 엔드포인트 4개와 라인 변동 엔드포인트 1개가 있습니다. 모든 파라미터는 API 레퍼런스에서 확인할 수 있습니다.
- GET
/v3/ historical/ closing-lines - 여러 이벤트의 마감 배당률을 한 번에 가져옵니다. 최대 10개 리그, 366일, 30개 북메이커, 지정한 마켓까지 지원합니다.유료 플랜
- GET
/v3/ historical/ odds - 종료된 이벤트 하나의 마감 배당률과 최종 스코어를 최대 30개 북메이커까지 가져옵니다.모든 플랜
- GET
/v3/ historical/ events - 한 리그의 정산 완료된 경기와 최종 스코어를 최대 31일 범위로 가져옵니다.모든 플랜
- GET
/v3/ historical/ events/ search - 모든 리그에서 팀 이름으로 정산 완료된 이벤트를 최신순으로 검색합니다.모든 플랜
- GET
/v3/ odds/ movements - 한 마켓의 프리매치 라인 변동으로, 오프닝 배당률, 최신 배당률, 그 사이의 변화를 반환합니다.모든 플랜
세 단계로 한 시즌 다운로드
- 1
리그와 날짜 선택
스포츠 하나, 최대 10개의 리그 slug, 최대 366일의 날짜 범위를 고르면 한 시즌 전체를 한 번에 훑을 수 있습니다.
- 2
마켓과 북메이커 지정
일괄 엔드포인트에서는 markets와 bookmakers가 필수이며, 북메이커는 최대 30개입니다. /v3/bookmakers의 어떤 이름이든 쓸 수 있고, 배당률도 같은 이름으로 돌아옵니다.
- 3
시즌을 페이지별로 가져오기
응답 하나에 정산 완료된 이벤트가 최대 100개 담깁니다. 100개보다 적은 페이지가 돌아올 때까지 skip을 추가하세요. 240경기 시즌이면 요청 세 번으로 충분합니다.
개발자들이 만드는 것
베팅 모델 백테스트
지난 시즌에 모델을 돌려 그 가격을 각 북메이커의 마감 배당률과 비교하세요. 최종 스코어도 같은 응답에 들어 있습니다.
클로징 라인 밸류 측정
내가 잡은 배당률을 마감 배당률과 비교하세요. 변동 이력에서 오프닝 배당률도 알 수 있어, 라인이 얼마나 움직였는지 볼 수 있습니다.
학습용 데이터셋 구축
다섯 개 리그의 한 시즌 마감 배당률을 경기당 한 번씩 약 1,900번 호출하는 대신 약 20번의 요청으로 가져오세요. 데이터프레임에 바로 불러올 수 있는 JSON으로 제공됩니다.
데이터 범위와 한도
이벤트 목록과 일괄 마감 배당률은 정산 완료된 이벤트만 반환합니다. 마켓 이름은 /v3/odds와 같아서 과거 데이터와 실시간 데이터를 같은 키로 연결할 수 있습니다.
- 마감 배당률 이력
- 2025년 12월부터
- 날짜 범위, 일괄 마감 배당률
- 366일
- 날짜 범위, 이벤트와 검색
- 31일
- 일괄 요청당 리그 수
- 10
- 요청당 북메이커 수
- 30
- 일괄 응답당 이벤트 수
- 100개, skip으로 페이지 이동
- 형식
- REST를 통한 JSON
과거 배당률 API 자주 묻는 질문
과거 배당률 데이터는 언제부터 있나요?
마감 배당률은 2025년 12월부터 제공됩니다. 그 이전의 경기와 최종 스코어는 /v3/historical/events에서 계속 받을 수 있지만, 배당률 엔드포인트는 해당 이벤트를 빈 bookmakers 객체로 반환합니다.
한 시즌 전체에는 어떤 엔드포인트를 써야 하나요?
/v3/historical/closing-lines입니다. 요청당 최대 10개 리그와 366일을 받으며, 페이지당 정산 완료된 이벤트를 최대 100개 반환합니다. 다섯 개 리그의 한 시즌을 이벤트 하나씩 가져오면 약 1,900번의 요청이 필요하지만, 일괄 엔드포인트는 약 20번으로 같은 데이터를 반환합니다.
과거 배당률 데이터가 제 플랜에 포함되나요?
/v3/historical/events, /v3/historical/events/search, /v3/historical/odds는 모든 플랜에서 쓸 수 있습니다. /v3/historical/closing-lines는 유료 플랜이 필요합니다. 신규 무료 키 발급이 중단되어 있으므로, 월 £49의 Solo 플랜이 가장 저렴하게 시작하는 방법입니다.
어떤 마켓과 북메이커를 다루나요?
마감 배당률은 저희가 다루는 모든 북메이커와 마켓에 대해 정산 완료된 이벤트별로 저장됩니다. 마켓 이름은 스포츠마다 다릅니다. 대부분 ML, Totals, Spread를 쓰고, 테니스는 Totals (Games)와 Spread (Games)를 쓰며, 야구는 첫 5이닝을 이름에 풀어서 표기합니다. 정확한 이름은 /v3/markets?sport=<sport>로, 한 이벤트에 담긴 전체 데이터는 markets 필터 없이 /v3/historical/odds를 호출해 확인하세요.
라인 변동도 있나요, 아니면 마감 배당률만 있나요?
/v3/odds/movements는 한 마켓 라인의 오프닝 배당률, 최신 배당률, 그 사이의 변화를 반환합니다. 이력은 프리매치만 해당하며 정해진 북메이커 목록에 대해 기록되고, 전체 목록은 문서에 나와 있습니다. 모든 플랜에서 쓸 수 있습니다.
정산되지 않았거나 취소된 경기도 포함되나요?
/v3/historical/events, /v3/historical/events/search, /v3/historical/closing-lines는 정산 완료된 이벤트만 나열하므로, 끝난 경기라도 저희 시스템에서 아직 정산되지 않았다면 표시되지 않습니다. /v3/historical/odds는 이벤트 상태를 반환하니 확인하세요. 취소된 경기를 포함해 모든 이벤트에 대해 명확한 답이 필요하면 Bet Settlement API를 사용하세요.