Bybit API 키로 맞춤형 거래 봇을 사용할 수 있나요?

API 통합 기능

1. Bybit는 주문 접수, 포지션 관리, 계좌 잔고 조회, 시장 데이터 스트리밍을 지원하는 REST 및 WebSocket API를 제공합니다.

2. 개발자는 API 관리 섹션의 Bybit 사용자 인터페이스를 통해 API 키를 등록할 수 있습니다.

3. 각 API 키에는 운영 요구 사항에 따라 읽기 전용, 거래 또는 출금 액세스와 같은 특정 권한이 할당되어야 합니다.

4. 보안을 위해 IP 화이트리스트가 시행됩니다. 사전 승인된 IPv4 주소에서 발생한 요청만 허용됩니다.

5. HMAC-SHA256을 사용한 서명 기반 인증은 요청 무결성을 보장하고 전송 중 변조를 방지합니다.

봇 개발 제약

1. 맞춤형 봇은 Bybit의 속도 제한(프라이빗 엔드포인트의 경우 초당 120개 요청, 퍼블릭 엔드포인트의 경우 60개)을 준수해야 합니다.

2. 주문 실행 지연 시간은 Bybit의 인프라가 아닌 네트워크 상태 및 봇 아키텍처에 따라 다르지만 과도한 재시도는 일시적인 제한을 유발할 수 있습니다.

3. 마진 거래 봇은 레버리지 조정, 포지션 모드 전환(단방향 대 헤지) 및 위험 한도 계층을 명시적으로 처리해야 합니다.

4. 선물 및 무기한 계약은 특히 시간대에 걸쳐 작동할 때 서명 만료 오류를 방지하기 위해 정확한 타임스탬프 동기화를 요구합니다.

5. 웹훅 통합은 기본적으로 지원되지 않습니다. 개발자는 실시간 업데이트를 위해 주문 상태를 폴링하거나 WebSocket 스트림을 사용해야 합니다.

키 처리를 위한 보안 프로토콜

1. API 키는 소스 파일에 하드코딩되거나 GitHub와 같은 버전 제어 시스템에 커밋되어서는 안 됩니다.

2. 자격 증명 저장에는 HashiCorp Vault 또는 AWS Secrets Manager와 같은 환경 변수 또는 보안 저장소가 권장됩니다.

3. 서명 생성에 사용되는 개인 키는 프런트엔드 코드나 클라이언트 측 스크립트에서 액세스할 수 없는 상태로 유지되어야 합니다.

4. 손상된 키의 취소는 Bybit 대시보드 또는 /user/post-api-key-revoke 에 대한 API 호출을 통해 즉각적이고 되돌릴 수 없습니다.

5. API 키 자체에 출금 권한이 없더라도 계정 수준 작업에는 이중 인증이 필수입니다.

규제 및 규정 준수 고려 사항

1. 고주파 전략을 실행하는 봇은 알고리즘 거래의 관할권 정의에 속할 수 있으며 특정 지역에 등록이 필요합니다.

2. Bybit는 선행 거래, 스푸핑, 가장 거래 또는 서비스 약관을 위반하는 모든 활동에 대한 API 사용을 금지합니다.

3. 사용자는 논리 결함, 잘못 구성된 매개변수 또는 사용자 정의 코드의 처리되지 않은 예외 사례로 인해 발생하는 손실에 대해 전적인 책임을 져야 합니다.

4. 외부 봇이 관리하는 교차 마진 포지션은 Bybit의 마진 콜 기준 및 자동 청산 규칙을 ​​준수해야 합니다.

5. 데이터 상주 정책이 적용됩니다. API는 봇 상호 작용 중에 생성된 로그 또는 메타데이터의 저장 위치를 ​​보장하지 않습니다.

자주 묻는 질문

Q1. 현물 거래와 파생상품 거래에 동일한 API 키를 사용할 수 있나요? 예, 생성 중에 두 카테고리 모두에 대한 권한이 키에 부여된 경우에 한합니다. 권한은 키 생성 시 설정되며 이후에는 수정할 수 없습니다.

Q2. Bybit는 계정 인증 수준에 따라 API 액세스를 제한합니까? 아니요, KYC 상태는 API 기능을 제어하지 않습니다. 그러나 확인되지 않은 계정의 경우 인출 한도가 더 낮으며 특정 계약 유형에 액세스할 수 없습니다.

Q3. 내 봇이 잘못된 서명을 보내면 어떻게 되나요? API는 서명 확인 실패를 나타내는 오류 코드 10004 와 함께 HTTP 401을 반환합니다. 30초를 초과하는 타임스탬프 왜곡도 이 응답을 트리거합니다.

Q4. 테스트넷 API 키는 메인넷 엔드포인트와 호환됩니까? 아니요. 테스트넷 키는 https://api-testnet.bybit.com 에 대해서만 작동합니다. 프로덕션 엔드포인트에서 이를 사용하려고 하면 HTTP 403이 발생합니다.