---
title: "주문 요청"
method: POST
path: "/orders"
---

# 주문 요청

`POST /orders`

주문을 요청합니다.

## Headers

- `Authorization` string, required

## Request body

- object
  - `market` string, required — 거래 대상 페어의 고유 심볼 예시) KRW-BTC
  - `side` 'bid' | 'ask', required — 주문 종류 - `bid`: 매수 - `ask`: 매도
  - `price` string — 주문 가격(지정가 주문, 시장가 매수 주문 시 필수) - 지정가 주문: 주문 단가 - 시장가 매수 주문: 주문 총액
  - `volume` string — 주문 수량(지정가 주문, 시장가 매도 주문 시 필수)
  - `order_type` 'limit' | 'price' | 'market' | 'best', required — 주문 유형(구 `ord_type`) - `limit`: 지정가 - `price`: 시장가(매수) - `market`: 시장가(매도) - `best`: 최유리 지정가(현재 원화 마켓에서만 지원)
  - `client_order_id` string — 서버에서 부여하는 주문 ID(`order_id`)와 별도로 주문 생성 시 사용자가 직접 지정하는 고유 ID - 허용 문자: 영문 대/소문자, 숫자, -, _ - 길이: 1–36자
  - `time_in_force` 'ioc' | 'fok' | 'post_only' — 주문 처리 조건(현재 원화 마켓에서만 지원) - `ioc`: 즉시 체결 가능한 수량만 체결하고, 나머지는 취소합니다. - `fok`: 전체 수량이 즉시 체결 가능할 때만 체결하고, 아니면 전량 취소합니다. - `post_only`: 호가창에 등록되는 maker 주문일 때만 허용하며, 즉시 체결될 수 있는 주문일 경우 취소합니다. **유의사항** - `limit`, `best` 주문에서만 사용할 수 있습니다. - `limit` 주문: 선택 입력, `ioc`, `fok`, `post_only` 사용 가능 - `best` 주문: 필수 입력, `ioc`, `fok`만 사용 가능

## Response `201`

201

- object
  - `order_id` string, required — 주문의 고유 ID(구 `uuid`)
  - `market` string, required — 거래 대상 페어의 고유 심볼 예시) KRW-BTC
  - `side` 'bid' | 'ask', required — 주문 종류 - `bid`: 매수 - `ask`: 매도
  - `order_type` 'limit' | 'price' | 'market' | 'best', required — 주문 유형(구 `ord_type`) - `limit`: 지정가 - `price`: 시장가(매수) - `market`: 시장가(매도) - `best`: 최유리 지정가(현재 원화 마켓에서만 지원)
  - `created_at` string, date-time, required — 주문 생성 시각
  - `client_order_id` string — 서버에서 부여하는 주문 ID(`order_id`)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID
  - `stp_type` 'cancel_taker' — 자전거래 방지 처리 유형 - `cancel_taker`: 자전거래 감지 시 taker(신규 주문) 취소
  - `time_in_force` 'ioc' | 'fok' | 'post_only' — 주문 처리 조건 - `ioc`: 즉시 체결 가능한 수량만 체결하고, 나머지는 취소합니다. - `fok`: 전체 수량이 즉시 체결 가능할 때만 체결하고, 아니면 전량 취소합니다. - `post_only`: 호가창에 등록되는 maker 주문일 때만 허용하며, 즉시 체결될 수 있는 주문일 경우 취소합니다.

## 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)