Data Guide
이용안내
보난자랩은 국내· 외 디지털자산 거래소, 디지털자산 전문 언론사 및 리서치 기업, 커뮤니티 등의 원천데이터를 기반으로 가공을 거쳐 다양한 정보를 API/WS, ASP 등을 통해 제공하고 있습니다. 출처가 존재하는 모든 데이터는 정식 데이터 라이선스 계약을 기반으로 관련 데이터를 제공하고 있으며, 특히 국내 거래소의 경우 별도의 라이선스 신청을 통해 데이터 사용목적과 기업정보 등을 제공받도록 규정하고 있습니다.
본 문서는 보난자랩에서 제공하는 데이터셋의 전반적인 구성과 정의,활용방안,제공기준 등을 설명하며 개발을 위한 API Reference는 계약 시 별도로 제공합니다.
이용절차
- 1
데이터 제공범위 협의
영업팀과 데이터 이용계약을 위한 범위, 기간 등을 결정합니다.
- 2
라이선스 신청
거래소 데이터 이용 시 라이선스 신청을 병행할 수 있습니다.
- 3
계약 체결
서비스 이용계약을 체결합니다.
- 4
인증토큰 발급 및 이용
개발팀에서 제공하는 ClientId와 ClientSecret으로 인증토큰을 발급받아 서비스를 이용합니다.
제공 방식
- 데이터는 REST API와 WebSocket으로 제공합니다. REST API는 요청(Request)과 응답(Response)으로 구성되며, 조회 시점의 값이나 과거 데이터를 조회할 때 주로 사용합니다. WebSocket은 보난자랩 서버와 연결을 유지한 상태에서 산출 결과를 실시간으로 수신하는 스트리밍 방식입니다.
- 응답 데이터는 JSON 형식으로 제공합니다.
- 일정 기간 이상의 과거 데이터가 필요한 경우, 사전 협의를 거쳐 별도 스토리지에 접근하는 방식으로 제공합니다.
- 호출제한 정책은 고객사에 발급된 토큰 단위로 REST API와 WebSocket에 적용됩니다. 자세한 내용은 호출제한정책 페이지에서 확인하실 수 있습니다.
인증 방식
- 보난자랩 API는 OAuth 2.0의 Client Credentials 방식(2-legged 인증)을 사용합니다. 별도의 사용자 인증 절차 없이 토큰 발급 API(
/token)를 바로 호출하여 Access Token을 발급받습니다. - 토큰을 요청할 때 권한부여 방식(
grant_type)은client_credentials로, 권한 범위(scope)는oob로 지정합니다. - 발급된 Access Token은 JWT 형식입니다. 응답에는 토큰과 함께 토큰 유형, 만료 기간(초 단위), JWT 고유식별자, 권한 범위가 포함됩니다.
- 토큰 유효기간은 계약 시 협의하여 정합니다.
데이터 제공 관련 공통 기준
과거 데이터 제공
보난자랩의 공식 데이터 제공 시작일은 2024년 1월 1일입니다. 거래소별 차트 데이터는 2024년 이전의 과거 데이터를 2022년부터 제공하며, 그 외 데이터의 과거 제공 범위는 별도로 문의해 주시기 바랍니다.
일자전환시각
디지털자산은 24시간 365일 거래되므로, 거래소마다 서로 다른 기준 시각으로 마켓 데이터를 제공합니다. 보난자랩은 KST 09시(UTC 00시)를 일자 변경 기준으로 통일하여 제공합니다. 따라서 일 단위로 집계하는 데이터의 1일은 KST 09:00:00부터 익일 08:59:59까지입니다.
종목코드 관리
디지털자산에는 고유한 표준 종목코드가 없습니다. 거래소는 일반적으로 심볼(예: BTC)이나 마켓코드(예: KRW-BTC)를 고유 키로 제공하지만, 같은 종목이라도 거래소마다 심볼이 다르거나 서로 다른 종목인데 심볼이 같은 경우가 있습니다. 또한 리브랜딩이나 권리 이벤트가 발생하면 거래소마다 반영 시점이 달라 종목 마스터 관리가 어렵습니다.
보난자랩은 표준화된 메타데이터를 제공하기 위해 디지털자산마다 고유한 Asset ID를 부여합니다. 여러 거래소의 데이터를 결합하거나 연결할 때 Asset ID를 기준으로 하면 종목을 효율적으로 관리할 수 있습니다.
고객지원
- 보난자랩은 내부 모니터링 시스템으로 고객사별 호출 현황과 네트워크 등 제공 환경을 면밀하게 모니터링하고 있습니다. 즉각적인 장애 대응과 원활한 커뮤니케이션을 위해 고객사와 Slack 채널을 개설하여 소통하며, 24시간 365일 지원 체계를 바탕으로 문제를 빠르게 해결할 수 있도록 지원합니다.