일(Day) 캔들 조회

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

종가 환산 통화(converting_price_unit)

'converting_price_unit' 파라미터를 지정하여 원화 마켓이 아닌 다른 마켓(예시: BTC마켓)의 일 캔들 조회시 종가('trade_price')를 원화로 환산하여 조회할 수 있습니다. 파라미터를 원화('KRW')로 지정하는 경우 converted_trade_price 필드에 원화로 환산된 종가 정보가 반환됩니다. 현재 원화 환산만을 지원하고 있으며, 추후 지원 통화는 추가될 수 있습니다.

캔들은 해당 시간대에 체결이 발생한 경우에만 생성됩니다.
해당 캔들의 시작 시각부터 종료 시각까지 체결이 발생하지 않은 경우 캔들이 생성되지 않으며, 응답에도 포함되지 않습니다. 예를 들어, candle_date_time이 2024-08-31T00:00:00인 일 캔들의 경우 2024-08-31T00:00:00(이상)부터 2024-09-01T00:00:00(미만)까지 체결이 발생하지 않은 경우 생성되지 않습니다.
반영 버전 반영 일자 변경 사항
- 2018-06-21 API 신규 지원
Rate Limit
초당 최대 10회 호출할 수 있습니다. IP 단위로 측정되며 [캔들 그룹] 내에서 요청 가능 횟수를 공유합니다.
Query Params
string
required

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

string

조회 기간의 종료 시각.
지정한 시각 이전 캔들을 조회합니다. 미지정시 요청 시각을 기준으로 최근 캔들이 조회됩니다.

ISO 8601 형식의 datetime으로 아래와 같이 요청 할 수 있습니다. 실제 요청 시에는 공백 및 특수문자가 정상적으로 처리되도록 URL 인코딩을 수행해야 합니다.

[예시]
2025-06-24T04:56:53Z
2025-06-24 04:56:53
2025-06-24T13:56:53+09:00

integer
Defaults to 1

조회하고자 하는 캔들의 개수.
최대 200개의 캔들 조회를 지원하며, 기본값은 1입니다.

string

종가 환산 통화.
종가를 특정 통화로 환산하고자 하는 경우 선택적으로 지정할 수 있습니다. 사용시 응답에 “converted_trade_price” 필드가 추가로 반환됩니다.

[예시] “KRW”로 지정시 원가로 환산된 종가가 반환됨.

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.