Bybit API를 사용하는 방법?

BYBIT API를 사용하면 Secure REST 및 WebSocket 엔드 포인트를 통해 자동 거래, 실시간 데이터 스트리밍 및 위치 관리가 가능합니다.

2025/08/04 23:42

BYBIT API 및 사용 사례를 이해합니다

Bybit API는 트레이더와 개발자가 Bybit의 거래 플랫폼과 프로그래밍 방식으로 상호 작용할 수있는 강력한 인터페이스입니다. 거래 전략 자동화, 실시간 시장 데이터 검색, 주문 배치, 위치 관리 및 계정 잔액 모니터링을 가능하게합니다. API는 RESTFUL 및 WEBSOCKE 프로토콜을 모두 지원하여 다양한 사용 사례에 유연성을 제공합니다. REST API는 주문 또는 확인 잔액 배치와 같은 일회성 요청에 이상적이며 WebSocket은 라이브 가격 업데이트 또는 주문서 변경과 같은 지속적인 데이터 스트리밍에 가장 적합합니다. API를 사용하기 전에 사용자는 인증 자격 증명 역할을하는 Bybit 계정에서 API 키를 생성해야합니다.

Bybit API 키 생성

Bybit API를 사용하려면 먼저 API 키를 만들어야합니다. 이 프로세스는 Bybit Account Dashboard 내에서 직접 수행됩니다. 프로필 설정에서 API 관리 섹션으로 이동하십시오. API Key의 이름을 입력하고 IP 제한을 설정하라는 메시지가 표시되는 API 만들기를 클릭하십시오. IP 화이트리스트는 지정된 IP 주소에 대한 API 액세스를 제한하여 보안을 향상시킵니다. 필요한 세부 정보를 입력 한 후 Bybit은 API 키 와 비밀 키라는 자격 증명 쌍을 생성합니다. 초기 생성 후 비밀 키가 다시 표시되지 않으므로 이들은 안전하게 저장해야합니다. 이러한 키를 공유하거나 클라이언트 측 코드에 노출하지 마십시오.

요청에 대한 API 인증 구성

BYBIT API의 모든 개인 엔드 포인트에는 API 키 및 비밀 키를 사용한 인증이 필요합니다. 인증은 HMAC SHA256 서명을 통해 구현됩니다. 각 요청에는 특정 헤더가 포함되어야합니다.

• X-BAPI-API-KEY : API 키
• x-bapi-sign : 생성 된 서명
• X-BAPI-TIMESTAMP : 밀리 초의 현재 타임 스탬프
• X-BAPI-RECV-WINDOW : 선택 사항, 요청 유효성의 시간 창을 정의합니다 (기본값은 5000ms)

x-bapi-sign을 생성하려면 요청 매개 변수를 특정 순서 (Timestamp + API_Key + recv_window + query_string)로 연결하고 비밀 키와 함께 HMAC SHA256을 사용하여 해시하십시오. 대부분의 프로그래밍 언어는이를 위해 내장 라이브러리를 제공합니다. 예를 들어, 파이썬에서는 hmac 및 hashlib 모듈을 사용하십시오. 서명 오류를 피하기 위해 타임 스탬프가 Bybit의 서버 시간과 동기화되도록하십시오.

REST API를 사용하여 주문 배치

Bybit API를 통해 거래를하려면 /v5/order/create 와 같은 적절한 종말점으로 게시물 요청을 보내십시오. 필요한 매개 변수는 다음과 같습니다.

• 기호 : 거래 쌍, 예를 들어, btcusdt
• 측면 : 구매 또는 판매
• OrderType : 제한 , 시장 또는 중지 와 같은
• 수량 : 거래의 수량
• 가격 : 한도 주문에 필요합니다
• TimeInforce : 실행 지침을 지정합니다 (예 : GTC )

요청을 보내기 전에 모든 매개 변수가 올바르게 형식화되어 서명 계산에 포함되어 있는지 확인하십시오. 성공적인 응답은 OrderID , OrderLinkid 및 상태를 포함하는 JSON 객체를 반환합니다. 실행을 확인하기 위해 항상 응답 코드와 메시지를 확인하십시오. OrderLinkid를 사용하여 후속 쿼리에서 주문을 추적하십시오.

