👍
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 취소 시 충돌을 일으킨 상대 주문 ID

v2 신규 필드 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	마켓 코드(ex. 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"
}