Kucoin에서 내 API 키를 얻는 방법

제한된 권한으로 Kucoin API 키를 생성하고, 2FA를 활성화하고, 자격 증명을 단단히 저장하여 거래를 안전하게 자동화하거나 포트폴리오를 추적합니다.

2025/08/08 18:50

Kucoin의 API 키 이해

API 키는 프로그래밍 방식으로 Kucoin의 거래 플랫폼 과 상호 작용하려는 사용자에게 필수 도구입니다. 이 키를 사용하면 외부 응용 프로그램, 거래 봇 또는 개인 스크립트가 잔액 확인, 거래 배치 또는 주문 기록 검색과 같은 조치에 대해 Kucoin 계정에 액세스 할 수 있습니다. 각 API 키는 Kucoin 서버에 대한 요청을 인증하는 고유 식별자입니다. API 키는 기본적으로 전체 계정 액세스 권한을 부여하지 않음을 이해하는 것이 중요합니다. 교역 만 가능하거나 인출 기능을 비활성화하는 등의 키가 수행 할 수있는 작업을 제한하기 위해 관리를 사용자 정의 할 수 있습니다.

API 키를 생성하기 전에 Kucoin 계정에 2 단계 인증 (2FA)이 보안되어 있는지 확인하십시오. 특히 API 키가 민감한 작업을 수행 할 수 있기 때문에 추가 보호 계층을 추가합니다. Kucoin은 Google Authenticator, SMS 및 기타 2FA 방법을 지원합니다. 2FA 활성화가 없으면 Exchange에서 부과하는 보안 요구 사항이므로 API 키를 만들 수 없습니다.

API 관리 섹션으로 탐색

API 키를 얻는 프로세스를 시작하려면 공식 웹 사이트를 통해 Kucoin 계정 에 로그인하십시오. 로그인하면 화면의 오른쪽 상단에 프로필 아이콘을 찾으십시오. 드롭 다운 메뉴를 공개하려면 클릭하십시오. 이 메뉴에서 'API'를 선택하십시오. 이렇게하면 기존 API 키가 나열된 API 관리 대시 보드로 리디렉션됩니다.

이 섹션에 처음으로 액세스 할 경우 목록이 비어있을 수 있습니다. 인터페이스는 새 API 키를 생성하고 활성 키를보고 권한을 관리하는 옵션을 제공합니다. 올바른 계정 유형에 있는지 확인하십시오-Kucoin은 표준 및 하위 계정을 모두 지원하며 API 키는 계정 당 생성됩니다. 하위 계정을 사용하는 경우 진행하기 전에 해당 특정 하위 계정에 로그인했는지 확인하십시오.

새 API 키 생성

API 관리 페이지에서 'API 만들기' 버튼을 클릭하십시오. 팝업 창이 나타나서 새 키를 구성하라는 메시지가 표시됩니다. API 키 이름을 입력하라는 요청을받습니다. 이는 참조를위한 것이며 '거래 봇'또는 '포트폴리오 추적기'와 같은 설명이 될 수 있습니다.

다음으로 허가 범위를 설정해야합니다. Kucoin은 다음 권한 중 하나 이상을 할당 할 수 있습니다.

• 일반 - 계정 정보 및 API 상태를 볼 수 있습니다.
• 읽기 - 균형, 주문 기록 및 거래 기록에 액세스 할 수 있습니다.
• 거래 - 주문 배치, 수정 및 취소를 허용합니다.
• 철회 - 계좌에서 자금을 인출하는 능력을 부여합니다.

절대적으로 필요하지 않은 경우 철수 허가를 방지하지 않는 것이 좋습니다. 대부분의 타사 도구와 봇은 읽기 및 거래 권한 만 있으면됩니다. 인출 액세스를 가능하게하면 API 키가 손상되면 펀드 손실의 위험이 증가합니다.

보안 검증 완료

원하는 권한을 선택한 후 보안 검증 단계를 완료해야합니다. Kucoin은 이메일 확인 코드 및 2FA 코드를 입력하라는 메시지를 표시합니다. 등록 된 이메일받은 편지함에서 6 자리 확인 코드가 포함 된 Kucoin의 메시지를 확인하십시오. 지정된 필드 에이 코드를 입력하십시오.

