get
https://api.bithumb.com/public/candlestick/_/
시간 및 구간별 빗썸 거래소 가상자산 가격, 거래량 정보를 제공합니다.
응답 개수 정책 안내
count쿼리 파라미터로 응답 개수를 직접 지정할 수 있습니다(최대 200개).count미입력 시 기본 응답 개수는 모든 봉에 대해 200개로 반환됩니다.→ 변경 이력 보기
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). 미입력 시 기본값 200개를 반환합니다. |
count 파라미터 상세
count 파라미터의 입력 값에 따라 응답 개수가 달라집니다.
| 요청 | 동작 |
|---|---|
count 미입력 | 200개 반환 |
count=N (1 ≤ N ≤ 200) | N개 반환 |
count=N (N > 200) | 200개 반환 |
count=(빈 값) | 에러 반환 |
| 유효하지 않은 값(음수, 문자 등) | 에러 반환 |
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) |