분(Minute) 캔들 조회

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

분캔들 조회 단위(Unit)

분 캔들 조회 API는 Unit Path 파라미터를 지원합니다. Unit은 분단위 내에서 캔들 하나당 조회 단위(캔들의 너비)를 지정하기 위한 파라미터 입니다. 현재 1, 3, 5, 10, 15, 30, 60, 240분 단위로 캔들 너비를 조정할 수 있으며, 예를 들어 /v1/candles/minutes/5 로 요청하는 경우 체결 정보를 5분 단위로 Group하여 캔들을 조회합니다.

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

분(Minute) 캔들 단위
캔들 단위를 지정하여 캔들 조회를 할 수 있습니다.
최대 240분(4시간) 캔들까지 조회할 수 있습니다.

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입니다.

Responses

Language
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.