KuCoin UTA API V1에서 V2로 업그레이드 안내

기관 및 전문 트레이딩 시나리오에서 API의 안정성, 보안, 표준화 및 확장성에 대한 요구가 증가함에 따라, 쿠코인은 API 시스템을 종합적으로 업그레이드하고 새로운 API V2를 출시했습니다.

KuCoin UTA API V2는 업계 표준 API 설계 원칙 및 최선의 실무를 따르며, API 인증 메커니즘, 오류 코드 시스템, API 사양 및 문서 구조에 체계적인 개선을 적용했습니다. 이러한 개선사항은 개발자에게 더 표준화되고 일관된 API 통합 경험을 제공합니다.

이 업그레이드는 기존 V1 API의 정상 사용에 영향을 미치지 않습니다. V1 API는 계속 사용 가능하며 정상적으로 사용할 수 있습니다. 향후 V2 API는 기능 업데이트 및 유지보수의 주요 API 버전으로 사용되며, V1 API는 더 이상 새로운 기능 업데이트를 제공하지 않습니다.

1. 업그레이드 일정

UTA API V2 업그레이드는 다음 시점에 적용될 예정입니다:

2026-08-27 10:00:00 (UTC)

2. 업그레이드 영향

이 업그레이드는 UTA API에만 적용되며, 기존 V1 UTA API의 정상 사용에 영향을 미치지 않습니다.

V1 API는 계속 사용 가능하며, 기존 API 통합은 즉시 조정할 필요가 없습니다.
V1 API는 더 이상 새로운 기능 업데이트를 제공하지 않습니다. 새로운 기능 및 향후 API 최적화는 V2 API에 집중됩니다.
사용자는 최신 API 기능과 사양을 활용하기 위해 점진적으로 V2 API로 마이그레이션하는 것을 권장합니다. API 소개를 참조하세요.

3. V2 API 주요 업데이트

3.1 WebSocket 인증 업그레이드

V2 API는 새로운 API 인증 방식을 채택합니다. 인증 메커니즘은 Connect Token에서 서명 기반 인증으로 변경됩니다.

새로운 인증 방법은보다 표준화된 요청 검증 메커니즘을 제공합니다.

자세한 인증 규칙 및 서명 생성 방법은 WebSocket 소개를 참조하세요.

3.2 API 오류 코드 사양 업그레이드

V2 API는 API 오류 코드의 통일되고 표준화된 관리를 위해 완전히 새로운 오류 코드 사양을 채택합니다.

자세한 오류 코드 및 오류 메시지는 API Error Code를 참조하세요.

3.3 API 엔드포인트 업데이트

UTA API V2 모든 엔드포인트의 URL이 업데이트되었으며, 모든 엔드포인트가 V2 버전으로 업그레이드되었습니다.
다음 API 매개변수는 V1과 비교하여 변경되었습니다:

