Bybit에서 API 거래를 사용하는 방법은 무엇입니까? 개발자 초보자 가이드

API 액세스 및 키 관리

1. 공식 웹사이트나 데스크톱 애플리케이션을 통해 Bybit 계정에 로그인하세요.

2. 계정 설정 → API 관리 → API 키 생성으로 이동합니다.

3. 설명이 포함된 이름을 지정하고, IP ​​화이트리스트 제한을 선택하고, '읽기 전용', '거래', '철회' 등 필요한 권한만 활성화합니다.

4. 2FA를 사용하여 생성을 확인합니다. API 키와 API 비밀을 모두 암호화된 저장소에 오프라인으로 저장합니다.

5. 프런트엔드 코드, 브라우저 콘솔 또는 공개 저장소에 API 비밀을 노출하지 마십시오.

지원되는 API 버전 및 엔드포인트

1. Bybit V5 REST API는 통합된 구조와 일관된 응답 스키마를 통해 현물, 파생상품 및 자산 엔드포인트를 제공합니다.

2. WebSocket 공개 채널은 주문서 깊이(orderbook.50), 티커(ticker) 및 거래 실행(publicTrade)을 포함한 실시간 시장 데이터를 제공합니다.

3. WebSocket 비공개 채널은 위치 업데이트, 주문 상태 변경, 지갑 잔액 알림 및 실행 보고서를 지원합니다.

4. 통합 거래 계좌 엔드포인트를 통해 수동 자금 이체 없이 현물 및 파생 상품 전반에 걸쳐 교차 마진 운영이 가능합니다.

5. 모든 엔드포인트에는 엄격한 타임스탬프 동기화가 필요합니다. 30초를 초과하는 클럭 왜곡은 거부를 트리거합니다.

인증 워크플로우

1. 각 요청에는 활성 API 키가 포함된 X-BAPI-API-KEY 헤더가 포함되어야 합니다.

2. X-BAPI-SIGN 헤더는 연결된 문자열( timestamp + api_key + recv_window + payload ) 의 HMAC SHA256 해시를 전달합니다.

3. X-BAPI-TIMESTAMP 헤더에는 밀리초 단위의 현재 Unix 타임스탬프가 포함되어 있습니다.

4. X-BAPI-RECV-WINDOW는 서명 검증에 허용되는 시간 창을 정의하며 기본값은 5000ms입니다.

5. 페이로드는 서명하기 전에 공백 없이 JSON으로 직렬화되고 키를 사전순으로 정렬해야 합니다.

속도 제한 및 오류 처리

1. REST API는 퍼블릭 엔드포인트의 경우 API 키당 분당 120개의 요청을 적용하고 프라이빗 엔드포인트의 경우 분당 60개의 요청을 적용합니다.

2. WebSocket 연결은 연결당 100개의 구독으로 제한됩니다. 초과하면 자동 연결 끊김이 발생합니다.

3. HTTP 429 응답은 속도 제한이 소진되었음을 나타냅니다. 클라이언트는 지수 백오프 및 지터를 구현해야 합니다.

4. 일반적인 오류 코드에는 10001(잘못된 서명), 10002(만료된 타임스탬프) 및 30087(여백 부족)이 포함됩니다.

5. 모든 오류 본문에는 retCode, retMsg 및 디버깅을 위한 orderId 또는 기호와 같은 추가 컨텍스트 필드가 포함되어 있습니다.

자주 묻는 질문

Q: 테스트넷과 메인넷에 동일한 API 키를 사용할 수 있나요? 아니요. 테스트넷과 메인넷에는 해당 도메인에서 생성된 별도의 API 키가 필요합니다. https://api-testnet.bybit.com에서 발급된 키는 프로덕션에서는 유효하지 않습니다.

Q: Bybit는 주문 작성을 위한 Webhook 통합을 지원합니까? 아니요. Bybit는 웹훅 전달을 제공하지 않습니다. 클라이언트는 채우기 확인을 위해 지속적인 WebSocket 연결을 유지하거나 REST 엔드포인트를 폴링해야 합니다.

Q: 프로그래밍 방식으로 API 키를 취소할 수 있습니까? 예. 유효한 인증으로 DELETE /v5/user/api-key 엔드포인트를 사용하십시오. 작업에는 대상 키의 ID가 필요하며 실행 취소할 수 없습니다.

Q: Bybit에서 공식적으로 관리하는 Python 또는 JavaScript용 SDK가 있습니까? Bybit는 GitHub에서 커뮤니티 지원 SDK를 제공하지만 공식적으로 유지 관리되는 언어별 라이브러리를 게시하거나 보증하지 않습니다. 개발자는 제3자가 관리하는 pybit 및 bybit-api 패키지를 사용합니다.