Bonanza Lab

Data Guide

Overview

Bonanza Lab processes raw data from domestic and international digital asset exchanges, digital asset media and research firms, and communities, and provides a wide range of information through API/WS, ASP, and more. All data with an identifiable source is provided under official data license agreements; for domestic exchanges in particular, a separate license application is required to provide the purpose of data use, company information, and other details.

This document describes the overall structure, definitions, use cases, and delivery standards of the datasets provided by Bonanza Lab; the API Reference for development is provided separately upon contract.

How to Get Started

  1. 1

    Scoping the Data

    Decide the scope, term, and other details of the data license agreement with our sales team.

  2. 2

    License Application

    When using exchange data, a license application may be filed in parallel.

  3. 3

    Contract Signing

    Sign the service agreement.

  4. 4

    Token Issuance and Usage

    Use the ClientId and ClientSecret provided by our engineering team to obtain an access token and start using the service.

Delivery Methods

  • Data is provided via REST API and WebSocket. The REST API consists of requests and responses and is mainly used to query point-in-time values or historical data. WebSocket is a streaming method that receives computed results in real time while maintaining a connection to the Bonanza Lab server.
  • Responses are provided in JSON format.
  • If you need historical data beyond a certain period, it is provided through access to separate storage after prior consultation.
  • The rate limit policy applies to the REST API and WebSocket per token issued to each customer. Please refer to the Rate Limits page for details.

Authentication

  • The Bonanza Lab API uses the OAuth 2.0 Client Credentials flow (2-legged authentication). You obtain an Access Token by calling the token API (/token) directly, without a separate user authentication step.
  • When requesting a token, set the grant type (grant_type) to client_credentials and the scope (scope) to oob.
  • The issued Access Token is in JWT format. The response includes the token type, expiration period (in seconds), JWT unique identifier, and scope along with the token.
  • The token validity period is determined by agreement at the time of contract.

Common Data Delivery Standards

Historical Data

Bonanza Lab's official data delivery start date is January 1, 2024. Exchange chart data is available from 2022 for pre-2024 history; for the historical coverage of other data, please contact us separately.

Day Boundary

Because digital assets trade 24 hours a day, 365 days a year, each exchange provides market data based on a different reference time. Bonanza Lab standardizes the day boundary to 09:00 KST (00:00 UTC). Accordingly, one day for daily-aggregated data runs from 09:00:00 KST to 08:59:59 the next day.

Ticker Code Management

Digital assets have no unique standard ticker code. Exchanges generally provide a symbol (e.g., BTC) or a market code (e.g., KRW-BTC) as a unique key, but the same asset may have different symbols across exchanges, or different assets may share the same symbol. In addition, when a rebrand or a rights event occurs, each exchange reflects it at a different time, making ticker master management difficult.

To provide standardized metadata, Bonanza Lab assigns a unique Asset ID to each digital asset. Using the Asset ID as the reference when combining or linking data from multiple exchanges allows you to manage tickers efficiently.

Customer Support

  • Bonanza Lab closely monitors the delivery environment, including per-customer call volume and network status, through an internal monitoring system. For immediate incident response and smooth communication, we open a Slack channel with each customer and, backed by a 24/7 support system, help resolve issues quickly.
NextDigital Asset Metadata