get
https://api.bithumb.com/public/candlestick/_/
시간 및 구간별 빗썸 거래소 가상자산 가격, 거래량 정보를 제공합니다.
응답 개수 정책 변경 안내
count쿼리 파라미터가 추가되어 응답 개수를 직접 지정할 수 있습니다(최대 200개).- 2026년 7월 21일부터
count미입력 시 기본 응답 개수가 모든 봉에 대해 200개로 통일됩니다.- 기존에
count없이 호출하던 코드는 응답 개수가 줄어들 수 있습니다.→ 자세히 보기
Path 파라미터(
order_currency,payment_currency,chart_intervals)의 값을 지정하지 않아도 기본값(BTC/KRW/24h)으로 동작합니다.
Request Parameters
| 파라미터 | 위치 | 타입 | 설명 |
|---|---|---|---|
| order_currency | path | String | 주문 통화(예: BTC) |
| payment_currency | path | String | 결제 통화(예: KRW) |
| chart_intervals | path | String | 1m 3m 5m 10m 15m 30m 1h 4h 6h 12h 24h 1w 1MM |
| count | query | Integer | 조회할 캔들 개수(양의 정수, 최대 200). 미입력 시 봉별 기본 응답 개수를 반환합니다. |
count 파라미터 상세
count 파라미터의 입력 값에 따라 응답 개수가 달라집니다.
동작
| 요청 | 현재 | 2026년 7월 21일 이후 |
|---|---|---|
count 미입력 | 봉별 기본 응답 개수 반환 | 200개 |
count=N (1 ≤ N ≤ 200) | N개 반환 | N개 반환 |
count=N (N > 200) | 200개 반환 | 200개 반환 |
count=(빈 값) | 에러 반환 | 에러 반환 |
| 유효하지 않은 값(음수, 문자 등) | 에러 반환 | 에러 반환 |
봉별 기본 응답 개수(count 미입력 시)
| 봉 | 기본 응답 개수 |
|---|---|
| 1m / 3m / 5m / 10m / 15m / 30m | 3,000개 |
| 1h / 4h / 6h / 12h | 5,000개 |
| 24h / 1w / 1MM | 보유한 전체 데이터 |
Response
응답 데이터는 시간 오름차순(과거 → 최신)으로 정렬됩니다.
| 필드 | 설명 | 타입 |
|---|---|---|
| status | 결과 상태 코드 (정상: 0000, 그 외 에러 코드 참조) | String |
| [data] – [N] – [0] | 기준 시간 | Integer (String) |
| [data] – [N] – [1] | 시가 | Number (String) |
| [data] – [N] – [2] | 종가 | Number (String) |
| [data] – [N] – [3] | 고가 | Number (String) |
| [data] – [N] – [4] | 저가 | Number (String) |
| [data] – [N] – [5] | 거래량 | Number (String) |