업데이트 유형	엔드포인트	업데이트 정보
[수정]	UTA REST 계정 통화 자산 조회 (클래식)	응답 필드 이름 변경: `hold`→ `locked`
[수정]	UTA REST 서브 계정 통화 자산 조회	이름 변경 요청 필드: `UID` → `uid` 응답 구조 및 필드 업데이트: `accountList` → `accounts` `currencyList` → `currencies` `accountSubType` → `subAccountType` `liabilityPrinciple` → `liabilityPrincipal` `hold` → `locked` 문서화된 응답 열거 값 제거: `accountType`: `OPTIONS`
[수정]	UTA REST 플렉스 이체	요청 필드 교체: `type` → `transferType` with `INTERNAL`, `PARENT_TO_SUB`, `SUB_TO_PARENT`, `SUB_TO_SUB` 필수 필드로 옵션 요청 필드를 교체하세요: `fromAccountSymbol` → `fromAccountTag` `toAccountSymbol`→ `toAccountTag`
[수정]	UTA REST 입금 주소 조회	응답 필드 이름 변경: `chainId` → `chain` `to` → `toAccountType` `memo` 및 `remark` 필드가 이제 선택 사항입니다.
[수정]	UTA REST 출금 한도 조회	이름 변경 요청 필드: `chainId` → `chain` 요청 필드 추가: `withdrawType`(필수), `isInner`(선택) 응답 필드 이름 변경: `chainId` → `chain` `remainAmount` → `remainingQuotaAmount` `availableAmount` → `availableWithdrawAmount` `withdrawMinFee` → `minWithdrawFee` `innerWithdrawMinFee` → `minInnerWithdrawFee`
[수정]	UTA REST 통화 조회	변경 요청 필드: `currency`이(가) 이제 필수입니다 체인 레벨 응답 필드 이름 변경: `chainId` → `chain` 체인 레벨 정규식 및 수수료 필드 추가: `addressRegex`, `memoRegex`, `depositFeeRate`, `depositTierFee`, `fixedDepositFee`, `maxDepositFee`, `maxWithdrawFee`
[수정]	UTA REST 통화 조회	응답 구조 및 필드 업데이트: items[] → list[] `chainId` → `chain` 통화 수준 필드 제거: `isMarginEnabled`, `isDebitEnabled` 체인 레벨 정규식 및 수수료 필드 추가: `addressRegex`, `memoRegex`, `depositFeeRate`, `depositTierFee`, `fixedDepositFee`, `maxDepositFee`, `maxWithdrawFee`
[수정]	UTA REST 법정통화 가격 조회	변경 요청 필드: `base`가 이제 필수입니다. `currencies`는 쉼표로 구분된 문자열에서 문자열 배열로 변경되었습니다.
[수정]	UTA REST Get Symbol	응답 필드 추가: `maxMarketOrderSize`, `preMarketToPerpDate` 응답 열거형 업데이트: `tradingStatus 값`: `TradingEnabled`, `TradingDisabled`, `Init`, `Open`, `PrepareSettled`, `BeingSettled`, `Settled`, `Paused`, `Closed`, `CancelOnly` `feeCategory`: 1, 2, 3 → `classA`, `classB`, `classC` 응답 필드 유형 업데이트: `callauctionFirstStageStartTime`, `callauctionSecondStageStartTime`, `callauctionThirdStageStartTime`, `expiryTime`, `settlementTime`, `maxLeverage`
[수정]	UTA REST 출금	이름 변경 요청 필드: `chainId` → `chain`
[추가]	UTA REST 주문 수정 & UTA WebSocket 주문 수정	새 엔드포인트
[수정]	UTA REST 주문 상세 정보 조회 & 주문 이력 조회	응답 필드 `cancelReason`가 설명적인 취소 사유 대신 열거형 값을 반환합니다. 이 변경 사항은 UTA API V1 및 V2 모두에 적용되었습니다.
[수정]	UTA REST 거래 내역 가져오기	요청 필드 추가 `fillType`: 모든 종류의 거래 유형을 조회할 수 있도록 지원
[수정]	UTA Websocket 펀딩피	새 요청 필드 `symbols`를 추가하여 여러 심볼 구독을 지원하고, 새 응답 필드 `lfr`을 추가하여 마지막 펀딩피율(마지막 정산 시간에 해당)을 나타냅니다.
[추가]	UTA Websocket 모든 펀딩피 비율	새 엔드포인트
[추가]	UTA REST 현재 펀딩률 조회	새로운 엔드포인트. 계약 심볼 또는 제품 유형별 현재 선물 펀딩률 확인
[수정]	UTA REST 지수 가격 조회	심볼 수정 `.KXBTUSDT` → `XBTUSDTM`.
[수정]	UTA REST 이자율 지수 조회	표준 `XBTUSDTM`을 in-param에 추가
[수정]	UTA REST Klines 가져오기	기호 접미사 인코딩을 대체하기 위해 `klineType`을 추가; 기호에서 접미사 제거(후방 호환); 기호 명명 표준을 미래 인터페이스를 관리하도록 설정.

3.4 V1 및 V2의 요청 제한 규칙

V1 및 V2 API를 통해 이루어진 요청은 해당 속도 제한 풀 할당량을 공동으로 소비합니다.
V2로 업그레이드해도 V1과 별개의 추가 레이트 제한 할당량을 제공하지 않습니다.
사용자는 실제 API 사용량에 따라 V1 및 V2 API의 요청 빈도를 합리적으로 관리해야 합니다.

4. API 문서 내용 업데이트

사용자가 다양한 API 버전을 구분할 수 있도록 API 문서 구조도 업데이트했습니다.

4.1 V1 API

기존 V1 API 엔드포인트 콘텐츠는 "폐기된 엔드포인트" 콘텐츠로 이동되었습니다. Abandoned Endpoints 콘텐츠를 참조하세요.

V1 API는 여전히 사용 가능합니다. V1 API를 확인하거나 사용을 계속하려면 이 콘텐츠 아래의 관련 엔드포인트 문서를 참조하세요.

4.2 V2 API

새로운 V2 API 엔드포인트가 해당 API 제품 및 비즈니스 카테고리 콘텐츠에 추가되었습니다.

향후 API 문서를 참조할 때 사용자는 해당 V2 API 엔드포인트 및 문서를 우선적으로 사용하는 것을 권장합니다.

5. V2 API 마이그레이션 가이드

