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 | 데이터 타입 - trade: 체결 | O | |
| codes | List | 마켓 코드 리스트 *대문자로 요청해야 합니다. | O | |
| is_only_snapshot | Boolean | 스냅샷 시세만 제공 | X | false |
| is_only_realtime | Boolean | 실시간 시세만 제공 | X | false |
Response
체결시점의 1호가 정보가 추가될 예정입니다.(2024-11-27 예정)
best_ask_price,best_ask_size,best_bid_price,best_bid_size를 통해 최우선 매수/매도 호가와 잔량을 확인하실 수 있습니다.
| 필드명 | 축약형 (format: SIMPLE) | 내용 | 타입 | 값 |
|---|---|---|---|---|
| type | ty | 타입 | String | trade : 체결 |
| code | cd | 마켓 코드 (ex. KRW-BTC) | String | |
| trade_price | tp | 체결 가격 | Double | |
| trade_volume | tv | 체결량 | Double | |
| ask_bid | ab | 매수/매도 구분 | String | ASK : 매도BID : 매수 |
| prev_closing_price | pcp | 전일 종가 | Double | |
| change | c | 전일 대비 | String | RISE : 상승EVEN : 보합FALL : 하락 |
| change_price | cp | 부호 없는 전일 대비 값 | Double | |
| trade_date | td | 체결 일자(UTC 기준) | String | yyyy-MM-dd |
| trade_time | ttm | 체결 시각(UTC 기준) | String | HH:mm:ss |
| trade_timestamp | ttms | 체결 타임스탬프 (millisecond) | Long | |
| timestamp | tms | 타임스탬프 (millisecond) | Long | |
| sequential_id | sid | 체결 번호 (Unique) | Long | |
| best_ask_price | bap | 최우선 매도 호가 | Double | |
| best_ask_size | bas | 최우선 매도 잔량 | Double | |
| best_bid_price | bbp | 최우선 매수 호가 | Double | |
| best_bid_size | bbs | 최우선 매수 잔량 | Double | |
| stream_type | st | 스트림 타입 | String | SNAPSHOT : 스냅샷REALTIME : 실시간 |
*sequential_id 필드는 체결의 유일성 판단을 위한 근거로 쓰일 수 있습니다. 하지만 체결의 순서를 보장하지는 못합니다.
Example
Request
[
{
"ticket": "test example"
},
{
"type": "trade",
"codes": [
"KRW-BTC",
"KRW-ETH"
]
},
{
"format": "DEFAULT"
}
]
Response
{
"type": "trade",
"code": "KRW-BTC",
"timestamp": 1730336862082,
"trade_date": "2024-10-31",
"trade_time": "01:07:42",
"trade_timestamp": 1730336862047,
"trade_price": 100473000.00000000,
"trade_volume": 0.00014208,
"ask_bid": "BID",
"prev_closing_price": 100571000.00000000,
"change": "FALL",
"change_price": 98000.00000000,
"sequential_id": 17303368620470000,
"best_ask_price": 100473000,
"best_ask_size": 0.43139478,
"best_bid_price": 100465000,
"best_bid_size": 0.01990656,
"stream_type": "SNAPSHOT"
}
{
"type": "trade",
"code": "KRW-ETH",
"timestamp": 1730336862120,
"trade_date": "2024-10-31",
"trade_time": "01:07:42",
"trade_timestamp": 1730336862080,
"trade_price": 3700000.00000000,
"trade_volume": 0.02207517,
"ask_bid": "BID",
"prev_closing_price": 3695000.00000000,
"change": "RISE",
"change_price": 5000.00000000,
"sequential_id": 17303368620800006,
"best_ask_price": 3700000,
"best_ask_size": 0.39101775,
"best_bid_price": 3699000,
"best_bid_size": 0.13499454,
"stream_type": "SNAPSHOT"
}