v1

latestOpenAPI 3.0.12026-07-24510443.1 KB

캔들(OHLCV)

주(Week) 캔들 조회

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

get/candles/weeks

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

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

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

first_day_of_periodstring required

캔들 집계 시작일자

[형식] yyyy-MM-dd

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,
    "first_day_of_period": "2025-06-23"
  }
]