---
title: "일(Day) 캔들 조회"
method: GET
path: "/candles/days"
tags: ["캔들(OHLCV)"]
---

# 일(Day) 캔들 조회

`GET /candles/days`

일 단위 캔들 목록을 조회합니다.

## Query parameters

- `market` string, required — 조회하고자 하는 페어(거래쌍)
- `to` string — 조회 기간의 종료 시각. 지정한 시각 이전 캔들을 조회합니다. 미지정시 요청 시각을 기준으로 최근 캔들이 조회됩니다. ISO 8601 형식의 datetime으로 아래와 같이 요청 할 수 있습니다. 실제 요청 시에는 공백 및 특수문자가 정상적으로 처리되도록 URL 인코딩을 수행해야 합니다. [예시] 2025-06-24T04:56:53Z 2025-06-24 04:56:53 2025-06-24T13:56:53+09:00
- `count` integer — 조회하고자 하는 캔들의 개수. 최대 200개의 캔들 조회를 지원하며, 기본값은 1입니다.
- `converting_price_unit` string — 종가 환산 통화. 종가를 특정 통화로 환산하고자 하는 경우 선택적으로 지정할 수 있습니다. 사용시 응답에 “converted_trade_price” 필드가 추가로 반환됩니다. [예시] “KRW”로 지정시 원가로 환산된 종가가 반환됨.

## Response `200`

List of candles

- object[]
  - `market` string, required — 페어(거래쌍)의 코드 [예시] "KRW-BTC"
  - `candle_date_time_utc` string, required — 캔들 구간의 시작 시각 (UTC 기준) [형식] yyyy-MM-dd'T'HH:mm:ss
  - `candle_date_time_kst` string, required — 캔들 구간의 시작 시각 (KST 기준) [형식] yyyy-MM-dd'T'HH:mm:ss
  - `opening_price` number, double, required — 시가. 해당 캔들의 첫 거래 가격입니다.
  - `high_price` number, double, required — 고가. 해당 캔들의 최고 거래 가격입니다.
  - `low_price` number, double, required — 저가. 해당 캔들의 최저 거래 가격입니다.
  - `trade_price` number, double, required — 종가. 해당 페어의 현재 가격입니다.
  - `timestamp` integer, required — 해당 캔들의 마지막 틱이 저장된 시각의 타임스탬프 (ms)
  - `candle_acc_trade_price` number, double, required — 해당 캔들 동안의 누적 거래 금액
  - `candle_acc_trade_volume` number, double, required — 해당 캔들 동안의 누적 거래된 디지털 자산의 수량
  - `prev_closing_price` number, double, required — 전일 종가 (UTC 0시 기준)
  - `change_price` number, double, required — 전일 종가 대비 가격 변화. "trade_price" - "prev_closing_price"로 계산되며, 현재 종가가 전일 종가보다 얼마나 상승 또는 하락했는지를 나타냅니다. - 양수(+): 현재 종가가 전일 종가보다 상승한 경우 - 음수(-): 현재 종가가 전일 종가보다 하락한 경우
  - `change_rate` number, double, required — 전일 종가 대비 가격 변화율. ("trade_price" - "prev_closing_price") ÷ "prev_closing_price" 으로 계산됩니다. - 양수(+): 가격 상승 - 음수(-): 가격 하락 [예시] 0.015 = 1.5% 상승
  - `converted_trade_price` number, double — 종가 환산 가격. converted_trade_price 에 요청된 통화 기준으로 환산된 종가입니다. - 요청에 converted_trade_price 미포함시, 이 필드는 제공되지 않습니다. - 현재는 원화(KRW)로의 변환만 지원합니다.

## 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/revisions/b8bd8b9ed3b5/schema)