v1

latestOpenAPI 3.1.02026-07-26420360.1 KB

종료 주문 목록 조회

처리 완료(done) 또는 취소(cancel)된 주문 목록을 조회합니다. 조회 기간은 최대 7일로 제한됩니다.

get/orders/history

Query parameters

marketstring

거래 대상 페어의 고유 심볼

예시) KRW-BTC

state'done' | 'cancel'

주문 상태

  • done: 주문 처리 완료
  • cancel: 주문 취소
statesstring[]

주문 상태 목록

  • done: 주문 처리 완료
  • cancel: 주문 취소
start_timestring

조회 시작 시각. 지원 형식:

  • Unix Timestamp 밀리초(권장): 1775401200000
  • ISO 8601 with timezone: 2026-04-06T00:00:00+09:00 (URL에서 +%2B로 인코딩)
end_timestring

조회 종료 시각. start_time과 동일한 형식. start_time 이상이어야 하며, 조회 기간은 최대 7일.

limitinteger

조회할 주문 개수(max 1000)

order_by'asc' | 'desc'

조회 결과 정렬 방식

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

이전 응답에서 반환된 next_key

Headers

Authorizationstring required

Authorization token (JWT)

Response

200

has_nextboolean required

다음 페이지 존재 여부

next_keystring nullable required

다음 페이지 조회 시 next_key 파라미터에 전달합니다. 다음 페이지가 없으면 null