📘
사전 안내
기존에는 자전거래 가능성이 있을 경우 주문이 접수되지 않았으나, 개선 후에는 주문 접수 후 체결 단계에서 자전거래를 감지해 충돌하는 신규 주문 수량만 취소하도록 개선될 예정입니다. 자세한 내용은 공지사항을 참고하세요(업데이트 일시: 2026년 4월 2일 오후 12시 이후).
응답 항목 "취소 주문 고유 아이디" canceling_uuid, "취소유형" cancel_type이 신규 추가될 예정입니다.

Request

요청은 크게 ticket field, type field, format field 로 분류되며 하나의 요청에 여러 개의 type field 를 명시할 수 있습니다. 자세한 사항은 요청 방법 및 포맷 페이지를 확인해주시기 바랍니다.

Type Field

수신하고 싶은 시세 정보를 나열하는 필드입니다.

필드명

타입

내용

필수 여부

기본 값

type

String

데이터 타입
-myOrder: 내 주문

O

codes

List

마켓 코드 리스트

대문자로 요청해야 합니다.

X

생략하거나 빈 배열로 요청할 경우 모든 마켓에 대한 정보를 수신합니다.

Response

필드명	축약형 (format :SIMPLE)	내용	타입	값
type	ty	타입	String	`myOrder`: 내 주문
code	cd	마켓 코드 (ex. KRW-BTC)	String
client_order_id	coid	사용자 정의 식별 ID	String
uuid	uid	주문 고유 아이디	String
ask_bid	ab	매수/매도 구분	String	`ASK`: 매도 `BID`: 매수
order_type	ot	주문 타입	String	`limit`: 지정가 주문 `price`: 시장가 주문(매수) `market`: 시장가 주문(매도)
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	체결 타임스탬프 (millisecond)	Long
order_timestamp	otms	주문 타임스탬프 (millisecond)	Long
timestamp	tms	타임스탬프 (millisecond)	Long
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,
    "stream_type": "REALTIME"
}