KuCoin 마진 API 업그레이드 공지

안녕하세요, KuCoin 사용자 여러분,

사용자들에게 더 나은 거래 환경을 제공하고 거래 경험을 최적화하기 위해 KuCoin의 레버리지 API가 고빈도 마이그레이션 및 업그레이드를 진행하고 있습니다.이번 마이그레이션은 여러 차례에 걸쳐 진행되며 2025년 말까지 완료될 예정입니다.

1. 마이그레이션 범위:

마진을 활성화한 사용자 중 마이그레이션 시점에 마진 포지션이나 자산이 없는 경우, 영향을 받지 않습니다.

2. 마이그레이션 영향:

2.1 비-API 사용자 (C-end 사용자)

• 웹/앱에서 사용자 경험은 마이그레이션 전후에 변함이 없습니다.

2.2 API 사용자

• 이번 마이그레이션은 API 인터페이스 호출 방식 및 자산 상태 표시 방식에 일정한 영향을 미칠 수 있습니다. 마이그레이션은 여러 차례에 걸쳐 공지될 예정이며, 이메일 공지를 받은 후 적시에 해당 작업을 수행해 주시기 바랍니다. 시스템은 이메일 발송 후 7일 뒤에 마이그레이션을 진행합니다. (영향을 줄이기 위해 고빈도 API로 미리 전환하는 것을 권장합니다.)

3. 마이그레이션 절차:

1단계: 저빈도 주문 수동 정리

a. 사용자가 저빈도 API와 C-end (웹/앱)을 통해 생성한 주문을 직접 취소해야 합니다;

b. 고빈도 주문은 취소할 필요가 없습니다;

• 사용자가 직접 취소하지 않을 경우, 시스템은 마이그레이션 과정에서 강제로 주문을 취소합니다 (일반 주문 및 고급 주문 포함).

• 주문 상태를 확인하지 못할 경우, 고객 서비스팀에 문의해 주시기 바랍니다.

2단계: 저빈도 자산 수동 전환 (API 사용자)

a. 사용자는 저빈도 계정 자산을 고빈도 계정으로 수동 전환하고 새로운 API 인터페이스로 전환해야 합니다 (상세 내용은 api-doc을 참조하세요).

b.전환 할당량 받기 - KUCOIN API현재 C-end(Web 및 App)의 자산은 "FROZEN(동결)" 상태로 표시되며, 고빈도 주문 작업이 불가능합니다.

3단계: 마이그레이션 시작

* 1단계와 2단계는 필수가 아니지만, 마이그레이션이 실행되면 시스템이 자동으로 저빈도 주문을 취소하고 저빈도 자산을 고빈도 계정으로 이전합니다.

중요 공지:

1. 계정 일시적 비활성화 (C-end 사용자 및 API 사용자 모두 영향받음);

마이그레이션 실행 중 사용자 계정은 약 2~3분 동안 일시적으로 비활성화됩니다. 이로 인해 자산 조회, 거래 및 전송 기능이 영향을 받을 수 있으니, 미리 작업을 준비하여 거래에 차질이 없도록 하시기 바랍니다.

2. 저빈도 주문 강제 취소;

사용자가 저빈도 주문을 사전에 취소하지 않을 경우, 마이그레이션 과정 중에 시스템이 완료되지 않은 저빈도 일반 주문 및 고급 주문을 강제로 취소하게 됩니다.

3. 자산이 단시간 동안 "동결" 상태로 표시됨;

마이그레이션 준비 단계에서 기존 인터페이스에 고빈도 자산이 "동결" 상태로 표시될 수 있으며, 마이그레이션 완료 후 정상 상태로 복구됩니다.

4. 인터페이스 호환성 안내;

기존 인터페이스는 더 이상 고빈도 계정 관련 조회를 지원하지 않습니다. 반드시 사전에 전환 작업을 완료하십시오. 그렇지 않으면 예외가 반환될 수 있습니다.

5. 공식 마이그레이션은 이메일 공지 후 7일 후에 진행됩니다;

공식 마이그레이션은 이메일 공지 발송 후 7일 뒤에 시작됩니다. 사용자분들께서는 이메일을 주의 깊게 확인하시고, 마이그레이션 날짜 전에 필요한 준비를 완료하여 원활한 전환이 이루어지고 서비스 중단을 방지할 수 있도록 하시기 바랍니다.

마이그레이션 세부 내용:

