계약 거래에 Bybit API를 사용하는 방법은 무엇입니까?

Bybit API를 사용하면 안전 인증, WebSocket을 통한 실시간 데이터 및 USDT 및 역 계약에 대한 전체 주문 관리와 함께 자동 계약 거래를 할 수 있습니다.

2025/08/11 13:01

계약 거래를위한 Bybit API 이해

Bybit API는 거래자가 BYBIT Exchange에서 계약 거래 전략을 자동화 할 수있는 강력한 도구입니다. API를 활용하여 사용자는 프로그래밍 방식으로 주문을 배치하고 위치 관리하고 시장 데이터를 검색하며 계정 상태를 모니터링 할 수 있습니다. 처음에는 Bybit이 실시간 상호 작용을 위해 RESTFUL API 및 WEBSOCKE API를 지원한다는 것을 이해해야합니다. 계약 거래에 대한 API 엔드 포인트는 특히 USDT 영구, 역 영구 및 선물 계약 에 맞게 조정됩니다. 통합하기 전에 거래하려는 계약 유형에 따라 올바른 API 문서에 액세스하고 있는지 확인하십시오.

시작하려면 Bybit 계정 설정으로 이동하여 API 키를 생성하십시오. 이 과정에서 '주문', '자산'및 '읽기 전용'과 같은 권한을 정의해야합니다. 계약 거래의 경우 '주문'및 '위치'권한이 모두 필요합니다. 클라이언트 측 코드 또는 공개 리포지토리에 비밀 키를 노출시키지 마십시오. API 호출을 할 때는 항상 HTTPS를 사용하여 안전한 커뮤니케이션을 보장하십시오.

API 자격 증명을 설정합니다

Bybit API를 효과적으로 사용하려면 먼저 API 키를 생성하고 구성해야합니다. Bybit 계정에 로그인하고 프로필 아래의 API 관리 섹션으로 이동하십시오. API 만들기를 클릭 한 다음 쉽게 식별하려면 키에 이름을 할당하십시오. 권한을 설정할 때 :

• 거래 허가를 통해 주문 배치 및 취소를 허용합니다
• 오픈 포지션에 액세스하고 설정을 활용할 수있는 위치 권한 활성화
• 보안 위험을 줄이는 데 절대적으로 필요하지 않는 한 철수를 제한하십시오

생성 후 API 키 , 비밀 키 및 사용자 ID의 세 가지 중요한 구성 요소가 제공됩니다. 이것들을 단단히 보관하십시오. 또한 특정 IP 주소에 대한 API 액세스를 제한하여 보안을 향상시키기 위해 IP 제한을 설정할 수도 있습니다. IP가 변경되면 그에 따라 화이트리스트를 업데이트해야합니다. Bybit은 인증을 위해 HMAC-SHA256을 사용하므로 요청에 제대로 서명 된 메시지가 포함되어야합니다.

API 요청을 인증합니다

Bybit에 대한 모든 개인 API 요청은 API 키 및 비밀 키를 사용하여 인증해야합니다. 인증 프로세스에는 HMAC-SHA256 해싱을 사용하여 서명을 생성하는 것이 포함됩니다. 서명 할 문자열에는 일반적으로 HTTP 메소드, 요청 경로, 쿼리 매개 변수 및 타임 스탬프가 포함됩니다. 재생 공격을 방지하려면 타임 스탬프는 서버 시간의 5 초 이내에 있어야합니다.

서명을 구성하는 방법은 다음과 같습니다.

• 요청 메소드 (예 : Post), 요청 경로 (예 :/v5/order/create) 및 쿼리 문자열 (있는 경우)을 연결하십시오.
• HMAC-SHA256을 사용하여 연결된 문자열을 해시하려면 비밀 키를 사용하십시오.
• 결과를 16 진 형식 으로 인코딩하십시오
• 요청 헤더에 서명을 X-BAPI-SIGN 으로 포함시킵니다

추가 헤더에는 X-BAPI-API-KEY , X-BAPI-TIMESTAMP 및 X-BAPI-RECV-WINDOW (선택 사항, 기본 5000ms)가 포함됩니다. 타임 스탬프 또는 서명이 잘못되면 인증 실패가 발생합니다. 항상 시스템 클럭이 NTP 서버와 동기화되어 있는지 확인하십시오.

계약 주문 배치 및 관리

Bybit API를 통해 계약 주문을하려면 /v5/order/create endpoint를 사용하십시오. 기호 , 측면 (구매 또는 판매), OrderType (한도, 시장 등), 수량 및 가격 (제한 주문)과 같은 필수 매개 변수를 포함해야합니다. USDT-Margined Contracts 의 경우 기호 형식은 BTCUSDT 입니다. 역 계약 의 경우 BTCUSD 입니다.

고려해야 할 주요 매개 변수 :

