내 주문 및 체결 (MyOrder)

📘

Private 타입 endpoint

새롭게 추가된 myOrdermyAsset 타입의 경우 wss://api.upbit.com/websocket/v1/private 으로 요청하셔야 합니다. 자세한 내용은 기본 정보 를 참고해주시기 바랍니다.

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

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

필드명
타입
내용
필수 여부
기본 값
typeString데이터 타입
myOrder: 내 주문
O
codesList마켓 코드 리스트
*대문자로 요청해야 합니다.
X생략하거나 빈 배열로 요청할 경우 모든 마켓에 대한 정보를 수신합니다.

Response

필드명
축약형 (format: SIMPLE)
내용
타입
typety타입StringmyOrder : 내 주문
codecd마켓 코드 (ex. KRW-BTC)String
uuiduid주문 고유 아이디String
ask_bidab매수/매도 구분StringASK : 매도
BID : 매수
order_typeot주문 타입Stringlimit: 지정가 주문
price: 시장가 매수 주문
market: 시장가 매도 주문
best: 최유리 지정가 주문
states주문 상태Stringwait: 체결 대기
watch: 예약 주문 대기
trade: 체결 발생
done: 전체 체결 완료
cancel: 주문 취소
trade_uuidtuid체결의 고유 아이디String
pricep주문 가격,
체결 가격 (state: trade 일 때)
Double
avg_priceap평균 체결 가격Double
volumev주문량,
체결량 (state: trade 일 때)
Double
remaining_volumerv체결 후 남은 주문 양Double
executed_volumeev체결된 양Double
trades_counttc해당 주문에 걸린 체결 수Integer
reserved_feersf수수료로 예약된 비용Double
remaining_feermf남은 수수료Double
paid_feepf사용된 수수료Double
lockedl거래에 사용중인 비용Double
executed_fundsef체결된 금액Double
time_in_forcetifIOC, FOK 설정Stringioc
fok
trade_feetf체결 시 발생한 수수료
(trade 타입이 아닐 경우 null 값)
Double
is_makerim체결이 발생한 주문의 maker / taker 여부
(trade 타입이 아닐 경우 null 값)
Booleantrue : 메이커 주문
false : 테이커 주문
identifierid조회용 사용자 지정값

*identifier 필드는 2024-10-18 이후에 생성된 주문에 대해서만 제공합니다.
String
trade_timestampttms체결 타임스탬프 (millisecond)Long
order_timestampotms주문 타임스탬프 (millisecond)Long
timestamptms타임스탬프 (millisecond)Long
stream_typest스트림 타입StringREALTIME : 실시간

Example

Request

예제 1. 모든 마켓 정보 수신 (codes 필드 제외)

[
  {
    "ticket": "test-myOrder"
  },
  {
    "type": "myOrder"
  }
]

예제 2. 모든 마켓 정보 수신 (codes 에 빈 배열)

[
  {
    "ticket": "test-myOrder"
  },
  {
    "type": "myOrder",
    "codes": []
  }
]

예제 3. 특정 마켓 정보 수신

[
  {
    "ticket": "test-myOrder"
  },
  {
    "type": "myOrder",
    "codes": ["KRW-BTC"]
  }
]

Response

{
  "type": "myOrder",
  "code": "KRW-BTC",
  "uuid": "ac2dc2a3-fce9-40a2-a4f6-5987c25c438f",
  "ask_bid": "BID",
  "order_type": "limit",
  "state": "trade",
  "trade_uuid": "68315169-fba4-4175-ade3-aff14a616657",
  "price": 0.001453,
  "avg_price": 0.00145372,
  "volume": 30925891.29839369,
  "remaining_volume": 29968038.09235948,
  "executed_volume": 30925891.29839369,
  "trades_count": 1,
  "reserved_fee": 44.23943970238218,
  "remaining_fee": 21.77177967409916,
  "paid_fee": 22.467660028283017,
  "locked": 43565.33112787242,
  "executed_funds": 44935.32005656603,
  "time_in_force": null,
  "trade_fee": 22.467660028283017,
  "is_maker": true,
  "identifier": "test-1",
  "trade_timestamp": 1710751590421,
  "order_timestamp": 1710751590000,
  "timestamp": 1710751597500,
  "stream_type": "REALTIME"
}