[v1.2.0 공지] Candlestick API 응답 개수 정책 변경
July 7th, 2026
안녕하세요. 당신의 안전한 금융 파트너, 빗썸입니다.
안정적인 API 서비스 제공을 위해 Candlestick API의 응답 개수 정책을 변경합니다.
기존 Candlestick API는 봉 종류에 따라 최대 수천 개의 데이터를 반환하고 있었습니다. 대량 데이터 요청이 집중될 경우 API 응답 지연 및 서비스 불안정으로 이어질 수 있어, 모든 사용자에게 일관된 서비스 품질을 제공하기 위해 응답 개수 상한을 조정하게 되었습니다.
기존에 count 없이 호출하던 코드는 응답 개수가 줄어들 수 있으니 변경 일시 전에 확인해 주시길 바라며, 이용에 불편을 드리는 점 양해 부탁드립니다.
■ 변경 내용
1. count 파라미터 추가
count 파라미터 추가캔들스틱 데이터 조회 시 응답 개수를 지정할 수 있는 count 쿼리 파라미터가 추가되었습니다.
count파라미터 입력 시 최대 200개까지 조회 가능합니다.count파라미터 미입력 시 기존과 동일한 봉별 기본 응답 개수를 반환합니다.
2026년 7월 21일까지는
count미입력 시 기존 봉별 기본 응답 개수가 그대로 유지됩니다.
2. 기본 응답 개수 변경(2026년 7월 21일 이후)
2026년 7월 21일부터 응답 개수가 다음과 같이 변경됩니다.
count미입력 시 기본 응답 개수가 200개로 변경됩니다.count를 지정한 경우의 동작은 변경 전과 동일합니다.
전체 동작 요약
| 요청 | 변경 | 2026년 7월 21일 이후 |
|---|---|---|
count 미입력 | 봉별 기본 응답 개수 반환 | 200개 |
count=N (1 ≤ N ≤ 200) | N개 반환 | N개 반환 |
count=N (N > 200) | 200개 반환 | 200개 반환 |
count=(빈 값) | 에러 반환 | 에러 반환 |
| 유효하지 않은 값(음수, 문자 등) | 에러 반환 | 에러 반환 |
■ 적용 대상 및 일시
GET /candlestick/{order_currency}_{payment_currency}/{chart_intervals}- 버전: v1.2.0
- 적용 일시: 2026년 7월 21일 오후 5시 이후
- API 상세 명세: 캔들스틱 조회
※ 적용 일는 변경될 수 있으며, 변경 시 별도로 안내드릴 예정입니다.
감사합니다.