주문 생성 테스트

실제 주문을 생성하지 않고 주문 요청 형식과 주문 가능 여부를 검증합니다.

주문 생성 테스트 API는 실제 주문을 생성하지 않고, 주문 요청 형식과 주문 가능 상태를 사전에 검증할 수 있는 API입니다.

  • 실제 주문 API를 호출하기 전 이 API를 통해 거래 수수료 없이 주문 생성 가능 여부를 테스트하고, 발생 가능한 오류를 사전에 확인할 수 있습니다.
  • 특히 거래소 점검 직후 특정 페어의 주문 가능 상태를 확인하는 용도로 활용할 수 있습니다.
    • 정상 응답이 반환된 경우, 주문 요청의 형식이 올바르고 해당 페어가 현재 주문 가능한 상태임을 의미합니다.
    • 만약 market_offline 오류가 반환된다면 해당 페어는 아직 주문이 불가능한 상태임을 의미합니다.
  • 테스트 주문은 실제 주문과 동일한 검증 과정을 거치지만, 주문이 실제로 생성되지는 않습니다. 따라서 응답으로 반환된 UUID (혹은 identifier)는 주문 조회나 취소 요청에 사용할 수 없습니다.

반영 버전 반영 일자 변경 사항
v1.6.1 2025-10-27 주문 테스트 기능 신규 지원
Rate Limit
초당 최대 8회 호출할 수 있습니다. 포켓 단위로 측정되며 [주문 테스트 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.

API Key Permission
인증이 필요한 API로, [주문하기] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.

Body Params
string
required

주문을 생성하고자 하는 대상 페어(거래쌍)

string
enum
required

주문 방향(매수/매도).
매수 주문을 생성하는 경우 “bid”, 매도 주문을 생성하는 경우 “ask”로 지정합니다.

Allowed:
string

주문 수량.
매수 또는 매도하고자 하는 수량을 숫자 형식의 String으로 입력합니다.

다음 주문 유형에 대해 필수로 입력되어야 합니다.

  • 지정가 매수/매도(ord_type 필드가 “limit”인 경우)
  • 시장가 매도(ord_type 필드가 “market”인 경우)
  • 최유리 지정가 매도(side 필드가 “ask”, ord_type 필드가 “best”인 경우)
string

주문 단가 또는 총액.
디지털 자산 구매에 사용되는 통화(KRW,BTC,USDT)를 기준으로, 숫자 형식의 String으로 입력합니다.

다음 주문 조건에 대해 필수로 입력합니다.

  • 지정가 매수/매도(ord_type 필드가 “limit”인 경우)
  • 시장가 매수(ord_type 필드가 “price”인 경우)
  • 최유리 지정가 매수(side필드가 “bid”, ord_type 필드가 “best”인 경우)

price 필드는 주문 유형에 따라 다른 용도로 사용됩니다.

  • 지정가 주문시 매수/매도 호가로 사용됩니다.
  • 시장가 매수, 최유리 지정가 매수시 매수 총액을 설정하는 용도로 사용됩니다. 주문 시점의 시장가 또는 최유리 지정가로 price 총액을 채우는 수량만큼 매수 주문이 체결됩니다.
string
enum
Defaults to limit

주문 유형.
생성하고자 하는 주문 유형에 따라 아래 값 중 하나를 입력합니다.

  • limit: 지정가 매수/매도 주문
  • price: 시장가 매수 주문
  • market: 시장가 매도 주문
  • best: 최유리 지정가 매수/매도 주문 (time_in_force 필드 설정 필수)
Allowed:
string

클라이언트 지정 주문 식별자.
각 주문에는 사용자 계정의 전체 주문 내에서 유일하게 식별되는 값을 할당해야 하며, 한번 사용한 identifier 값은 해당 주문의 생성,체결 여부와 상관 없이 재사용할 수 없습니다. 최대 길이는 64자입니다.

string
enum

주문 체결 조건.
IOC(Immediate or Cancel), FOK(Fill or Kill), Post Only와 같은 주문 체결 조건을 설정할 수 있습니다.

시장가 주문(ord_type 필드가 "limit")인 경우 모든 옵션을 선택적으로 사용할 수 있습니다. 최유리 지정가 주문(ord_type 필드가 “best”)인 경우 대해 "ioc" 또는 "fok" 중 하나를 필수로 입력합니다. 사용 가능한 값은 다음과 같습니다.

  • ioc: 지정가 조건으로 체결 가능한 수량만 즉시 부분 체결하고, 잔여 수량은 취소됩니다.
  • fok: 지정가 조건으로 주문량 전량 체결 가능할 때만 주문을 실행하고, 아닌 경우 전량 주문 취소합니다.
  • post_only: 지정가 조건으로 부분 또는 전체에 대해 즉시 체결 가능한 상황인 경우 주문을 실행하지 않고 취소합니다. 즉, 메이커(maker)주문으로 생성될 수 있는 상황에서만 주문이 생성되며 테이커(taker) 주문으로 체결되는 것을 방지합니다.
Allowed:
string
enum

자전거래 체결 방지(Self-Match Prevention) 모드.

사용 가능한 값은 다음과 같습니다.

  • cancel_maker: 메이커 주문(이전 주문)을 취소합니다.
  • cancel_taker: 테이커 주문(신규 주문)을 취소합니다.
  • reduce: 기존 주문과 신규 주문의 주문 수량을 줄여 체결을 방지합니다. 잔량이 0인 경우 주문을 취소합니다.
Allowed:
Responses

Language
LoadingLoading…
Response
Choose an example:
application/json
※ This English version is a translation of the original Korean version of the Upbit Developer Center, generated using a third-party tool. In the event of any discrepancies, the Korean version shall take precedence.