주문 리스트 조회

get

https://api.bithumb.com/v1/orders

주문 목록을 조회합니다.

📌
입력 규칙

uuids 또는 client_order_ids 두 값을 모두 전달한 경우 uuids를 기준으로 조회하며, 둘 다 전달하지 않은 경우 최신 주문 내역을 조회합니다.

state와 states는 동시에 사용할 수 없습니다.

📘
안내 사항
기존에는 자전거래 가능성이 있을 경우 주문이 접수되지 않았으나, 개선 후에는 주문 접수 후 체결 단계에서 자전거래를 감지해 충돌하는 신규 주문 수량만 취소됩니다. 자세한 내용은 공지사항을 참고하세요.
응답 항목 "자전거래 방지 유형" stp_type이 신규 추가되었으며, 2026년 5월 7일 서비스 배포 이후 요청된 주문에 한하여 stp_type 필드가 필수 출력됩니다.

`ioc`, `fok`, `post_only` 주문의 조회 동작

ioc, fok 주문은 접수 직후 체결 또는 취소로 즉시 처리되므로 state=wait 조회 결과에 포함되지 않습니다. state=done 또는 state=cancel로 조회하세요.
post_only 주문은 Maker 가격으로 등록된 경우에만 state=wait로 조회되며, Taker 가격이면 즉시 취소되어 state=cancel로 조회됩니다.

Query Params

market

string

거래 대상 페어의 고유 심볼

예시) KRW-BTC

state

string

enum

Defaults to wait

주문 상태

wait: 체결 대기(default)
watch: 주문 대기
done: 주문 처리 완료
cancel: 주문 취소

Allowed:

states

array of strings

주문 상태 목록

일반주문(wait, done, cancel)과 자동주문(watch)은 혼합하여 조회하실 수 없습니다.

states

uuids

array of strings

주문 고유 ID 목록(max 100)

uuids

client_order_ids

array of strings

서버에서 부여하는 주문 ID(uuid)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID 목록(max 100)

client_order_ids

page

int32

Defaults to 1

페이지네이션 응답에서 조회할 페이지 번호

limit

int32

Defaults to 100

조회할 주문 개수

order_by

string

enum

Defaults to desc

조회 결과 정렬 방식

asc: 오래된 주문 순
desc: 최신 주문 순(default)

Allowed:

Headers

Responses

입력 규칙

안내 사항

ioc, fok, post_only 주문의 조회 동작

200200

400400

`ioc`, `fok`, `post_only` 주문의 조회 동작