Bybit API 튜토리얼: 자동 거래를 연결하고 시작하는 방법은 무엇입니까?

Bybit API 인증 이해

1. Bybit에서는 API 관리 섹션의 사용자 계정 대시보드에서 생성된 API 키가 필요합니다. 이러한 키는 요청 서명에 필수적인 API 키와 비밀 키로 구성됩니다.

2. 비밀 키는 클라이언트 측 코드나 공개 저장소에 노출되어서는 안 됩니다. 이는 신원을 확인하고 변조를 방지하기 위해 각 요청에 대해 HMAC-SHA256 서명을 생성하는 데 사용됩니다.

3. 사용자는 키 생성 중에 "주문", "지갑" 또는 "계약" 액세스와 같은 정확한 권한을 할당해야 하며 프로덕션 환경에서 작동하는 경우 IP 주소를 제한해야 합니다.

4. 시간동기화는 필수입니다. 오류 코드 10004와 함께 거부된 요청은 타임스탬프 불일치를 나타냅니다. 시스템은 Bybit의 서버 시간에 비해 시계 드리프트를 30초 미만으로 유지해야 합니다.

5. 모든 엔드포인트에는 공개 키를 포함하는 X-BAPI-API-KEY 헤더와 연결된 매개변수와 비밀에서 파생된 base64 인코딩 서명을 보유하는 X-BAPI-SIGN 헤더가 필요합니다.

REST API 통합 설정

1. 개발자는 일반적으로 요청 라이브러리와 함께 Python을 사용하여 인증된 GET/POST 호출을 구성합니다. 일반적인 예에는 /v5/account/wallet-balance 엔드포인트를 통해 지갑 잔액을 가져오는 것이 포함됩니다.

2. 서명 문자열을 작성할 때 해싱하기 전에 쿼리 매개변수를 알파벳순으로 정렬해야 합니다. Nonce 값은 재생 공격을 방지하기 위해 연속 요청에서 단조롭게 증가해야 합니다.

3. 속도 제한은 엔드포인트마다 다릅니다. 퍼블릭 엔드포인트는 분당 최대 60개의 요청을 허용하고, 프라이빗 엔드포인트는 Bybit의 기관 계층을 통해 업그레이드하지 않는 한 분당 120개로 제한됩니다.

4. 오류 처리는 적절한 대체 논리를 트리거하기 위해 10001(잘못된 API 키), 10002(잘못된 서명) 또는 110001(부족한 마진)과 같은 상태 코드에 대한 JSON 응답을 구문 분석해야 합니다.

5. 세션 재사용으로 성능이 향상됩니다. urllib3의 PoolManager를 통한 지속적인 연결은 빈번한 주문 제출 중에 TCP 핸드셰이크 오버헤드를 줄입니다.

WebSocket 실시간 데이터 스트리밍

1. Bybit는 실시간 시장 데이터, 거래 실행 업데이트, 포지션 변경을 위해 WebSocket v5를 지원합니다. REST와 동일한 API 키 및 서명 방법을 사용하여 단일 인증 프레임으로 연결이 시작됩니다.

2. orderbook.1.BTCUSDT 또는 trade.BTCUSDT 와 같은 주제를 구독하려면 op: 'subscribe' 및 args: ['topic.name']이 포함된 JSON 페이로드를 보내야 합니다.

3. 연결 안정성을 유지하려면 하트비트 핑을 20초마다 전송해야 합니다. 제한 시간 내에 응답하지 않으면 강제 연결 해제 및 재연결 시퀀스가 ​​트리거됩니다.

4. 메시지 압축은 기본적으로 비활성화되어 있지만 대역폭에 민감한 배포를 위해 WebSocket 핸드셰이크 중에 메시지 압축 확장 협상을 통해 활성화할 수 있습니다.

5. 주문장 스냅샷은 먼저 전체 깊이 스냅샷으로 도착한 후 델타 업데이트로 도착합니다. 클라이언트는 상태 비동기화 및 잘못된 가격 책정을 방지하기 위해 이러한 델타를 올바르게 적용해야 합니다.

기본 자동 거래 봇 구축

1. 최소한의 작업 봇은 자격 증명 초기화, 가격 피드를 위한 WebSocket 연결 설정, 주문 배치를 위한 REST 세션 설정으로 시작됩니다.

2. 이동 평균 교차 감지와 같은 전략 로직은 WebSocket 거래 스트림에서 재구성되거나 REST /v5/market/kline을 통해 가져온 틱 수준 OHLCV 데이터에서 실행됩니다.

3. 주문 실행은 측면(매수/판매), orderType(시장/한계) 및 수량 필드에 대한 엄격한 검증과 함께 POST /v5/order/create를 사용합니다. 잘못된 수량 형식은 오류 30089를 반환합니다.

4. 위험 관리에는 제출 전 사용 가능한 마진 확인, 미결 주문 수 제한 확인, 지분율에 따른 최대 포지션 규모 시행 등이 포함됩니다.

5. 로깅은 지연 시간 급증 또는 예상치 못한 채우기 디버깅을 지원하기 위해 원시 요청/응답 페이로드, 타임스탬프 및 실행 지연 시간 측정항목을 캡처해야 합니다.

자주 묻는 질문

Q: 테스트넷과 메인넷에 동일한 API 키를 사용할 수 있나요? A: 아니요. 테스트넷과 메인넷에는 별도의 API 키 생성이 필요합니다. 한 환경에서 생성된 키는 다른 환경에서는 작동하지 않습니다.

Q: 내 봇이 중복된 주문 ID를 보내면 어떻게 되나요? A: Bybit는 오류 코드 110012로 24시간 이내에 중복된 clOrdID 값을 거부하여 우발적인 이중 제출을 방지합니다.

Q: 7일이 지난 과거 거래 내역을 검색할 수 있는 방법이 있나요? A: REST /v5/execution/list는 지난 주의 레코드만 반환합니다. 확장된 아카이브의 경우 사용자는 실시간 작업 중에 자체 인프라에서 거래 로깅을 활성화해야 합니다.

Q: 현물 API와 파생상품 API는 동일한 인증 흐름을 공유합니까? 답: 그렇습니다. 둘 다 동일한 HMAC-SHA256 서명 논리와 헤더 구조를 사용하지만 엔드포인트 경로와 필수 매개변수는 제품 유형에 따라 크게 다릅니다.