거래 봇에 KuCoin API를 사용하는 방법은 무엇입니까? (개발자 도구)

인증 메커니즘

1. KuCoin API는 모든 개인 끝점에 대해 HMAC-SHA256 서명 생성이 필요합니다. 서명은 타임스탬프, HTTP 메서드, 엔드포인트 경로 및 선택적 요청 본문의 연결에서 파생됩니다.

2. 각 요청에는 KC-API-KEY , KC-API-TIMESTAMP 및 KC-API-SIGN 등 3개의 헤더가 포함되어야 합니다. 타임스탬프는 KuCoin 서버 시간의 5초 이내여야 합니다.

3. API 키 쌍은 API 관리의 KuCoin 사용자 인터페이스에서 생성되어야 합니다. 권한은 “거래”, “계좌”, “출금” 등 필요한 범위로만 제한되어야 합니다.

4. 비밀 키는 절대로 유선을 통해 전송되지 않습니다. 이는 봇 환경에 대해 로컬로 유지되며 나가는 요청에 서명하는 데에만 사용됩니다.

5. 새로 생성된 API 키에는 기본적으로 IP 화이트리스트가 적용됩니다. 401 승인되지 않은 응답을 피하기 위해 개발자는 신뢰할 수 있는 IP를 미리 등록해야 합니다.

주문 수명주기 관리

1. 주문을 하면 기호, 측면(구매/판매), 유형(제한/시장/중지) 및 크기 또는 가격과 같은 매개변수가 있는 POST /api/v1/orders 엔드포인트를 사용합니다.

2. 시장가 주문에는 크기와 측면만 필요합니다. 제한 주문은 가격과 크기를 모두 요구합니다. Stop 주문에는 stopPrice 및 stop과 같은 추가 필드가 도입됩니다.

3. 활성 주문은 GET /api/v1/orders?status=active 를 통해 쿼리할 수 있으며, 주문 ID, 상태, 채워진 크기 및 남은 크기가 포함된 페이지가 매겨진 결과를 반환합니다.

4. 단일 주문을 취소하려면 DELETE /api/v1/orders/{order-id} 를 사용하고, 대량 취소는 DELETE /api/v1/orders?symbol=BTC-USDT 를 사용하여 여러 ID를 대상으로 합니다.

5. 주문 실행 상태는 WebSocket 피드를 통해 추적되거나 수수료 금액 및 타임스탬프를 포함한 거래 내역을 반환하는 GET /api/v1/fills 엔드포인트 폴링을 통해 추적됩니다.

시장 데이터 통합

1. 공개 티커 데이터는 GET /api/v1/market/orderbook/level2_20?symbol=BTC-USDT를 통해 검색되어 가격, 크기 및 시퀀스 번호가 포함된 상위 20개 입찰/요구 수준을 제공합니다.

2. 실시간 업데이트는 KuCoin의 WebSocket v2 채널 /market/ticker:{symbol} 을 통해 지원됩니다. 여기서 클라이언트는 주제 및 privateChannel 플래그가 포함된 JSON 메시지를 사용하여 구독합니다.

3. 과거 클라인 데이터는 GET /api/v1/market/candles?symbol=ETH-USDT&interval=1min&startAt=1698777600&endAt=1698781200 으로 가져오며 1분에서 1일까지의 간격을 지원합니다.

4. baseCurrency, quoteCurrency, PriceIncrement 및 minSize 제약 조건을 포함하여 기호 목록 및 거래 쌍 세부 정보는 GET /api/v2/symbols 에서 확인할 수 있습니다.

5. 깊이 스냅샷에는 델타 동기화를 활성화하는 시퀀스 번호가 포함됩니다. 고객은 누락된 업데이트나 오래된 주문서 상태를 방지하기 위해 순서 연속성을 검증해야 합니다.

속도 제한 및 오류 처리

1. KuCoin은 엄격한 속도 제한을 적용합니다. 즉, 표준 API 키의 공개 엔드포인트에 대해 초당 100개 요청, 프라이빗 엔드포인트에 대해 초당 20개 요청입니다.

2. 한도를 초과하면 필수 백오프 기간(밀리초)을 나타내는 Retry-After 헤더가 포함된 HTTP 429 응답이 트리거됩니다.

3. 일반적인 오류 코드에는 400(잘못된 매개변수), 401(인증 실패), 403(권한 부족), 404(기호를 찾을 수 없음) 등이 있습니다.

4. 모든 오류 응답에는 코드, 메시지 및 때로는 제안 필드가 포함된 표준화된 JSON 본문이 포함되어 있습니다(예: {'code':'400100','msg':'잘못된 기호'} ) .

5. 중복 제출을 방지하기 위해 주문하려면 멱등성 키가 필요합니다. 이는 KC-API-REQ-ID 헤더에 전송된 고유한 UUID여야 합니다.

자주 묻는 질문

Q: 여러 봇 인스턴스에서 동일한 API 키를 사용할 수 있습니까? A: 예. 하지만 속도 제한을 초과하는 동시 요청으로 인해 제한이 발생합니다. 공유 키도 손상될 경우 보안 위험을 증가시킵니다.

Q: 타임스탬프와 비밀번호가 정확하더라도 서명된 요청이 "잘못된 서명"을 반환하는 이유는 무엇입니까? A: 대부분 잘못된 문자열 정규화로 인해 발생합니다. 즉, 구성 요소 간 개행 문자 누락, 요청 본문의 부적절한 UTF-8 인코딩 또는 프리해시 문자열의 후행 공백입니다.

Q: WebSocket 연결은 상태 재동기화를 통한 재연결을 지원합니까? 답변: 예, KuCoin은 모든 메시지에 일련 번호를 제공합니다. 다시 연결되면 클라이언트는 새 스냅샷을 요청하고 마지막으로 처리된 것보다 시퀀스 번호가 낮은 메시지를 삭제해야 합니다.

Q: 동일한 REST API를 통해 마진 또는 선물 거래가 지원됩니까? A: 아니요. 마진 및 선물 작업에는 별도의 API 기반( https://api.kucoin.com/api/v1/margin 및 https://futures.kucoin.com/api/v1/contracts/active )이 필요하며 각각 고유한 인증 및 엔드포인트가 있습니다.