• TimeInforce : 옵션에는 GoodtillCancel, InderiateOrcancel, Fillorkill이 포함됩니다
• READENLY : 순서가 위치 크기 만 줄어드는지 확인하기 위해 TRUE로 설정
• CloseOntrigger : 스톱 손실 또는 테이크 비영리 주문에 유용합니다
• PositionIdx : 헤지 모드에 필요합니다. 일방 통과의 경우 0, 길이는 1, 짧은 경우 2

주문을 취소하려면 OrderID 또는 OrderLinkid 와 함께 /v5/Order/Calect Endpoint를 사용하십시오. 활성 주문을 검색하려면 /V5/Order/Realtime을 사용하십시오. 위치 관리의 경우 /v5/위치/목록 엔드 포인트는 크기 , 입력 가격 및 레버리지 를 포함한 현재 위치를 반환합니다. /v5/위치/세트 레버리지를 사용하여 레버리지를 조정하십시오.

시장 및 계정 데이터 검색

실시간 시장 데이터는 사전 거래 결정에 중요합니다. Bybit 은이 목적을 위해 몇 가지 공개 엔드 포인트를 제공합니다. /V5/Market/Tickers를 사용하여 모든 계약의 최신 가격, 자금 조달 요금 및 24 시간 볼륨을 얻습니다. 주문서 데이터의 경우 기호 및 깊이 매개 변수 (예 : 1, 5, 50 레벨)와 함께 /v5/Market/Orderbook을 사용하십시오. 역사적 촛대 데이터를 가져 오려면 범주 , 기호 , 간격 및 시작/종료 시간 과 함께 /V5/Market/Kline을 사용하십시오.

계정 관련 데이터의 경우 /v5/계정/지갑 균형 엔드 포인트는 모든 코인에서 지갑 균형을 반환합니다. /V5/Account/Info를 사용하여 총 자본 및 사용 가능한 잔액을 포함한 전체 계정 세부 정보를 얻습니다. 최근 주문 채우기를 모니터링하려면 /V5/Order/Execution-List를 사용하십시오. 이것은 가격 , 수량 , 수수료 및 엑시 타로 실행 된 거래를 반환합니다.

실시간 업데이트를위한 WebSocket 구현

저도 거래의 경우 REST 엔드 포인트를 폴링하는 대신 Bybit의 WebSocket API를 사용하십시오. USDT 계약 또는 wss : wss://stream.bybit.com/v5/public/linear wss://stream.bybit.com/v5/public/inverse 에 연결하십시오. 실시간 데이터를 구독하려면 OP 필드가 '구독'으로 설정된 JSON 메시지와 orderBookL2_25.BTCUSDT , tickers.BTCUSDT 또는 candle.1.BTCUSDT 와 같은 주제를 포함하는 Args 배열을 보내십시오.

주문 업데이트 및 위치 변경과 같은 개인 데이터의 경우 WebSocket 연결을 인증하십시오. API 키 , 타임 스탬프 및 서명 으로 인증 요청을 보내십시오. 인증을 받으면 order , position 및 execution 주제를 구독하여 라이브 업데이트를 받으십시오. WebSocket 메시지는 Zlib을 사용하여 압축되므로 구문 분석하기 전에 압축 해제하십시오.

자주 묻는 질문

Bybit API의 요금 제한은 얼마입니까?

Bybit은 학대를 방지하기 위해 요금 제한을 시행합니다. REST API의 경우 한도는 일반적으로 API 키 당 초당 60 개의 요청 입니다. 이를 초과하면 HTTP 429 오류가 발생합니다. WebSocket 연결은 처리량이 높을 수 있지만 가입 계수 및 메시지 빈도에 따라 제한이 적용됩니다.

"잘못된 서명"과 같은 API 오류를 어떻게 처리합니까?

비밀 키가 정확하고 다듬 지 않은지 확인하십시오. 서명 문자열에 정확한 메소드, 경로 및 매개 변수가 포함되어 있는지 확인하십시오. 타임 스탬프가 Bybit의 서버 시간의 5 초 이내에 있는지 확인하십시오. https://api.bybit.com/v5/market/time 사용하여 현재 서버 시간을 가져 오십시오.

그리드 거래 또는 DCA 봇에는 Bybit API를 사용할 수 있습니까?

예, API는 자동 전략을 지원합니다. /v5/order/order/roop에서 다양한 가격과 수량을 가진 루프로 작성하십시오 . 오래된 주문을 취소하고 시장 조건에 따라 위치를 조정하는 논리를 구현하십시오. 봇이 자금 조달 요금 지불 및 청산 위험을 처리하는지 확인하십시오.

TestNet은 API 계약 거래에 사용할 수 있습니까?

예, Bybit은 https://api-testnet.bybit.com 에서 Testnet 환경을 제공합니다. 실제 자금을 위험에 빠뜨리지 않고 거래를 시뮬레이션하는 데 사용하십시오. TestNet에 대해 별도의 API 키를 생성하십시오. 모든 엔드 포인트는 라이브 환경을 반영하여 전체 전략 테스트를 허용합니다.