바이낸스에서 과거 촛대 데이터를 보는 방법

바이낸스 웹 인터페이스를 통해 촛대 데이터에 액세스

1. 바이낸스 현물 거래 페이지로 이동하여 BTC/USDT와 같은 특정 거래 쌍을 선택하세요.

2. 차트 영역을 찾고 시간 간격 드롭다운을 클릭합니다. 옵션에는 1분, 5분, 15분, 1시간, 4시간, 1일, 1주, 1개월이 포함됩니다.

3. 차트 캔버스를 마우스 오른쪽 버튼으로 클릭하여 컨텍스트 메뉴를 열고 "데이터 내보내기"를 선택하여 시가, 고가, 저가, 종가, 거래량 및 타임스탬프 필드가 포함된 CSV 파일을 다운로드합니다.

4. 가로로 드래그하거나 차트 위젯 하단의 확대/축소 슬라이더를 사용하여 차트 표시 범위를 조정합니다.

5. 도구 설명에서 정확한 OHLCV 값과 UTC 타임스탬프를 보려면 원통 위로 마우스를 가져갑니다.

Binance REST API를 통해 과거 데이터 검색

1. 필수 매개변수인 기호(예: ETHUSDT), 간격(예: 1h) 및 선택적 startTime/endTime(밀리초)을 사용하여 https://api.binance.com/api/v3/klines 에 대한 GET 요청을 구성합니다.

2. 응답은 12개 요소 배열의 배열을 반환합니다. 각 하위 배열은 개시 시간, 시가, 고가, 저가, 종가, 거래량, 마감 시간, 자산 견적 볼륨, 거래 수, 테이커 구매 기본 볼륨, 테이커 구매 견적 볼륨 및 무시 필드를 인코딩합니다.

3. 제한 매개변수를 사용하여 배치 크기를 제어합니다. 허용되는 최대값은 1000입니다. 페이지 매기기를 위해서는 startTime을 마지막 종료 시간에 1밀리초를 더한 값으로 조정해야 합니다.

4. 처리 속도 제한: 퍼블릭 엔드포인트의 경우 분당 1200개 요청; 초과는 Retry-After 헤더를 사용하여 HTTP 429를 트리거합니다.

5. 가져온 간격에서 왜곡으로 인한 간격이나 겹침을 방지하기 위해 /api/v3/time 에서 얻은 서버 시간에 대해 타임스탬프를 검증합니다.

AI 에이전트에 Binance 암호화폐 MCP 사용

1. Model Context Protocol 서비스를 Claude 또는 Cursor와 같은 에이전트 프레임워크에 통합하여 촛대 패턴에 대한 자연어 쿼리를 발행합니다.

2. "2026년 10월 1일부터 10월 10일까지 SOL/USDT에 대한 4시간 캔들스틱 데이터를 보여주세요"와 같은 프롬프트를 제출하고 전체 kline 배열로 구조화된 JSON 응답을 받습니다.

3. 내장된 시간 창 정규화를 활용합니다. "지난 30일"을 지정하는 쿼리는 UTC 자정에 맞춰 Unix epoch 경계를 수정하도록 자동으로 해결됩니다.

4. 양초 집계 논리 또는 시간대 해석의 차이를 디버깅할 때 원시 API 결과에 대해 출력을 교차 검증합니다.

5. 최종 양초와 여전히 거래소 측 조정이 필요한 임시 양초를 구별하기 위해 응답에서 "isFinal" 부울 플래그를 분석합니다.

데이터 무결성 및 타임스탬프 고려 사항

1. 모든 캔들스틱 타임스탬프는 종료 시간이 아닌 간격의 시작 시간을 반영하므로 "2026-10-15"라고 표시된 1d 캔들은 00:00:00 UTC에 시작하여 23:59:59.999 UTC에 끝납니다.

2. 양초 누락은 유동성이 낮아서가 아니라 거래소 유지 관리 기간 또는 인프라 장애 중에만 발생하며 바이낸스 서버에 의해 삽입되지 않습니다.

3. 거래량 값은 기본 자산 거래량만 나타냅니다. 견적 자산 볼륨은 필요한 경우 가까운 가격 곱셈을 사용하여 별도로 파생되어야 합니다.

4. 서버 측 캔들 생성은 수집 타임스탬프가 아닌 거래소에서 관리하는 주문 매칭 타임스탬프를 사용하여 모든 데이터 채널에서 일관성을 보장합니다.

5. 시간대 인식 클라이언트는 API 요청을 제출하기 전에 현지 시간 입력을 UTC로 변환해야 합니다. Binance는 자동 시간대 변환을 수행하지 않기 때문입니다.

자주 묻는 질문

Q: 공개 API를 통해 1년이 지난 캔들스틱 데이터를 가져올 수 있나요? 예. /api/v3/klines 엔드포인트는 각 기호의 상장 날짜부터 기록 데이터를 제공합니다. BTC/USDT는 2017년 7월부터 데이터를 지원합니다. PEPE/USDT와 같은 최신 쌍은 출시일부터 시작됩니다.

Q: 내보낸 CSV 파일에 특정 날짜 범위에 대해 예상보다 적은 수의 행이 표시되는 이유는 무엇입니까? 이는 선택한 시간 간격이 해당 쌍에 대해 사용 가능한 거래 내역을 초과할 때 발생합니다. 예를 들어, 10일 전에 출시된 토큰에 대해 1w 양초를 요청하면 행이 하나만 생성됩니다.

Q: 바이낸스는 거래 취소 또는 수정 후 과거 양초를 조정합니까? 아니요. 확정된 캔들은 일단 작성되면 변경할 수 없습니다. “임시”로 표시된 실시간 캔들만 최종 확정 전에 변경될 수 있습니다. 이러한 변경 사항은 isFinal 상태가 업데이트된 후속 API 호출에 반영됩니다.

Q: 수동 검사 없이 캔들 연속성 격차를 감지할 수 있는 방법이 있습니까? 순차적인 closeTime 값을 비교합니다. 다음 촛불의 openTime이 현재 촛불의 closeTime + 간격 기간을 초과하면 간격이 존재합니다. 스크립트는 대규모 배치에 걸쳐 이러한 검증을 자동화할 수 있습니다.