Sign in

v1

latestOpenAPI 3.0.12026-07-24510443.1 KB
주문(Order)

체결 대기 주문 목록 조회

체결 대기 중인 주문(Open Orders) 목록을 조회합니다.

get/orders/open

Query parameters

marketstring

조회하고자 하는 페어(거래쌍)

Example:KRW-BTC
state'wait' | 'watch'

주문의 상태. 지정한 상태의 주문만을 조회하기 위한 필터 파라미터입니다. 사용 가능한 값은 “wait”(체결 대기), “watch”(예약 주문 대기)입니다. 미지정시 기본값은 “wait”입니다.

states[]string[]

주문의 상태. 지정한 상태의 주문만을 조회하기 위한 필터 파라미터입니다. 배열 형식이며 사용 가능한 값은 “wait”(체결 대기), “watch”(예약 주문 대기)입니다. 미지정시 기본값은 “wait”입니다.

[예시] states[]=wait&states[]=watch

pageinteger

조회할 페이지 번호. Pagination을 위한 파라미터로, 조회하고자 하는 페이지를 지정할 수 있습니다. 미지정시 기본값은 1입니다.

Example:1
limitinteger

요청 개수(default: 100, max: 100) 요청 당 조회할 주문 개수를 지정합니다. 한번에 최대 100개의 항목을 조회할 수 있으며, 미지정시 기본값은 100입니다.

Example:100
order_by'asc' | 'desc'

결과 정렬 방식. 주문 생성 시각을 기준으로 설정한 방식에 따라 정렬된 주문 목록이 반환됩니다. 사용 가능한 값은 “desc”(내림차순, 최신 주문 순) 또는 “asc”(오름차순, 오래된 주문 순)입니다. 기본값은 “desc”입니다.

Example:desc

Response

List of open orders

marketstring required

페어(거래쌍)의 코드

[예시] "KRW-BTC"

uuidstring required

주문의 유일 식별자

side'ask' | 'bid' required

주문 방향(매수/매도)

ord_type'limit' | 'price' | 'market' | 'best' required

주문 유형.

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

주문 단가 또는 총액 지정가 주문의 경우 단가, 시장가 매수 주문의 경우 매수 총액입니다.

state'wait' | 'watch' required

주문 상태

  • wait: 체결 대기
  • watch: 예약 주문 대기
created_atstring required

주문 생성 시각 (KST 기준)

[형식] yyyy-MM-ddTHH:mm:ss+09:00

volumestring

주문 요청 수량

remaining_volumestring required

체결 후 남은 주문 양

executed_volumestring required

체결된 양

executed_fundsstring required

현재까지 체결된 금액

reserved_feestring required

수수료로 예약된 비용

remaining_feestring required

남은 수수료

paid_feestring required

사용된 수수료

lockedstring required

거래에 사용 중인 비용

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

주문 체결 옵션

identifierstring

주문 생성시 클라이언트가 지정한 주문 식별자.

  • identifier 필드는 2024년 10월 18일 이후 생성된 주문에 대해서만 제공됩니다.
smp_type'reduce' | 'cancel_maker' | 'cancel_taker'

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

prevented_volumestring required

자전거래 방지로 인해 취소된 수량. 동일 사용자의 주문 간 체결이 발생하지 않도록 설정(SMP)에 따라 취소된 주문 수량입니다.

prevented_lockedstring required

자전거래 방지로 인해 해제된 자산. 자전거래 체결 방지 설정으로 인해 취소된 주문의 잔여 자산입니다.

  • 매수 주문의 경우: 취소된 금액
  • 매도 주문의 경우: 취소된 수량
trades_countinteger required

해당 주문에 대한 체결 건수

Example response

[
  {
    "market": "KRW-BTC",
    "uuid": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
    "side": "ask",
    "ord_type": "limit",
    "state": "wait",
    "created_at": "2025-06-25T15:42:25+09:00",
    "time_in_force": "ioc",
    "identifier": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
    "smp_type": "cancel_maker",
    "trades_count": 1
  }
]