자산 조회

• 자산 조회는 새로운 API 인터페이스 사용을 권장드립니다:

  • 크로스 마진 계정 자산 조회: /api/v3/margin/accounts

  • 격리 마진 계정 자산 조회: /api/v3/isolated/accounts

• 마이그레이션 이후, 마이그레이션 전후의 자산 데이터는 일관성을 유지합니다. 마이그레이션 완료 후, 마진, margin_v2 및 ALL 조회 모두 일관된 결과를 반환하며(격리 계정의 경우도 동일), 변경된 데이터는 없습니다.

참고:구 자산 조회 인터페이스(/api/v1/margin/account - 교차 마진용, /v1/isolated/accounts - 격리 마진용)은 마이그레이션 이후에도 계속 사용할 수 있습니다. 하지만, 마이그레이션을 완료하지 않은 사용자의 경우 고빈도 자산이 "동결(Frozen)" 상태로 표시됩니다.

거래 원장 조회

1. V1 인터페이스: /api/v1/accounts/ledgers

• 마이그레이션 이전과 이후 모두 고빈도 및 저빈도 계정에 대해 원장을 조회할 수 있으며, 이전과 동일한 시간 범위가 적용됩니다.

2. V3 인터페이스: /api/v3/hf/margin/account/ledgers

• 이 인터페이스는 고빈도 계정 거래만 조회할 수 있으며, 최근 3일 동안의 제한된 시간 범위만 지원합니다.

사용자는 필요에 따라 적합한 인터페이스를 선택할 수 있습니다.

이체

• 이체 인터페이스는 변경되지 않습니다. 이전 인터페이스를 통해 고빈도 계정과 저빈도 계정 간의 이체를 계속 사용할 수 있습니다.

  • 마이그레이션 이전: 동일 사용자 계정 내에서 고빈도와 저빈도 계정 간 이체가 지원됩니다.

  • 마이그레이션 이후: margin 및 margin_v2는 동일한 계정으로 간주되며, 이 두 계정 간의 이체는 더 이상 지원되지 않습니다(격리 마진 계정도 동일).

히스토리컬 주문 조회

1. V1 인터페이스: /api/v1/orders?status=done

• 마이그레이션 이전과 이후 모두 고빈도 및 저빈도 주문의 히스토리컬 데이터를 조회할 수 있으며, 동일한 시간 범위가 적용됩니다.

2. V3 인터페이스: /api/v3/hf/margin/orders/done

• 이 인터페이스는 고빈도 주문만 조회할 수 있으며, 최근 3일 동안의 데이터만 반환할 수 있습니다. 사용자는 필요에 따라 적합한 인터페이스를 선택할 수 있습니다.

주문 생성/주문 취소/활성 주문 조회

1. V1 인터페이스: 저빈도 주문의 생성, 취소 및 활성 주문 조회를 지원합니다.

2. V3 인터페이스: 고빈도 주문의 생성, 취소 및 활성 주문 조회를 지원합니다.

고빈도 및 저빈도 주문은 상호 호환되지 않으며, 이에는 손익 지정 주문 및 손실 제한 주문 기능도 포함됩니다. 사용자는 주문 유형에 따라 해당 인터페이스를 사용해야 합니다.

마이그레이션 인터페이스 변경사항:

• 주의: 사용에 영향을 미치지 않도록 마이그레이션 전후에 변경된 인터페이스 사항을 미리 명확히 확인하시기 바랍니다.

리스크 경고

마진 거래는 상대적으로 적은 자본으로 자금을 차입하여 금융 자산을 거래하고 더 큰 수익을 얻는 방식입니다. 그러나 시장 위험, 가격 변동 및 기타 요인으로 인해, 투자 행동에 신중을 기하며 적절한 마진 거래 레버리지 수준을 채택하고 적시에 적절하게 손실을 멈추는 것이 강력히 권장됩니다.   KuCoin   은(는) 거래로 인해 발생한 손실에 대해 어떠한 책임도 지지 않습니다.

항상 여러분의 지원에 감사드립니다!

KuCoin 팀

KuCoin에서 다음 암호화폐 원석을 찾으세요!

지금 KuCoin에 가입하세요! >>>

KuCoin 앱 다운로드 >>>

X (Twitter)에서 팔로우하세요 >>>

Telegram에 참여하세요 >>>

KuCoin 글로벌 커뮤니티에 참여하세요 >>>

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