경마 공공데이터 API 활용 가이드 — KRA 데이터로 만드는 것들

경마 공공데이터는 공공데이터포털(data.go.kr)에서 한국마사회(KRA)가 개방한 오픈API로 누구나 무료로 이용할 수 있다. 경주기록, 경주마·기수·조교사 정보, 승식별 확정 배당률 같은 데이터를 REST API로 받아올 수 있고, 회원가입 후 활용신청을 하면 개발단계는 자동승인으로 즉시 인증키가 발급된다. 이 글에서는 2026년 7월 기준으로 KRA API 신청 방법과 주요 엔드포인트, 실전 활용 아이디어를 정리한다.

경마 공공데이터 API란 — 한국마사회가 개방한 데이터

한국마사회는 서울·부산경남·제주 3개 경마장의 시행 데이터를 공공데이터포털을 통해 오픈API로 개방하고 있다. 포털에서 "한국마사회"로 검색하면 경주기록·경주계획·경주마·기수·조교사·배당률 등 200종이 넘는 오픈API가 나온다(2026년 7월 기준 225건). 대부분 REST 방식이며 응답은 JSON과 XML을 모두 지원하고, 이용 요금은 무료다. 경주 결과처럼 갱신이 잦은 데이터는 실시간 주기로 업데이트되는 것으로 명시돼 있다.

KRA API 신청 방법 — 4단계면 끝

1. 회원가입·로그인: 공공데이터포털(data.go.kr)에 가입한다. 오픈API 관련 기능은 PC 환경에서 지원된다.
2. 활용신청: 원하는 API(예: "한국마사회 경주기록 정보")를 검색해 상세 페이지에서 활용신청 버튼을 누르고, 활용 목적을 기재한 뒤 이용약관에 동의한다.
3. 승인: 개발단계는 자동승인으로 즉시 처리되고, 운영단계는 심의승인으로 2~3일 뒤 이메일로 통보된다.
4. 인증키 확인: 마이페이지에서 발급된 인증키(serviceKey)를 확인하고, API 호출 시 파라미터로 넣는다.

트래픽 한도는 공공데이터포털 이용가이드 기준으로 개발계정이 하루 평균 1,000건 규모, 운영계정이 하루 최대 10만 건 수준이다. 다만 실제 한도는 API마다 다르게 명시돼 있어서, 한국마사회 API 상세 페이지에는 개발계정 기준 일 3,000건으로 적힌 경우가 많다. 신청 전에 각 상세 페이지에서 확인하자. 운영계정은 활용사례를 등록하면 트래픽 증량을 신청할 수 있다.

주요 KRA API 엔드포인트 정리

한국마사회 오픈API는 기관 코드 B551015를 쓰는 apis.data.go.kr/B551015 경로 아래에서 제공된다. 예를 들어 마필종합 상세정보는 apis.data.go.kr/B551015/API42 형태다. 자주 쓰이는 API를 용도별로 정리하면 다음과 같다.

호출 방법과 공통 파라미터

발급받은 인증키를 serviceKey 파라미터에 넣어 HTTP GET으로 호출하면 된다. 조회 조건은 API마다 다르지만, 경마장 구분과 경주일자·경주번호가 기본 축이고 페이징 파라미터(pageNo, numOfRows)로 대량 데이터를 나눠 받는다.

• serviceKey: 공공데이터포털에서 발급받은 인증키 (필수)
• 경마장 구분(meet): 1=서울, 2=제주, 3=부산경남
• 조회 조건: 경주일자, 경주번호, 마번·기수번호 등 API별 상이
• 응답 포맷: JSON 또는 XML 선택 가능

경마 API로 무엇을 만들 수 있나

경주기록·출전 정보·배당률이 모두 열려 있으므로 아이디어에 따라 활용 폭이 넓다. 예를 들어 경주계획을 입력으로, 과거 경주기록을 정답으로 삼으면 머신러닝 학습 데이터셋을 구성할 수 있다. 실제로 이런 접근이 어디까지 와 있는지는 AI 경마 예측 서비스 비교 글에서 자세히 다뤘다.

• 경주 결과 대시보드: 경주기록 정보 API로 일자별 결과·기록 시각화
• 기수·조교사 리더보드: 통산과 최근 1년 성적을 비교하는 랭킹 페이지
• 배당률 통계 분석: 확정 배당률 데이터로 승식별 분포·인기마 편향 관찰
• 통념 검증 콘텐츠: 예컨대 부담중량이 정말 성적을 좌우하는지 공개 데이터로 직접 확인
• 예측 모델 실험: 경주계획·출전 정보를 피처로 한 머신러닝 모델링