---
title: "다건 주문 조회"
method: POST
path: "/orders/search"
---

# 다건 주문 조회

`POST /orders/search`

주문 ID 목록으로 주문을 조회합니다. 요청당 최대 100건까지 가능합니다.

## Headers

- `Authorization` string, required

## Request body

- object
  - `market` string — 거래 대상 페어의 고유 심볼 예시) KRW-BTC
  - `order_ids` string[] — 주문의 고유 ID 목록(max 100). 체결 ID(`trades[].uuid`)와는 다른 ID 체계이므로 체결 ID로는 조회되지 않습니다.
  - `client_order_ids` string[] — 서버에서 부여하는 주문 ID(`order_id`)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID 목록(max 100)
  - `order_by` 'asc' | 'desc' — 조회 결과 정렬 방식 - `asc`: 오래된 주문 순 - `desc`: 최신 주문 순(default)

## Response `200`

200

- object[]
  - `order_id` string, required — 주문의 고유 ID
  - `side` 'bid' | 'ask', required — 주문 종류 - `bid`: 매수 - `ask`: 매도
  - `order_type` 'limit' | 'price' | 'market' | 'best', required — 주문 유형 - `limit`: 지정가 - `price`: 시장가(매수) - `market`: 시장가(매도) - `best`: 최유리 지정가(현재 원화 마켓에서만 지원)
  - `price` string — 주문 가격
  - `state` 'wait' | 'watch' | 'done' | 'cancel', required — 주문 상태 - `wait`: 체결 대기 - `watch`: 주문 대기 - `done`: 주문 처리 완료 - `cancel`: 주문 취소
  - `market` string, required — 거래 대상 페어의 고유 심볼 예시) KRW-BTC
  - `created_at` string, date-time — 주문 생성 시각
  - `volume` string, required — 주문 수량
  - `remaining_volume` string, required — 미체결 잔여 수량
  - `reserved_fee` string, required — 예약된 수수료. 매수 주문은 기준통화 단위, 매도 주문은 0. 예시) KRW-DOGE는 KRW, BTC-DOGE는 BTC
  - `remaining_fee` string, required — 미사용 예약 수수료. 매수 주문은 기준통화 단위, 매도 주문은 0. 예시) KRW-DOGE는 KRW, BTC-DOGE는 BTC
  - `paid_fee` string, required — 체결 수수료 누적 합계. 기준통화 단위. 예시) KRW-DOGE는 KRW, BTC-DOGE는 BTC
  - `locked` string, required — 거래에 사용 중인 금액. 매수 주문은 기준통화 금액, 매도 주문은 주문통화 수량. 예시) KRW-DOGE 매수는 KRW, 매도는 DOGE
  - `executed_volume` string, required — 체결된 수량
  - `executed_funds` string, required — 체결된 총 금액
  - `trades_count` integer, required — 해당 주문에 걸린 체결 수
  - `client_order_id` string — 서버에서 부여하는 주문 ID(`order_id`)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID. 해당 주문에 `client_order_id` 존재하는 경우 반환
  - `stp_type` 'cancel_taker' — 자전거래 방지 처리 유형 - `cancel_taker`: 자전거래 감지 시 taker(신규 주문) 취소
  - `time_in_force` 'ioc' | 'fok' | 'post_only' — 주문 처리 조건 - `ioc`: 즉시 체결 가능한 수량만 체결하고, 나머지는 취소합니다. - `fok`: 전체 수량이 즉시 체결 가능할 때만 체결하고, 아니면 전량 취소합니다. - `post_only`: 호가창에 등록되는 maker 주문일 때만 허용하며, 즉시 체결될 수 있는 주문일 경우 취소합니다.
  - `cancel_type` 'stp_cancel' | 'user_cancel' | 'admin_cancel' | 'tif_cancel' — 취소 유형 - `stp_cancel`: 자전거래 감지에 의한 취소 - `user_cancel`: 사용자 취소 - `admin_cancel`: 관리자 취소 - `tif_cancel`: 주문 처리 조건에 의한 취소
  - `canceling_order_id` string — `cancel_type`이 `stp_cancel`인 경우, 해당 주문을 취소시킨 반대 주문의 고유 ID

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/bithumb/apis/open-api-public.md) · [All operations](https://skmtc.dev/bithumb/apis/open-api-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bithumb/open-api-public/revisions/9edc2d6e86db/schema)