Kucoin API를 사용하는 방법?

Kucoin API 구조 이해

1. Kucoin API는 개발자가 프로그래밍 방식으로 교환과 상호 작용할 수있는 편안한 인터페이스입니다. 시장 데이터 검색, 거래 배치, 주문 관리 및 계정 정보 액세스와 같은 기능을 지원합니다. 각 엔드 포인트는 표준화 된 URL 형식을 따릅니다. 일반적으로 https://api.kucoin.com 으로 시작합니다.

2. 개인 엔드 포인트에는 인증이 필요하며 API 키, 비밀 키 및 암호화를 사용하여 달성됩니다. 이러한 자격 증명은 API 관리 섹션의 Kucoin 사용자 계정 내에서 생성됩니다. 인증 프로세스에는 요청 매개 변수 및 타임 스탬프를 기반으로 HMAC-SHA256 암호화를 사용하여 서명을 작성하는 것이 포함됩니다.

3. 시세 데이터 또는 주문서 스냅 샷과 같은 공개 엔드 포인트는 인증이 필요하지 않습니다. 이들은 HTTP GET 요청을 통해 직접 액세스 할 수 있습니다. 개발자는 일시적으로 차단되지 않도록 제한을 준수해야합니다. Kucoin은 특히 고주파 요청에 대한 엄격한 요율 제한 정책을 시행합니다.

4. 모든 응답은 JSON 형식으로 반환되므로 다양한 프로그래밍 환경에 쉽게 구문 분석하고 통합 할 수 있습니다. 오류 메시지는 또한 해당되는 경우 코드, 메시지 및 추가 세부 정보를 포함하여 일관된 구조를 따릅니다. 강력한 응용 프로그램 성능을 유지하려면 적절한 오류 처리가 필수적입니다.

5. Kucoin은 실시간 데이터 스트리밍을위한 WebSocket 연결을 지원합니다. 여기에는 주문서, 무역 실행 및 잔액 변경에 대한 업데이트가 포함됩니다. WebSocket 엔드 포인트에는 개인 데이터에 대한 서명 된 연결이 필요하지만 인증없이 공개 시장 피드를 허용합니다.

API 자격 증명 설정

1. Kucoin API 사용을 시작하려면 사용자는 Kucoin 계정에 로그인하여 'API 관리'섹션으로 이동해야합니다. 여기에서는 읽기, 거래 또는 철수 액세스와 같은 권한을 지정하여 새로운 API 키를 만들 수 있습니다. 보안 위험을 최소화하기 위해 필요한 권한 만 할당하는 것이 중요합니다.

2. 생성 과정에서 사용자는 IP 화이트리스트를 설정하라는 메시지가 표시됩니다. 이는 API 액세스를 특정 IP 주소로 제한하여 보안을 향상시킵니다. IP가 지정되지 않으면 API 키는 모든 위치에서 사용할 수 있으며, 이는 무단 사용에 대한 취약성을 증가시킬 수 있습니다.

3. API 키, Secret Key 및 Passphrase를 생성 한 후 이러한 값은 안전하게 저장되어야합니다. 비밀 키와 암호는 창조 중에 한 번만 표시되며 나중에 검색 할 수 없습니다. 그들을 잃으면 열쇠가 취소되고 재생되어야한다는 것을 의미합니다.

4. 개발자는 소스 파일의 하드 코딩 자격 증명을 피해야합니다. 대신 환경 변수 또는 보안 구성 파일을 사용하여 민감한 정보를 저장해야합니다. 이 관행은 특히 버전 제어 시스템을 사용할 때 우발적 노출의 위험을 줄입니다.

5. Kucoin은 계정 당 여러 API 키를 허용하므로 다양한 응용 프로그램이나 서비스가 독립적으로 작동 할 수 있습니다. 각 키는 뚜렷한 권한과 IP 제한을 가질 수 있으며 액세스 및 기능에 대한 세분화 된 제어를 제공합니다.

거래 실행 및 주문 관리

1. Kucoin API를 통해 주문을 배치하려면/API/V1/Orders endpoint에 게시물 요청을 보내야합니다. 필수 매개 변수에는 주문 유형에 따라 기호 (예 : BTC-USDT), 주문 유형 (한도 또는 시장), 측면 (구매 또는 판매) 및 크기 또는 자금이 포함됩니다.

2. 한계 주문의 경우 가격 매개 변수가 포함되어야합니다. 시장 매수 주문에는 견적 통화 금액 (예 : USDT)이 필요하지만 시장 판매 주문에는 기본 통화 금액 (예 : BTC)이 필요합니다. 잘못된 매개 변수 사용으로 인해 유효성 검사 오류가 발생합니다.

3. 제출되면 API는 주문 ID를 반환하며, 이는 거래 상태를 추적하는 데 사용할 수 있습니다. 개발자는/API/V1/ORDERS/{ORDERID} 엔드 포인트를 사용하여 주문 세부 정보를 쿼리하거나 적절한 필터가있는/API/V1/주문을 통해 활성 주문 목록을 검색 할 수 있습니다.

4. 주문 취소는 동일한 엔드 포인트로 삭제 요청을 통해 주문 ID를 지정합니다. 배치 취소는 사용 된 엔드 포인트에 따라 동일한 기호 또는 모든 기호에 따라 여러 차례에 대해 지원됩니다.

5. WebSocket Feed /Market /Level2를 사용하여 실시간 주문 업데이트를 모니터링 할 수 있으며 , 이는 증분 주문서 변경을 제공합니다. 이를 통해 고주파 거래 전략을 가능하게하고 폴링 휴식 종점에 비해 대기 시간을 줄입니다.

자주 묻는 질문

Kucoin API 요청의 요금 제한은 얼마입니까? 공개 엔드 포인트는 IP 당 최대 600 개의 요청을 허용하는 반면 개인 엔드 포인트는 사용자 당 분당 600 개의 요청으로 제한됩니다. 이러한 한도를 초과하면 일시적인 금지가 발생합니다. 개발자는 이러한 임계 값 내에서 유지하기 위해 스로틀 메커니즘을 구현해야합니다.

마진 거래에 Kucoin API를 사용할 수 있습니까? 예, Kucoin은/api/v1/margin/주문 경로에 따른 마진 거래에 대한 API 엔드 포인트를 제공합니다. 사용자는 계정에서 마진 거래를 활성화하고 마진 주문을 실행하기 전에 API 키에 필요한 권한이 있는지 확인해야합니다.

API 다운 타임 또는 고장을 어떻게 처리합니까? 실패한 요청에 대한 지수 백 오프로 재시 도로 로직을 구현하십시오. Kucoin의 공식 상태 페이지를 모니터링하고 시스템 공지 사항을 구독하십시오. 생산 애플리케이션에서 회로 차단기 패턴을 사용하여 중단 중 계단식 고장을 방지하십시오.

API를 사용하려면 2 단계 인증이 필요합니까? API 호출에는 2FA가 필요하지 않지만 계정 보안에 강력히 권장됩니다. API 키 우회 2FA이므로 자금에 대한 무단 액세스를 방지하려면 제대로 고정하는 것이 필수적입니다.