์ด ๊ธฐ๋ฅ์ ํ์ฌ ๋ฒ ํ ๋ฒ์ ์ผ๋ก ์ ๊ณต๋ฉ๋๋ค.
์บ๋ค์ ํด๋น ์๊ฐ๋์ ์ฒด๊ฒฐ์ด ๋ฐ์ํ ๊ฒฝ์ฐ์๋ง ์์ฑ๋ฉ๋๋ค.
- candle_date_time์ด 2024-08-31T22:25:00์ธ ์ด๋ด ์บ๋ค์ 2024-08-31T22:25:00 (์ด์) ~ 2024-08-31T22:25:01 (๋ฏธ๋ง) ์ฌ์ด์ ์ฒด๊ฒฐ๋ก ๊ตฌ์ฑ๋ฉ๋๋ค.
- ํด๋น ์๊ฐ ๋์ ์ฒด๊ฒฐ์ด ์์ ๊ฒฝ์ฐ, 2024-08-31T22:25:00 ์บ๋ค์ ์์ฑ๋์ง ์์ผ๋ฉฐ ์น์์ผ์ผ๋ก ๋ฐ์ดํฐ๊ฐ ๋ด๋ ค๊ฐ์ง ์์ต๋๋ค.
Request
์์ฒญ์ JSON Object๋ฅผ ์ด์ฉํ๋ฉฐ ์๋ต ๋ํ JSON Object ์ ๋๋ค. ์์ฒญ์ ํฌ๊ฒ ticket field, type field, format field ๋ก ๋๋์ด์ง๋ฉฐ ํ๋์ ์์ฒญ์ ์ฌ๋ฌ ๊ฐ์ type field ๋ฅผ ๋ช ์ํ ์ ์์ต๋๋ค. ticket field ์ format field ์ ๋ํด์๋ ์์ฒญ ๋ฐฉ๋ฒ ๋ฐ ํฌ๋งท์ ์ฐธ๊ณ ํด์ฃผ์๊ธฐ ๋ฐ๋๋๋ค.
Request format
[{Ticket Field},{Type Field},....,{Type Field},{Format Field}]
Type Field
์์ ํ๊ณ ์ถ์ ์์ธ ์ ๋ณด๋ฅผ ๋์ดํ๋ ํ๋์
๋๋ค.
is_only_snapshot, is_only_realtime ํ๋๋ ์๋ต ๊ฐ๋ฅํ๋ฉฐ ๋ชจ๋ ์๋ต์ ์ค๋
์ท๊ณผ ์ค์๊ฐ ๋ฐ์ดํฐ ๋ชจ๋๋ฅผ ์์ ํฉ๋๋ค.
ํ๋๋ช
| ํ์
| ๋ด์ฉ | ํ์ ์ฌ๋ถ | ๊ธฐ๋ณธ ๊ฐ |
|---|---|---|---|---|
| type | String | ๋ฐ์ดํฐ ํ์
-ย candle.1s: ์ด๋ด | O | |
| codes | List | ๋ง์ผ ์ฝ๋ ๋ฆฌ์คํธ *๋๋ฌธ์๋ก ์์ฒญํด์ผ ํฉ๋๋ค. | O | |
| is_only_snapshot | Boolean | ์ค๋ ์ท ์์ธ๋ง ์ ๊ณต | X | false |
| is_only_realtime | Boolean | ์ค์๊ฐ ์์ธ๋ง ์ ๊ณต | X | false |
Response
- ๋ฐ์ดํฐ ์ ์ก ์ฃผ๊ธฐ: 1์ด
๊ฐ์ candle_date_time ๋ฐ์ดํฐ๊ฐ ์ฌ๋ฌ ๋ฒ ๋ด๋ ค๊ฐ ์ ์์ต๋๋ค.
- ๋ฐ์ดํฐ ์ ์ก ์ฃผ๊ธฐ๋ฅผ ์๋ฒฝํ๊ฒ ๋ณด์ฅํ์ง ์์ผ๋ฉฐ, ๊ฐ์ ์๊ฐ๋์ ์บ๋ค ๋ฐ์ดํฐ๊ฐ ์ฌ๋ฌ ๋ฒ ๋ด๋ ค๊ฐ ์ ์์ต๋๋ค.
- ๊ฐ์ฅ ๋ง์ง๋ง ๋ฐ์ดํฐ๊ฐ ๊ฐ์ฅ ์ต์ ๋ฐ์ดํฐ ์ ๋๋ค.
| ํ๋๋ช | ์ถ์ฝํ (format: SIMPLE) | ๋ด์ฉ | ํ์ | ๊ฐ |
|---|---|---|---|---|
| type | ty | ํ์ | String | candle.1s : ์ด๋ด |
| code | cd | ๋ง์ผ ์ฝ๋ (ex. KRW-BTC) | String | |
| candle_date_time_utc | cdttmu | ์บ๋ค ๊ธฐ์ค ์๊ฐ(UTC ๊ธฐ์ค) ํฌ๋งท: yyyy-MM-dd'T'HH:mm:ss | String | |
| candle_date_time_kst | cdttmk | ์บ๋ค ๊ธฐ์ค ์๊ฐ(KST ๊ธฐ์ค) ํฌ๋งท: yyyy-MM-dd'T'HH:mm:ss | String | |
| opening_price | op | ์๊ฐ | Double | |
| high_price | hp | ๊ณ ๊ฐ | Double | |
| low_price | lp | ์ ๊ฐ | Double | |
| trade_price | tp | ์ข ๊ฐ | Double | |
| candle_acc_trade_volume | catv | ๋์ ๊ฑฐ๋ ๊ธ์ก | Double | |
| candle_acc_trade_price | catp | ๋์ ๊ฑฐ๋๋ | Double | |
| timestamp | tms | ํ์์คํฌํ (millisecond) | Long | |
| stream_type | st | ์คํธ๋ฆผ ํ์ | String | SNAPSHOT : ์ค๋
์ทREALTIME : ์ค์๊ฐ |
Example
Request
KRW-BTC,KRW-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"
}