API 변경 로그 & 버전 관리

버전 관리 정책

주요 버전 내에서 하위 호환성을 유지합니다. 부 버전은 변경 사항 없이 새로운 필드와 기능을 추가합니다. 주요 버전 업데이트는 6개월 전에 공지하며 호환성이 깨지는 변경 사항을 도입합니다.

v1.2.4 새로운 기능

출시일: 2026-03-18

• 새로운 엔드포인트: /v1/on-chain/whale-flows — 고래 지갑 입출금 추적
• 감정 분석이 추가된 향상된 확인 점수
• WebSocket 압축 지원 (gzip, deflate)
• 해결 단계가 포함된 개선된 오류 메시지

v1.2.3

출시일: 2026-02-28

• 고래 포지션에 margin_ratio 필드 추가
• 청산 기록을 30일까지 확장 (기존 7일)
• 웹훅 전달 안정성 개선

v1.2.0

출시일: 2026-01-15

• 주요: 미체결약정 엔드포인트 (Pro 등급)
• 주요: 온체인 메트릭 엔드포인트 (Pro 등급)
• 새로운 페이지네이션 제한: 500 (기존 100)
• 일괄 작업 지원

v1.2.0으로 마이그레이션

미체결약정 및 온체인 엔드포인트는 새로 추가된 기능으로 기존 통합에 영향을 주지 않습니다. 마이그레이션이 필요 없습니다.

선택적 업그레이드: 향상된 시장 분석을 위해 새로운 open_interest 엔드포인트를 사용하세요.

향후 사용 중단 예정 (v2 계획)

다음 엔드포인트는 v2.0(2027년 예정)에서 사용 중단될 예정입니다. 마이그레이션 경로가 제공됩니다.

현재 없음. v1은 안정적이며 완전히 하위 호환됩니다.

서비스 종료 정책

사용 중단된 엔드포인트는 제거 6개월 전에 공지됩니다. 모든 호환성이 깨지는 변경 사항에 대해 명확한 마이그레이션 가이드를 제공합니다.