WebSocket을 사용하여 실시간 데이터를 스트리밍합니다

알고리즘 거래 봇 또는 시장 모니터링 대시 보드와 같은 라이브 업데이트가 필요한 응용 프로그램의 경우 Bybit의 WebSocket API가 필수적입니다. USDT Perpetual Contracts의 WebSocket Endpoint : wss://stream.bybit.com/v5/public/linear 에 연결하십시오. 연결을 설정 한 후 구독 메시지 형식을 사용하여 주제를 구독하십시오. 예제는 다음과 같습니다.

• OrderBookl2_25.BTCUSDT : 상위 25 개 주문서 레벨
• Tickers.btCusDT : 실시간 티커 데이터
• 캔들 .1.BTCUSDT : 1 분 촛대 데이터
• publictrade.btcusdt : 최근 거래

받은 각 메시지에는 주제 필드와 데이터 페이로드가 포함됩니다. 그에 따라 JSON 응답을 구문 분석합니다. 위치 또는 잔액 업데이트와 같은 개인 데이터의 경우 개인 엔드 포인트에 별도의 WebSocket 연결을 설정하고 REST와 유사한 인증 헤더를 포함하십시오.

API를 통한 위치 및 위험 관리

BYBIT API를 사용하면 열린 위치를 완전히 제어 할 수 있습니다. 현재 위치를 검색하려면 GET 요청을 /v5/position/list 로 보내십시오. 응답에는 크기 , EntryPrice , UnrealizedPNL 및 레버리지가 포함됩니다. 스톱 손실 또는 테이크 비영리 레벨 조정과 같은 위치를 수정하려면 /v5/position/trading-stop 엔드 포인트를 사용하십시오. 필수 매개 변수 :

• 상징
• STOPLOSS : 스톱 손스 가격
• TakeProfit : Take-Profit Price

이러한 값이 허용 가능한 가격 범위 내에 있고 계정 활용 설정 내에 있는지 확인하십시오. 직책을 닫으려면 동일한 수량의 상대 시장 주문을 배치하십시오. 예를 들어, 구매 위치 1 BTC를 보유한 경우 1 BTC의 판매 시장 주문을 보내십시오. 다음 위치 쿼리에서 업데이트 된 위치 크기를 확인하여 폐쇄를 확인하십시오.

자주 묻는 질문

Bybit API Secret Key를 어떻게 재설정합니까?

Bybit은 비밀 키를 직접 재설정 할 수 없습니다. 기존 API 키를 삭제하고 새 키를 만들어야합니다. API 관리 로 이동하고, 키를 찾고, 삭제를 클릭하고, 조치 확인을 확인한 다음 새 키 쌍을 생성합니다. 새 자격 증명으로 응용 프로그램을 즉시 업데이트하십시오.

IP 제한없이 Bybit API를 사용할 수 있습니까?

그렇습니다. 그러나 그것은 매우 낙담합니다. IP 제한을 비활성화하면 API 키가 잠재적 오용에 노출됩니다. 비활성화 해야하는 경우 응용 프로그램에서 암호화 된 스토리지 및 최소한의 권한 범위와 같은 추가 보안 계층을 사용하는지 확인하십시오.

BYBIT API에는 어떤 요율 제한이 적용됩니까?

Bybit은 학대를 방지하기 위해 요금 제한을 시행합니다. 나머지 API는 IP 당 초당 최대 60 개의 요청을 허용합니다. WebSocket Connections는 연결 당 최대 24 개의 구독을 지원합니다. 한계를 초과하면 429 오류가 발생합니다. 여러 IP에 대한 요청을 배포하거나 가능한 경우 배치를 사용하십시오.

왜 "유효하지 않은 서명"오류가 발생합니까?

이는 일반적으로 잘못된 매개 변수 순서, 타임 스탬프 불일치 또는 잘못된 해싱 메소드로 인해 발생합니다. 타임 스탬프가 X-BAPI-Timestamp 헤더와 일치하고 매개 변수가 사전으로 정렬되며 HMAC SHA256이 올바른 비밀 키와 함께 사용되는지 확인하십시오. /v5/user/query-api 와 같은 간단한 엔드 포인트로 테스트하여 문제를 분리하십시오.