다건 주문 조회

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

ℹ️

주문 리스트 조회: v1/ordersuuids[] 또는 client_order_ids[] 조회에 해당하며, 조회 성능이 개선되었습니다.

📌

조회 규칙

  • order_ids 또는 client_order_ids하나 이상을 반드시 전달해야 하며, 두 값을 모두 전달한 경우 order_ids를 기준으로 조회합니다.
  • 각 배열은 최대 100건까지 전달 가능합니다.
  • 배열 내 항목이 다음에 해당하는 경우 응답 결과에서 제외됩니다:
    • null, 빈 문자열(""), 공백 문자열
    • 잘못된 형식 또는 타입
    • 존재하지 않거나 본인 계정의 주문이 아닌 ID
    • 체결 ID(trades[].uuid) 등 주문 ID가 아닌 ID
  • 중복된 ID는 1건으로 처리됩니다.
  • 매칭되는 주문이 하나도 없는 경우 빈 배열([])이 반환됩니다.

응답 결과의 개수가 요청한 ID 수보다 적은 경우, 위 조건에 해당하는 ID가 포함되어 있는지 확인해보세요.

Body Params
string

거래 대상 페어의 고유 심볼

예시) KRW-BTC

order_ids
array of strings

주문의 고유 ID 목록(max 100). 체결 ID(trades[].uuid)와는 다른 ID 체계이므로 체결 ID로는 조회되지 않습니다.

order_ids
client_order_ids
array of strings

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

client_order_ids
string
enum
Defaults to desc

조회 결과 정렬 방식

  • asc: 오래된 주문 순
  • desc: 최신 주문 순(default)
Allowed:
Headers
string
required

Authorization token (JWT)

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json