Documentation

This document describes the definition and delivery terms of each data item Bonanza Lab provides.

Every data item is organized as Definition followed by Details. Definition explains the concept, the meaning of each component and how the item differs from similar data. Details covers the delivery scope, aggregation basis, update frequency and delivery method. Request parameters, request and response samples and field types are not included here; they are provided separately to authenticated users.

The time conventions, identifiers and delivery methods that apply across this documentation.

• 09:00 KST day boundary Bonanza Lab uses 09:00 Korea Standard Time (KST) as the day boundary. 09:00 KST corresponds to 00:00 UTC, and a day runs from 09:00 on the previous day up to, but not including, 09:00 on the current day.
• Digital asset markets have no open or close, so values aggregated by day — such as open, high, low and cumulative traded value — need an explicit day boundary.
• Every value described in this documentation as being on a 09:00 KST basis refers to this window.

• Trailing 24 hours The trailing 24 hours is the window covering the 24 hours immediately before the time of the request.
• Unlike the current day, whose start is fixed, this window moves with the time of the request, so the two bases return different values.

• Asset ID The Asset ID is the standard identifier Bonanza Lab assigns to each digital asset.
• Exchanges use different symbols for the same asset, and identical symbols sometimes refer to different assets. The Asset ID assigns the same code to the same digital asset regardless of the symbol used.
• Most data items — prices, candles, rankings and indicators — include the Asset ID. Use the Asset ID rather than the symbol when combining data across exchanges or joining different data items.

• Market code A market code combines a digital asset with the quote currency of the market to identify a market pair. For example, KRW-BTC is the market where BTC trades against KRW.
• The same market code on a different exchange has a separate order book, so prices and volumes differ. Exchange-level data is identified by the exchange name together with the market code.

• Unified symbol A unified symbol is the reference symbol representing the same digital asset listed across multiple exchanges, and it may differ from the symbol an individual exchange uses.
• Items calculated by consolidating data from several exchanges are provided by unified symbol rather than by exchange market code. K-VWAP is one such item; the unified symbols and market codes to use in requests are listed in K-VWAP Metadata.

• Delivery Data is delivered over REST API and WebSocket. The REST API returns the value at the time of the request as well as historical data, while WebSocket streams results in real time.
• Where the same data is delivered over both, it is described as a single data item.
• The delivery method, update frequency and maximum number of records per request are stated in the Details of each item.