Sign in

v1

latestOpenAPI 3.1.02026-07-26420360.1 KB

개별 주문 조회

개별 주문 내역을 조회합니다.

get/order

Query parameters

uuidstring

주문의 고유 ID

client_order_idstring

서버에서 부여하는 주문 ID(uuid)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID

  • 허용 문자: 영문 대/소문자, 숫자, -, _
  • 길이: 1–36자

Headers

Authorizationstring required

Authorization token (JWT)

Response

200

uuidstring required

주문의 고유 ID

client_order_idstring

서버에서 부여하는 주문 ID(uuid)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID

side'bid' | 'ask' required

주문 종류

  • bid: 매수
  • ask: 매도
ord_type'limit' | 'price' | 'market' | 'best' required

주문 유형

  • limit: 지정가
  • price: 시장가(매수)
  • market: 시장가(매도)
  • best: 최유리 지정가(현재 원화 마켓에서만 지원)
pricestring required

주문 가격

state'wait' | 'watch' | 'done' | 'cancel' required

주문 상태

  • wait: 체결 대기
  • watch: 주문 대기
  • done: 주문 처리 완료
  • cancel: 주문 취소
marketstring required

거래 대상 페어의 고유 심볼

예시) KRW-BTC

created_atstring date-time required

주문 생성 시각

volumestring required

사용자가 입력한 주문 수량

remaining_volumestring required

체결 후 남은 주문 수량

reserved_feestring required

예약된 수수료. 매수 주문은 기준통화 단위, 매도 주문은 0.

예시) KRW-DOGE는 KRW, BTC-DOGE는 BTC

remaining_feestring required

미사용 예약 수수료. 매수 주문은 기준통화 단위, 매도 주문은 0.

예시) KRW-DOGE는 KRW, BTC-DOGE는 BTC

paid_feestring required

체결 수수료 누적 합계. 기준통화 단위.

예시) KRW-DOGE는 KRW, BTC-DOGE는 BTC

lockedstring required

거래에 사용 중인 금액. 매수 주문은 기준통화 금액, 매도 주문은 주문통화 수량.

예시) KRW-DOGE 매수는 KRW, 매도는 DOGE

executed_volumestring required

체결된 수량

executed_fundsstring required

체결된 총 금액

trades_countinteger required

해당 주문의 체결 건수

stp_type'cancel_taker'

자전거래 방지 처리 유형

  • cancel_taker: 자전거래 감지 시 taker(신규 주문) 취소
cancel_type'stp_cancel' | 'user_cancel' | 'admin_cancel' | 'tif_cancel'

취소 유형

  • stp_cancel: 자전거래 감지에 의한 취소
  • user_cancel: 사용자 취소
  • admin_cancel: 관리자 취소
  • tif_cancel: 주문 처리 조건에 의한 취소
canceling_uuidstring

cancel_type이 stp_cancel인 경우, 해당 주문을 취소시킨 반대 주문의 고유 ID

time_in_force'ioc' | 'fok' | 'post_only'

주문 처리 조건

  • ioc: 즉시 체결 가능한 수량만 체결하고, 나머지는 취소합니다.
  • fok: 전체 수량이 즉시 체결 가능할 때만 체결하고, 아니면 전량 취소합니다.
  • post_only: 호가창에 등록되는 maker 주문일 때만 허용하며, 즉시 체결될 수 있는 주문일 경우 취소합니다.

Example response

{
  "uuid": "C0101000000001799231",
  "side": "bid",
  "ord_type": "limit",
  "price": "83000000",
  "state": "done",
  "market": "KRW-BTC",
  "created_at": "2024-07-09T16:32:23+09:00",
  "volume": "1",
  "remaining_volume": "0",
  "reserved_fee": "207500",
  "remaining_fee": "0",
  "paid_fee": "207500",
  "locked": "0",
  "executed_volume": "1",
  "trades_count": 1,
  "trades": [
    {
      "market": "KRW-BTC",
      "uuid": "C0101000000001713006",
      "price": "83000000",
      "volume": "1",
      "funds": "83000000",
      "side": "bid",
      "created_at": "2024-07-09T16:32:23+09:00"
    }
  ]
}