5.1 신규 사용자

KuCoin API를 처음 통합하시는 경우, API 통합 솔루션으로 UTA 모드 UTA API V2를 사용하는 것을 권장합니다.

UTA REST 및 UTA WebSocket 문서를 직접 참조할 수 있습니다.

기존 사용자를 위한 5.2 마이그레이션 가이드

기존 사용자는 비즈니스 요구 사항에 따라 기존 엔드포인트를 점진적으로 V2로 마이그레이션할 수 있습니다. 마이그레이션 과정 중에는 아래 단계를 따르는 것을 권장합니다:

새로운 인증 방식으로 전환

웹소켓 V2 개인 채널 및 서명 기반 인증을 사용한 거래 인증을 구현하세요.

배치 엔드포인트 마이그레이션

2026년 8월 27일 이후 게시된 Changelog 항목을 먼저 검토하고 Changelog에 나열된 엔드포인트를 식별할 수 있습니다.

변경 로그에 나열되지 않은 엔드포인트의 경우 기존 비즈니스 로직에 변경이 필요하지 않습니다. V1 API URL을 해당하는 V2 API URL로 직접 교체하여 일괄 마이그레이션을 완료할 수 있습니다.

특정 엔드포인트 마이그레이션

2026년 8월 27일 이후 게시된 Changelog 항목에 나열된 엔드포인트에 대해, V2 API는 V1과 비교하여 특정 가격변동이 적용되었습니다.

변경 사항은 Changelog에 설명된 대로 통합을 조정하거나, 마이그레이션을 완료하기 위해 해당 V2 API 문서를 직접 참조하세요.

V2 오류 코드에 적응

V2 API는 새로운 오류 코드 사양을 도입하고 더 표준화되고 구체적인 오류 메시지를 제공합니다.

기존 시스템이 V1 오류 코드를 기반으로 프로그래밍 방식으로 처리를 수행하는 경우, V2 오류 코드를 지원하도록 구현을 업데이트해야 합니다.

자세한 내용은 API Error Code를 참조하세요.

6. 이전 타임라인

기존 V1 API 사용자는 가능한 한 빨리 V2로 마이그레이션하는 것을 권장합니다.

V2 런칭 후에도 V1 API는 계속 사용 가능하지만, V1은 더 이상 새로운 기능 업데이트나 엔드포인트 최적화를 받지 않습니다. 향후 새로운 API 기능은 주로 V2를 통해 제공됩니다.

V1 API는 2026년 12월 31일에 퇴출되고 서비스가 종료될 예정입니다. 구체적인 서비스 종료 일정 및 관련 조치는 향후 공식 발표를 따릅니다.

API에 대한 자세한 정보는 공식 커뮤니티에 참여하세요

KuCoin API Telegram 커뮤니티

이메일로 문의하시려면: [email protected]

면책 조항: 이 페이지는 사용자의 편의를 위해 AI로 번역되었습니다. 정확한 정보를 확인하려면 영어 원문을 참조하세요.

원본 기사 읽기

에서 찾아주세요:

X (Twitter) | Telegram | Reddit

지금 CoinCarp 앱을 다운로드하세요: https://www.coincarp.com/app/

명목화폐

암호화폐

"" 해당 결과 없음

KuCoin UTA API V1에서 V2로 업그레이드 안내

1. 업그레이드 일정

2. 업그레이드 영향

3. V2 API 주요 업데이트

3.1 WebSocket 인증 업그레이드

3.2 API 오류 코드 사양 업그레이드

3.3 API 엔드포인트 업데이트

3.4 V1 및 V2의 요청 제한 규칙

4. API 문서 내용 업데이트

4.1 V1 API

4.2 V2 API

5. V2 API 마이그레이션 가이드

5.1 신규 사용자

기존 사용자를 위한 5.2 마이그레이션 가이드

6. 이전 타임라인

인기있는 코인 및 토큰

화폐 선택

"" 해당 결과 없음

명목화폐

암호화폐

"" 해당 결과 없음

KuCoin UTA API V1에서 V2로 업그레이드 안내

1. 업그레이드 일정

2. 업그레이드 영향

3. V2 API 주요 업데이트

3.1 WebSocket 인증 업그레이드

3.2 API 오류 코드 사양 업그레이드

3.3 API 엔드포인트 업데이트

3.4 V1 및 V2의 요청 제한 규칙

4. API 문서 내용 업데이트

4.1 V1 API

4.2 V2 API

5. V2 API 마이그레이션 가이드

5.1 신규 사용자

기존 사용자를 위한 5.2 마이그레이션 가이드

6. 이전 타임라인

인기있는 코인 및 토큰