v1

latestOpenAPI 3.1.02026-07-26420360.1 KB

일(Day) 캔들 조회

지정한 거래 페어의 일 단위 캔들 데이터를 조회합니다.

응답 데이터는 시간 내림차순(최신 → 과거)으로 정렬됩니다.

get/candles/days

Query parameters

marketstring required

거래 대상 페어의 고유 심볼

예시) KRW-BTC

tostring

조회 기준 시각(KST). 해당 시각의 캔들은 제외되며, 미입력 시 가장 최근 캔들 기준으로 조회합니다.

형식) yyyy-MM-dd HH:mm:ss 또는 yyyy-MM-ddTHH:mm:ss

countinteger

조회할 캔들 개수(max 200)

convertingPriceUnitstring

원화 마켓이 아닌 다른 마켓의 일봉 요청 시, 종가를 지정한 화폐 단위로 환산하여 converted_trade_price 필드로 반환.

현재는 KRW만 지원합니다.

Response

200

marketstring

거래 대상 페어의 고유 심볼

예시) KRW-BTC

candle_date_time_utcstring date-time

캔들 기준 시각(UTC)

candle_date_time_kststring date-time

캔들 기준 시각(KST)

opening_pricenumber double

시가

high_pricenumber double

고가

low_pricenumber double

저가

trade_pricenumber double

종가

timestampstring

캔들 기간 중 발생한 마지막 거래 시각(Unix timestamp, Unit: ms)

candle_acc_trade_pricenumber double

캔들 기간 중 누적 거래 금액

candle_acc_trade_volumenumber double

캔들 기간 중 누적 거래량

prev_closing_pricenumber double

전일 종가(UTC 0시 기준)

change_pricenumber double

전일 종가 대비 변화 금액

change_ratenumber double

전일 종가 대비 변화율

converted_trade_pricenumber double

환산된 종가(convertingPriceUnit 요청 시 반환)

Example response

[
  {
    "market": "KRW-BTC",
    "candle_date_time_utc": "2018-04-18T00:00:00",
    "candle_date_time_kst": "2018-04-18T09:00:00",
    "opening_price": 8450000,
    "high_price": 8679000,
    "low_price": 8445000,
    "trade_price": 8626000,
    "candle_acc_trade_price": 107184005903.687,
    "candle_acc_trade_volume": 12505.93101659,
    "prev_closing_price": 8450000,
    "change_price": 176000,
    "change_rate": 0.0208284024
  }
]