---
title: "id로 주문 목록 조회"
method: GET
path: "/v1/orders/uuids"
tags: ["Exchange"]
---

# id로 주문 목록 조회

`GET /v1/orders/uuids`

## Request

- Base URL: `https://api.upbit.com`
- URL: `https://api.upbit.com/v1/orders/uuids`
- Auth: none declared

UUID 또는 Identifier 목록으로 주문을 조회합니다.

## Query parameters

- `market` string: 조회하고자 하는 페어(거래쌍)
- `uuids[]` string[]: 조회하고자 하는 주문의 UUID 목록. 조회 가능한 최대 주문 개수는 100개입니다. 2개 이상의 UUID로 조회하는 경우 쿼리 파라미터를 다음과 같이 요청합니다. [예시] uuids[]=uuid1&uuids[]=uuid2…
- `identifiers[]` string[]: 조회하고자 하는 주문의 클라이언트 지정 식별자 목록. 조회 가능한 최대 주문 개수는 100개입니다. 2개 이상의 identifiers로 조회하는 경우 쿼리 파라미터를 다음과 같이 요청합니다. [예시] identifiers[]=id1&identifiers[]=id2…
- `order_by` 'asc' | 'desc': 결과 정렬 방식. 주문 생성 시각을 기준으로 "desc"(내림차순, 최신 주문 순) 또는 "asc"(오름차순, 오래된 주문 순)으로 정렬합니다. 기본값은 "desc"입니다.

## Response `200`

List of orders

- Order[]
  - `market` string, required: 페어(거래쌍)의 코드
  - `uuid` string, required: 주문의 유일 식별자
  - `side` 'ask' | 'bid', required: 주문 방향(매수/매도)
  - `ord_type` 'limit' | 'price' | 'market' | 'best', required: 주문 유형.
  - `price` string, decimal: 주문 단가 또는 총액 지정가 주문의 경우 단가, 시장가 매수 주문의 경우 매수 총액입니다.
  - `state` 'wait' | 'watch' | 'done' | 'cancel', required: 주문 상태 - `wait`: 체결 대기 - `watch`: 예약 주문 대기 - `done`: 체결 완료 - `cancel`: 주문 취소
  - `created_at` string, required: 주문 생성 시각 (KST 기준) [형식] yyyy-MM-ddTHH:mm:ss+09:00
  - `volume` string, decimal: 주문 요청 수량
  - `remaining_volume` string, decimal, required: 체결 후 남은 주문 양
  - `executed_volume` string, decimal, required: 체결된 양
  - `reserved_fee` string, decimal, required: 수수료로 예약된 비용
  - `remaining_fee` string, decimal, required: 남은 수수료
  - `paid_fee` string, decimal, required: 사용된 수수료
  - `locked` string, decimal, required: 거래에 사용 중인 비용
  - `trades_count` integer, required: 해당 주문에 대한 체결 건수
  - `time_in_force` 'fok' | 'ioc' | 'post_only': 주문 체결 옵션
  - `identifier` string: 주문 생성시 클라이언트가 지정한 주문 식별자. * identifier 필드는 2024년 10월 18일 이후 생성된 주문에 대해서만 제공됩니다.
  - `smp_type` 'reduce' | 'cancel_maker' | 'cancel_taker': 자전거래 체결 방지(Self-Match Prevention) 모드
  - `prevented_volume` string, decimal, required: 자전거래 방지로 인해 취소된 수량. 동일 사용자의 주문 간 체결이 발생하지 않도록 설정(SMP)에 따라 취소된 주문 수량입니다.
  - `prevented_locked` string, decimal, required: 자전거래 방지로 인해 해제된 자산. 자전거래 체결 방지 설정으로 인해 취소된 주문의 잔여 자산입니다. - 매수 주문의 경우: 취소된 금액 - 매도 주문의 경우: 취소된 수량
  - `trades` object[]: 체결 목록 (개별 주문 조회 시 반환)
    - `market` string: 페어(거래쌍)의 코드
    - `uuid` string: 체결의 유일 식별자
    - `price` string, decimal: 체결 단가
    - `volume` string, decimal: 체결 수량
    - `funds` string, decimal: 체결 금액
    - `trend` string: 체결 방향 (up/down)
    - `created_at` string: 체결 시각
    - `side` string: 주문 방향

## Other responses

- `400`: error object

---

[API](https://skmtc.dev/upbit/apis/exchange-api.md) - [All operations](https://skmtc.dev/upbit/apis/exchange-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upbit/apis/exchange-api/revisions/150ea50e351c?raw)