페어 체결 이력 조회

지정한 페어의 최근 체결 목록을 조회합니다.

반영 버전 반영 일자 변경 사항
- 2020-07-17 조회 기간 7일로 확대 지원
Rate Limit
초당 최대 10회 호출할 수 있습니다. IP 단위로 측정되며 [체결 그룹] 내에서 요청 가능 횟수를 공유합니다.
Query Params
string
required

조회하고자 하는 페어(거래쌍)

string

조회 대상 일자 내 조회 기간의 종료 시각(UTC).
지정한 조회 일자 내에서 특정 시간대의 체결 내역을 조회하고자 하는 경우 선택적으로 사용할 수 있는 파라미터입니다.

HHmmss 또는 HH:mm:ss 형식의 시간 포맷으로 입력합니다. 체결 목록이 지정한 시간부터 시간 역순으로 반환됩니다.

[예시] days_ago=1&to=130000 으로 조회하는 경우 1일 전(어제) UTC 기준 오후 1시 정각 이전 체결 이력을 최신순으로 반환

integer
Defaults to 1

조회하고자 하는 체결 내역의 개수.
최대 500개 조회를 지원하며 기본 값은 1입니다.

string

Pagination을 위한 조회 범위 지정용 커서.
응답에 포함된 체결의 "sequential_id” 값을 이 필드에 입력하여 해당 체결 직전 데이터부터 “count”개의 이전 체결 이력을 이어서 조회할 수 있습니다.

integer

체결 내역 조회 대상 일자와 요청 시점과의 일 단위 offset.
체결 내역은 체결 일을 지정하여 조회해야 하며 최대 7일의 조회 기간을 지원합니다. 일자 구분은 UTC를 기준으로 합니다.

1 이상 7 이하의 정수형으로 입력합니다. 빈 값으로 입력할 경우, 요청 일자에 발생한 체결 목록을 반환하며, 7을 입력하면 7일 이전에 발생한 체결 목록을 시간 역순(최신 체결 순)으로 반환합니다.

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json
※ This English version is a translation of the original Korean version of the Upbit Developer Center, generated using a third-party tool. In the event of any discrepancies, the Korean version shall take precedence.