내 주문 및 체결 v1 응답 스펙(Deprecated). v2와 동시 운영 후 종료 예정.
Deprecated — Private WebSocket v1 응답 스펙
v1은 v2와 한시적으로 동시 제공되며 2026년 9월 30일 종료 예정입니다.
- 신규 구현: 내 주문 및 체결(MyOrder) v2를 사용하세요.
- 마이그레이션: Private v2 마이그레이션 가이드에서 전체 변경 사항을 확인하세요.
v1에 최근 추가된 응답 값
order_type:best(최유리 지정가)cancel_type:tif_cancel(주문 조건에 의한 취소),stp_cancel(자전거래 감지에 의한 취소)canceling_uuid: STP 취소 시 충돌을 일으킨 상대 주문 IDv2 신규 필드
time_in_force는 v1에 추가되지 않습니다. 주문 처리 조건이 필요하면 v2로 마이그레이션하세요.
Request
요청은 ticket, type, format 필드로 구성됩니다. 자세한 사항은 요청 방법 및 포맷을 참고하세요.
Type Field
수신하고 싶은 시세 정보를 나열하는 필드입니다.
| 필드명 | 타입 | 내용 | 필수 여부 | 기본 값 |
|---|---|---|---|---|
type | String | 데이터 타입 • myOrder: 내 주문 | O | |
codes | List | 마켓 코드 리스트 • 대문자로 요청해야 합니다. | X | 생략하거나 빈 배열로 요청할 경우 모든 마켓에 대한 정보를 수신합니다. |
Response
| 필드명 | 축약형(format: SIMPLE) | 내용 | 타입 | 값 |
|---|---|---|---|---|
type | ty | 타입 | String | myOrder: 내 주문 |
code | cd | 마켓 코드(예: KRW-BTC) | String | |
uuid | uid | 주문 고유 아이디 | String | |
client_order_id | coid | 사용자 정의 식별 ID | String | |
ask_bid | ab | 매수/매도 구분 | String | ASK: 매도BID: 매수 |
order_type | ot | 주문 타입 | String | limit: 지정가 주문price: 시장가 주문(매수)market: 시장가 주문(매도)best: 최유리 지정가 |
state | s | 주문 상태 | String | wait: 체결 대기trade: 체결 발생done: 전체 체결 완료cancel: 주문 취소 |
trade_uuid | tuid | 체결의 고유 아이디 | String | |
price | p | 주문 가격, 체결 가격( state: trade일 때) | Double | |
volume | v | 주문량, 체결량( state: trade일 때) | Double | |
remaining_volume | rv | 체결 후 남은 주문 양 | Double | |
executed_volume | ev | 체결된 양 | Double | |
trades_count | tc | 해당 주문에 걸린 체결 수 | Double | |
reserved_fee | rsf | 수수료로 예약된 비용 | Double | |
remaining_fee | rmf | 남은 수수료 | Double | |
paid_fee | pf | 사용된 수수료 | Double | |
executed_funds | ef | 체결된 금액 | Double | |
trade_timestamp | ttms | 체결 타임스탬프(milliseconds) | Long | |
order_timestamp | otms | 주문 타임스탬프(milliseconds) | Long | |
timestamp | tms | 타임스탬프(milliseconds) | Long | |
canceling_uuid | cuid | 자전거래 취소인 경우, 해당 주문을 취소시킨 반대 주문 고유 아이디 | String | |
cancel_type | ct | 취소 유형 | String | stp_cancel: 자전거래 감지에 의한 취소user_cancel: 사용자 취소admin_cancel: 관리자 취소tif_cancel: 주문 조건에 의한 취소 |
stream_type | st | 스트림 타입 | String | REALTIME: 실시간 |
Example
Request
- 모든 마켓 정보 수신
[
{
"ticket": "test example"
},
{
"type": "myOrder",
"codes": []
}
]- 특정 마켓 정보 수신
[
{
"ticket": "test example"
},
{
"type": "myOrder",
"codes": ["KRW-BTC"]
}
]Response
{
"type": "myOrder",
"code": "KRW-BTC",
"client_order_id": "my-client-order-id-1",
"uuid": "C0101000000001818113",
"ask_bid": "BID",
"order_type": "limit",
"state": "trade",
"trade_uuid": "C0101000000001744207",
"price": 1927000,
"volume": 0.4697,
"remaining_volume": 0.0803,
"executed_volume": 0.4697,
"trades_count": 1,
"reserved_fee": 0,
"remaining_fee": 0,
"paid_fee": 0,
"executed_funds": 905111.9000,
"trade_timestamp": 1727052318148,
"order_timestamp": 1727052318074,
"timestamp": 1727052318369,
"canceling_uuid": "",
"cancel_type": "stp_cancel",
"stream_type": "REALTIME"
}