v1

latestOpenAPI 3.1.02026-07-26420360.1 KB

주(Week) 캔들 조회

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

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

get/candles/weeks

Query parameters

marketstring required

거래 대상 페어의 고유 심볼

예시) KRW-BTC

tostring

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

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

countinteger

조회할 캔들 개수(max 200)

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 int64

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

candle_acc_trade_pricenumber double

캔들 기간 중 누적 거래 금액

candle_acc_trade_volumenumber double

캔들 기간 중 누적 거래량

first_day_of_periodstring date

캔들 기간의 시작일

Example response

[
  {
    "market": "KRW-BTC",
    "candle_date_time_utc": "2018-04-16T00:00:00",
    "candle_date_time_kst": "2018-04-16T09:00:00",
    "opening_price": 8665000,
    "high_price": 8840000,
    "low_price": 8360000,
    "trade_price": 8611000,
    "candle_acc_trade_price": 466989414916.13,
    "candle_acc_trade_volume": 54410.56660813,
    "first_day_of_period": "2018-04-16"
  }
]