UPupbit
Exchange

종료 주문 목록 조회

종료 주문(Closed Order) 목록을 조회합니다.

get/v1/orders/closed

Request

  • Base URL
    https://api.upbit.com
  • URL
    https://api.upbit.com/v1/orders/closed
  • Auth
    none declared

Query parameters

marketstring

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

Example:KRW-BTC
state'done' | 'cancel'

완료 주문 상태.

  • done: 완전 체결
  • cancel: 취소
states[]ClosedOrderState[]

주문의 상태 (배열 형식). 사용 가능한 값은 "done"(전체 체결 완료), "cancel"(전체 또는 부분 취소)입니다. 미지정시 기본값은 모든 상태(done, cancel)입니다.

[예시] states[]=done&states[]=cancel

start_timestring

조회 기간의 시작 시각. 지정한 시각으로부터 "end_time"까지 생성된 주문을 조회합니다. 최대 조회 범위는 7일입니다.

  • "start_time"만 입력하는 경우 해당 시각 기준으로 이후 7일을 조회합니다.
  • 두 필드 모두 미입력시 요청 시각 기준 이전 7일을 조회합니다.

형식: ISO 8601 (2025-06-24T13:56:53+09:00) 또는 밀리초 타임스탬프 (1750741013000)

Example:2024-12-09T13:56:53+09:00
end_timestring

조회 기간의 종료 시각. "start_time"부터 이 시각까지 생성된 주문을 조회합니다. 최대 조회 범위는 7일입니다.

  • "end_time"만 입력하는 경우 해당 시각 기준으로 이전 7일을 조회합니다.
  • 두 필드 모두 미입력시 요청 시각 기준 이전 7일을 조회합니다.

형식: ISO 8601 (2025-06-24T13:56:53+09:00) 또는 밀리초 타임스탬프 (1750741013000)

Example:2024-12-09T13:56:53+09:00
limitinteger

요청 개수(default: 100, max: 1,000)

Example:1000
order_by'asc' | 'desc'

결과 정렬 방식. "desc"(최신 주문 순) 또는 "asc"(오래된 주문 순). 기본값은 "desc"입니다.

Example:desc

Response

List of closed orders

marketstring required

페어(거래쌍)의 코드

uuidstring required

주문의 유일 식별자

side'ask' | 'bid' required

주문 방향(매수/매도)

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

주문 유형.

pricestring decimal

주문 단가 또는 총액

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

state'done' | 'cancel' required

주문 상태

  • done: 체결 완료
  • cancel: 주문 취소
created_atstring required

주문 생성 시각 (KST 기준)

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

volumestring decimal

주문 요청 수량

remaining_volumestring decimal required

체결 후 남은 주문 양

executed_volumestring decimal required

체결된 양

reserved_feestring decimal required

수수료로 예약된 비용

remaining_feestring decimal required

남은 수수료

paid_feestring decimal required

사용된 수수료

lockedstring decimal required

거래에 사용 중인 비용

trades_countinteger 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 decimal required

자전거래 방지로 인해 취소된 수량.

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

prevented_lockedstring decimal required

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

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

Example response

[
  {
    "market": "KRW-BTC",
    "uuid": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
    "side": "ask",
    "ord_type": "limit",
    "state": "done",
    "created_at": "2025-06-25T15:42:25+09:00",
    "trades_count": 1,
    "time_in_force": "ioc",
    "identifier": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
    "smp_type": "cancel_maker",
    "trades": [
      {
        "market": "KRW-BTC",
        "uuid": "795dff29-bba6-49b2-baab-63473ab7931c",
        "price": "1375",
        "volume": "5.377594",
        "funds": "7394.19175",
        "trend": "down",
        "created_at": "2025-08-09T16:44:00.597751+09:00",
        "side": "ask"
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.