This feature is currently available as a beta version.
Candles are only created when a trade occurs during the time frame.
- For example, the first candle with candle_date_time of 2024-08-31T22:25:00 consists of trades between 2024-08-31T22:25:00 (inclusive) and 2024-08-31T22:25:01 (exclusive).
- If there are no trades during the time frame, the 2024-08-31T22:25:00 candle is not created, and no data is sent to the websocket.
Request
Requests are JSON objects, and responses are also JSON objects. Requests are divided into ticket fields, type fields, and format fields. Multiple type fields can be specified in one request. Please refer to the Request method and format for the ticket and format fields.
Request format
[{Ticket Field},{Type Field},....,{Type Field},{Format Field}]
Type Field
List the market data you to receive.
The is_only_snapshot and is_only_realtime fields are optional. If omitted, both snapshot and real-time data will be received.
Field Name | Type | Description | Required | Default |
|---|---|---|---|---|
| type | String | Data type -ย candle.1s: 1s candle | O | |
| codes | List | Market code list *Must be requested in capital letters. | O | |
| is_only_snapshot | Boolean | Only provides snapshot data | X | false |
| is_only_realtime | Boolean | Only provides real-time data | X | false |
Response
- Data transmission interval: 1 second.
The same
candle_date_timedata may be sent multiple times.
- The data transmission interval is not perfectly guaranteed, and candle data for the same period may be sent multiple times.
- The most recent data is always the latest update.
| Field Name | Simplified Format (format: SIMPLE) | Description | Type | Value |
|---|---|---|---|---|
| type | ty | Type | String | candle.1s : 1s candle |
| code | cd | Market code (ex. KRW-BTC) | String | |
| candle_date_time_utc | cdttmu | Candle time (UTC) Format: yyyy-MM-dd'T'HH:mm:ss | String | |
| candle_date_time_kst | cdttmk | Candle time(KST ) Format: yyyy-MM-dd'T'HH:mm:ss | String | |
| opening_price | op | Open price | Double | |
| high_price | hp | High price | Double | |
| low_price | lp | Low price | Double | |
| trade_price | tp | Close price | Double | |
| candle_acc_trade_volume | catv | Accumulated trade price for the candle | Double | |
| candle_acc_trade_price | catp | Accumulated trade quantity for the candle | Double | |
| timestamp | tms | Timestamp (millisecond) | Long | |
| stream_type | st | Stream Type | String | SNAPSHOTREALTIME |
Example
Request
- Receiving 1s candle for
KRW-BTCandKRW-ETH
[
{
"ticket": "test"
},
{
"type": "candle.1s",
"codes": [
"KRW-BTC",
"KRW-ETH"
]
},
{
"format": "DEFAULT"
}
]
Response
{
"type": "candle.1s",
"code": "KRW-BTC",
"candle_date_time_utc": "2025-01-02T04:28:05",
"candle_date_time_kst": "2025-01-02T13:28:05",
"opening_price": 142009000.00000000,
"high_price": 142009000.00000000,
"low_price": 142009000.00000000,
"trade_price": 142009000.00000000,
"candle_acc_trade_volume": 0.00606119,
"candle_acc_trade_price": 860743.5307100000000000,
"timestamp": 1735792085824,
"stream_type": "REALTIME"
}
{
"type": "candle.1s",
"code": "KRW-ETH",
"candle_date_time_utc": "2025-01-02T04:28:05",
"candle_date_time_kst": "2025-01-02T13:28:05",
"opening_price": 5059000.00000000,
"high_price": 5059000.00000000,
"low_price": 5059000.00000000,
"trade_price": 5059000.00000000,
"candle_acc_trade_volume": 0.08158869,
"candle_acc_trade_price": 412757.1827100000000000,
"timestamp": 1735792085749,
"stream_type": "REALTIME"
}