Sign in

v1

latestOpenAPI 3.1.02026-07-26420360.1 KB

주문 요청

주문을 요청합니다.

post/orders

Headers

Authorizationstring required

Authorization token (JWT)

Request body

marketstring required

거래 대상 페어의 고유 심볼

예시) KRW-BTC

side'bid' | 'ask' required

주문 종류

  • bid: 매수
  • ask: 매도
pricestring

주문 가격(지정가 주문, 시장가 매수 주문 시 필수)

  • 지정가 주문: 주문 단가
  • 시장가 매수 주문: 주문 총액
volumestring

주문 수량(지정가 주문, 시장가 매도 주문 시 필수)

order_type'limit' | 'price' | 'market' | 'best' required

주문 유형(구 ord_type)

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

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

  • 허용 문자: 영문 대/소문자, 숫자, -, _
  • 길이: 1–36자
time_in_force'ioc' | 'fok' | 'post_only'

주문 처리 조건(현재 원화 마켓에서만 지원)

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

유의사항

  • limit, best 주문에서만 사용할 수 있습니다.
  • limit 주문: 선택 입력, ioc, fok, post_only 사용 가능
  • best 주문: 필수 입력, ioc, fok만 사용 가능

Response

201

order_idstring required

주문의 고유 ID(구 uuid)

marketstring required

거래 대상 페어의 고유 심볼

예시) KRW-BTC

side'bid' | 'ask' required

주문 종류

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

주문 유형(구 ord_type)

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

주문 생성 시각

client_order_idstring

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

stp_type'cancel_taker'

자전거래 방지 처리 유형

  • cancel_taker: 자전거래 감지 시 taker(신규 주문) 취소
time_in_force'ioc' | 'fok' | 'post_only'

주문 처리 조건

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

Example response

{
  "market": "KRW-BTC",
  "side": "bid",
  "order_type": "limit",
  "created_at": "2024-07-14T13:35:41+09:00"
}