Documentation

보난자랩에서 제공하는 데이터 항목의 정의와 제공 기준을 설명하는 문서입니다.

각 데이터 항목은 Definition, Details 순서로 구성됩니다. Definition은 데이터의 개념, 구성 요소의 의미와 유사 데이터와의 차이를 설명하고, Details는 제공 범위, 집계 기준, 갱신 주기와 제공 방식을 설명합니다. 요청 파라미터, 요청·응답 예시와 필드 타입은 본 문서에 포함하지 않으며, 인증된 사용자에게 별도로 제공합니다.

문서 전반에 공통으로 적용되는 시간 기준, 식별 체계와 제공 방식입니다.

• KST 09시 기준 보난자랩은 한국시간(KST) 09시를 일자 변경 기준으로 사용합니다. KST 09시는 협정 세계시(UTC) 00시에 해당하며, 하루는 전일 09시부터 당일 09시 직전까지입니다.
• 디지털자산 시장에는 개장과 폐장이 없으므로, 시가·고가·저가와 누적 거래대금처럼 하루 단위로 집계하는 값에는 별도의 일자 기준이 필요합니다.
• 문서에서 KST 09시 기준으로 표기한 값은 모두 이 구간을 의미합니다.

• 최근 24시간 기준 최근 24시간은 조회 시점부터 직전 24시간을 집계한 구간입니다.
• 기준선이 고정된 당일과 달리 조회 시점에 따라 구간이 이동하므로, 두 기준은 서로 다른 값을 나타냅니다.

• Asset ID Asset ID는 디지털자산을 식별하기 위해 보난자랩이 부여하는 표준 식별코드입니다.
• 거래소마다 같은 자산의 심볼 표기가 다르고, 표기가 같아도 서로 다른 자산을 가리키는 경우가 있습니다. Asset ID는 표기와 무관하게 동일한 디지털자산에 같은 코드를 부여합니다.
• 시세, 캔들, 순위, 지표 등 대부분의 데이터 항목에 Asset ID가 함께 제공됩니다. 여러 거래소의 데이터를 결합하거나 서로 다른 데이터 항목을 연결할 때는 심볼이 아니라 Asset ID를 기준으로 사용합니다.

• 마켓코드 마켓코드는 디지털자산과 마켓 기준 통화를 조합해 마켓페어를 나타내는 코드입니다. 예를 들어 KRW-BTC는 BTC를 KRW로 거래하는 마켓입니다.
• 동일한 마켓코드라도 거래소가 다르면 주문장이 분리되어 가격과 거래량이 다르게 형성됩니다. 거래소별 데이터는 거래소명과 마켓코드를 함께 사용해 식별합니다.

• 통합 심볼 통합 심볼은 여러 거래소에 상장된 동일한 디지털자산을 하나의 표기로 나타내는 기준 심볼이며, 거래소가 사용하는 심볼과 다를 수 있습니다.
• 여러 거래소의 데이터를 종합해 산출하는 항목은 거래소별 마켓코드가 아니라 통합 심볼을 기준으로 제공합니다. K-VWAP이 여기에 해당하며, 조회에 사용할 통합 심볼과 마켓코드는 종목조회(K-VWAP)에서 확인합니다.

• 제공 방식 데이터는 REST API와 WebSocket으로 제공합니다. REST API는 조회 시점의 값과 과거 데이터를, WebSocket은 산출 결과를 실시간으로 제공합니다.
• 동일한 데이터를 두 방식으로 함께 제공하는 경우 하나의 데이터 항목으로 설명합니다.
• 항목별 제공 방식과 갱신 주기, 한 번에 조회할 수 있는 건수는 각 항목의 Details에 표기합니다.