get https://api.bithumb.com/v1/candles/days
예시코드는 JavaScript, Python, JAVA에 한해서만 제공합니다.
Request Parameters
필드 | 설명 | 타입 |
---|---|---|
market | 마켓 코드 (ex. KRW-BTC) | String |
to | 마지막 캔들 시각 (exclusive) - ISO8061 포맷 (yyyy-MM-dd'T'HH:mm:ss'Z' 또는 yyyy-MM-dd HH:mm:ss) - 기준 시간 KST - 비워서 요청시 가장 최근 캔들로 반환됨 | String |
count | 캔들 개수(최대 200개까지 요청 가능) | Integer |
convertingPriceUnit | 종가 환산 화폐 단위 (생략할 수 있으며 KRW로 입력한 경우 원화 환산 가격으로 반환됨) | String |
Response
필드 | 설명 | 타입 |
---|---|---|
market | 마켓명 | String |
candle_date_time_utc | 캔들 기준 시각(UTC 기준) 포맷: yyyy-MM-dd'T'HH:mm:ss | String |
candle_date_time_kst | 캔들 기준 시각(KST 기준) 포맷: yyyy-MM-dd'T'HH:mm:ss | String |
opening_price | 시가 | Double |
high_price | 고가 | Double |
low_price | 저가 | Double |
trade_price | 종가 | Double |
timestamp | 캔들 종료 시각(KST 기준) | Long |
candle_acc_trade_price | 누적 거래 금액 | Double |
candle_acc_trade_volume | 누적 거래량 | Double |
prev_closing_price | 전일 종가(UTC 0시 기준) | Double |
change_price | 전일 종가 대비 변화 금액 | Double |
change_rate | 전일 종가 대비 변화량 | Double |
converted_trade_price | 종가 환산 화폐 단위로 환산된 가격 (요청에 convertingPriceUnit 파라미터가 없는 경우 해당 필드는 반환되지 않음) | Double |
convertingPriceUnit
파라미터의 경우, 원화 마켓이 아닌 다른 마켓(ex. BTC, ETH)의 일봉 요청시 종가를 명시된 파라미터 값으로 환산해 converted_trade_price
필드에 추가하여 반환합니다.
현재는 원화(KRW
) 로 변환하는 기능만 제공하며 추후 기능을 확장할 수 있습니다.