그런 다음 2FA 인증 앱 (예 : Google Authenticator)을 열고 Kucoin 계정에 표시된 현재 6 자리 코드를 입력하십시오. 이 이중 확인을 통해 공인 계정 소지자 만 API 키를 생성 할 수 있습니다. 코드 중 하나가 올바르지 않으면 프로세스가 실패하고 다시 시도해야합니다.

두 코드가 모두 성공적으로 확인되면 시스템은 API 키 및 비밀 키를 생성합니다. 이 두 구성 요소는 중요합니다. API 키는 응용 프로그램을 식별하는 데 사용되며 비밀 키는 보안 요청에 서명하는 데 사용됩니다. 이 과정에서 둘 다 한 번만 표시됩니다.

API 자격 증명 보안 및 저장

생성 후 API 키와 비밀 키를 즉시 복사하십시오 . Kucoin은 보안상의 이유로 다시 비밀 키를 표시하지 않습니다. 잃어버린 경우 현재 키를 삭제하고 새 키를 만들어야합니다. 이 자격 증명을 보안 적으로 암호화하거나 암호 관리자에 보관하십시오. 공유하지 않거나 공공 코드 저장소에 헌신하지 마십시오.

유스 케이스가 허용하는 경우 IP 제한을 설정하는 것이 좋습니다. Kucoin을 사용하면 API 키를 사용할 수있는 화이트리스트 특정 IP 주소를 사용할 수 있습니다. 이것은 누군가가 귀하의 자격 증명을 얻더라도 승인되지 않은 위치에서 자격 증명을 사용할 수 없음을 의미합니다. IP 제한을 활성화하려면 키 생성 중 또는 키 생성 후 지정된 필드에서 사용할 정적 IP 주소를 입력하십시오.

여러 키를 추적하기 위해 키 (예 : 'Production Bot - AWS IP')의 목적과 환경에 레이블을 지정할 수도 있습니다. 활성 API 키를 정기적으로 검토하고 더 이상 사용되지 않는 모든 것을 취소하십시오.

API 키 테스트

API 키가 작동하는지 확인하려면 Curl 또는 Postman 과 같은 도구를 사용하여 간단한 테스트 요청을 할 수 있습니다. 예를 들어 계정 잔액을 검색하려면 다음 엔드 포인트를 사용하십시오.

 GET https://api.kucoin.com/api/v1/accounts

다음 헤더를 포함해야합니다.

• KC-API-KEY : API 키
• KC-API-SIGN : 비밀 키를 사용하여 생성 된 서명
• KC-API-TIMESTAMP : 밀리 초의 현재 타임 스탬프
• KC-API-PASSPHRASE : 설정 한 암호 (있는 경우)

서명은 비밀 키와 함께 HMAC-SHA256을 사용하여 타임 스탬프, HTTP 방법, 엔드 포인트 및 요청 본문 (있는 경우)의 연결을 인코딩하여 작성됩니다. 이를 통해 각 요청이 인증되고 변조 방지되도록합니다.

자주 묻는 질문

분실하면 비밀 키를 복구 할 수 있습니까?

아니요, Kucoin은 창조 후 비밀 키를 저장하지 않습니다. 잃어버린 경우 현재 API 키를 삭제하고 새 키를 생성해야합니다.

타사 거래 봇이있는 API 키를 사용하는 것이 안전합니까?

권한을 제한하고 IP 화이트리스트를 사용하면 안전 할 수 있습니다. API 액세스를 제공하기 전에 항상 봇 또는 서비스의 정당성을 확인하십시오.

Kucoin에서 몇 개의 API 키를 만들 수 있습니까?

Kucoin은 계정 당 여러 API 키를 허용합니다. 공개적으로 명시된 한도는 없지만 필요한 것만 생성하고 신중하게 관리하는 것이 가장 좋습니다.

내 API 키가 손상되었다고 생각되면 어떻게해야합니까?

즉시 API 관리 페이지로 이동하여 의심스러운 키를 찾은 다음 '삭제'를 클릭하십시오. 삭제 후 필요한 경우 새 키를 만들고 새 자격 증명으로 응용 프로그램을 업데이트하십시오.