내 주문 및 체결(MyOrder) v1

내 주문 및 체결 v1 응답 스펙(Deprecated). v2와 동시 운영 후 종료 예정.

Deprecated — Private WebSocket v1 응답 스펙
v1은 v2와 한시적으로 동시 제공되며 추후 종료 예정입니다. 종료 일정 변경에 대한 자세한 내용은 Private WebSocket v1 지원 종료 일정 연기 안내 공지를 확인하세요.

신규 구현: 내 주문 및 체결(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`	마켓 코드(예: 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"
}