Sign in

v1

latestOpenAPI 3.0.12026-07-24510443.1 KB
캔들(OHLCV)

일(Day) 캔들 조회

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

get/candles/days

Query parameters

marketstring required

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

Example:KRW-BTC
tostring

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

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

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

Example:2024-01-01T00:00:00
countinteger

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

Example:200
converting_price_unitstring

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

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

Example:KRW

Response

List of candles

marketstring required

페어(거래쌍)의 코드

[예시] "KRW-BTC"

candle_date_time_utcstring required

캔들 구간의 시작 시각 (UTC 기준)

[형식] yyyy-MM-dd'T'HH:mm:ss

candle_date_time_kststring required

캔들 구간의 시작 시각 (KST 기준)

[형식] yyyy-MM-dd'T'HH:mm:ss

opening_pricenumber double required

시가. 해당 캔들의 첫 거래 가격입니다.

high_pricenumber double required

고가. 해당 캔들의 최고 거래 가격입니다.

low_pricenumber double required

저가. 해당 캔들의 최저 거래 가격입니다.

trade_pricenumber double required

종가. 해당 페어의 현재 가격입니다.

timestampinteger required

해당 캔들의 마지막 틱이 저장된 시각의 타임스탬프 (ms)

candle_acc_trade_pricenumber double required

해당 캔들 동안의 누적 거래 금액

candle_acc_trade_volumenumber double required

해당 캔들 동안의 누적 거래된 디지털 자산의 수량

prev_closing_pricenumber double required

전일 종가 (UTC 0시 기준)

change_pricenumber double required

전일 종가 대비 가격 변화. "trade_price" - "prev_closing_price"로 계산되며, 현재 종가가 전일 종가보다 얼마나 상승 또는 하락했는지를 나타냅니다.

  • 양수(+): 현재 종가가 전일 종가보다 상승한 경우
  • 음수(-): 현재 종가가 전일 종가보다 하락한 경우
change_ratenumber double required

전일 종가 대비 가격 변화율. ("trade_price" - "prev_closing_price") ÷ "prev_closing_price" 으로 계산됩니다.

  • 양수(+): 가격 상승
  • 음수(-): 가격 하락

[예시] 0.015 = 1.5% 상승

converted_trade_pricenumber double

종가 환산 가격. converted_trade_price 에 요청된 통화 기준으로 환산된 종가입니다.

  • 요청에 converted_trade_price 미포함시, 이 필드는 제공되지 않습니다.
  • 현재는 원화(KRW)로의 변환만 지원합니다.

Example response

[
  {
    "market": "KRW-BTC",
    "candle_date_time_utc": "2025-06-23T14:29:59",
    "candle_date_time_kst": "2025-06-23T23:29:59",
    "opening_price": 142340000,
    "high_price": 142340000,
    "low_price": 142340000,
    "trade_price": 142340000,
    "timestamp": 1750688999123,
    "candle_acc_trade_price": 185042,
    "candle_acc_trade_volume": 0.0013,
    "prev_closing_price": 140908000,
    "change_price": 100000000,
    "change_rate": 5274000,
    "converted_trade_price": 146452359.1
  }
]