--- title: "페어 체결 이력 조회" method: GET path: "/trades/ticks" tags: ["체결(Trade)"] --- # 페어 체결 이력 조회 `GET /trades/ticks` 지정한 페어의 최근 체결 목록을 조회합니다. ## Query parameters - `market` string, required — 조회하고자 하는 페어(거래쌍) - `to` string — 조회 대상 일자 내 조회 기간의 종료 시각(UTC). 지정한 조회 일자 내에서 특정 시간대의 체결 내역을 조회하고자 하는 경우 선택적으로 사용할 수 있는 파라미터입니다. HHmmss 또는 HH:mm:ss 형식의 시간 포맷으로 입력합니다. 체결 목록이 지정한 시간부터 시간 역순으로 반환됩니다. [예시] days_ago=1&to=130000 으로 조회하는 경우 1일 전(어제) UTC 기준 오후 1시 정각 이전 체결 이력을 최신순으로 반환 - `count` integer — 조회하고자 하는 체결 내역의 개수. 최대 500개 조회를 지원하며 기본 값은 1입니다. - `cursor` string — Pagination을 위한 조회 범위 지정용 커서. 응답에 포함된 체결의 "sequential_id” 값을 이 필드에 입력하여 해당 체결 직전 데이터부터 “count”개의 이전 체결 이력을 이어서 조회할 수 있습니다. - `days_ago` integer — 체결 내역 조회 대상 일자와 요청 시점과의 일 단위 offset. 체결 내역은 체결 일을 지정하여 조회해야 하며 최대 7일의 조회 기간을 지원합니다. 일자 구분은 UTC를 기준으로 합니다. 1 이상 7 이하의 정수형으로 입력합니다. 빈 값으로 입력할 경우, 요청 일자에 발생한 체결 목록을 반환하며, 7을 입력하면 7일 이전에 발생한 체결 목록을 시간 역순(최신 체결 순)으로 반환합니다. ## Response `200` List of trades - object[] - `market` string, required — 페어(거래쌍)의 코드 [예시] "KRW-BTC" - `trade_date_utc` string, required — 체결 일자 (UTC 기준) [형식] yyyy-MM-dd - `trade_time_utc` string, required — 체결 시각 (UTC 기준) [형식] HH:mm:ss - `timestamp` integer, required — 체결 시각의 밀리초단위 타임스탬프 - `trade_price` number, double, required — 최근 체결 가격 - `trade_volume` number, double, required — 최근 거래 수량 - `prev_closing_price` number, double, required — 전일 종가 (UTC 0시 기준) - `change_price` number, double, required — 전일 종가 대비 가격 변화. "trade_price" - "prev_closing_price"로 계산되며, 현재 종가가 전일 종가보다 얼마나 상승 또는 하락했는지를 나타냅니다. - 양수(+): 현재 종가가 전일 종가보다 상승한 경우 - 음수(-): 현재 종가가 전일 종가보다 하락한 경우 - `ask_bid` 'ASK' | 'BID', required — 매수/매도 주문 구분 - `sequential_id` integer, required — 체결의 유일 식별자. 해당 필드는 체결 순서를 보장하지 않습니다. ## Other responses - `400` — error object - `404` — error object --- [API](https://skmtc.net/upbit/apis/quotation-api.md) · [All operations](https://skmtc.net/upbit/apis/quotation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upbit/quotation-api/versions/b8bd8b9ed3b5/schema)