Bybit Contracts의 과거 거래 데이터에 액세스하는 방법은 무엇입니까?

Bybit은 API 또는 웹 인터페이스를 통해 과거 계약 거래 데이터를 제공하여 영구 및 선물 계약에 대한 백 테스트 및 분석을 가능하게합니다.

2025/08/13 11:36

Bybit의 역사적 거래 데이터 이해

Bybit Contracts 의 과거 거래 데이터는 가격, 수량, 타임 스탬프, 측 (구매/판매) 및 계약 유형과 같은 정보를 포함하여 실행 된 거래 기록을 나타냅니다. 이 데이터는 기술 분석, 백 테스트 전략 또는 거래 성과 감사에 참여하는 거래자에게 필수적입니다. Bybit은 공식 API 및 웹 인터페이스를 포함한 여러 방법을 통해이 데이터에 대한 액세스를 제공합니다. 이 데이터는 일반적으로 BTCUSD, ETHUSD 및 기타와 같은 다양한 암호 화폐에서 영구 계약 및 선물 계약을 다룹니다.

공공 무역 역사 와 개인 무역 이력을 구별하는 것이 중요합니다. 공개 데이터는 주문서에서 실행 된 모든 거래를 반영하며 모든 사용자가 사용할 수 있습니다. 개인 무역 이력에는 귀하의 계정에서 실행 된 거래 만 포함되며 액세스 권한이 필요합니다. 두 유형의 데이터는 API를 통해 검색 될 때 JSON 형식으로 구성되어 분석 도구로의 통합에 적합합니다.

Bybit API를 통해 공공 무역 기록에 접근

Bybit Contracts에 대한 공공 역사 거래 데이터를 검색하려면 공식 Bybit Rest API 종말점을 사용하십시오.

• API 엔드 포인트 : https://api.bybit.com/v5/market/recent-trade

이 엔드 포인트는 지정된 기호에 대해 최신 거래를 반환합니다. 더 깊은 역사적 기록에 액세스하려면 각 응답에서 반환 된 커서 매개 변수를 사용하여 페이지를 사용해야합니다. 요청을하는 방법은 다음과 같습니다.

• 필요한 매개 변수와 함께 HTTP GET 요청을 사용하십시오.
  • category : USDT 계약의 linear 으로 설정하거나 역 계약의 inverse
  • symbol : 계약, 예를 들어 BTCUSDT 지정하십시오
  • limit : 요청 당 레코드 수 (최대 1000)
  • cursor : 이전 응답의 커서를 사용하여 다음 배치를 가져 오십시오.

Python의 예제 요청 :

 import requests url = 'https://api.bybit.com/v5/market/recent-trade'
 params = {


'category': 'linear', 'symbol': 'BTCUSDT', 'limit': 100
 }
 
응답 = requests.get (url, params = params)
 data = response.json ()

반환 된 JSON에는 가격, 크기, 측면, 시간 및 기호 와 같은 필드가 포함되어 있습니다. 이전 데이터를 검색하려면 next_page_cursor 필드에서 커서를 추출하여 다음 요청에 포함시킵니다.

API 인증을 사용하여 개인 무역 기록 검색

개인 계약 무역 이력에 액세스하려면 인증이 필요합니다. Bybit 계정 설정에서 'Order'및 '읽기'권한을 가진 API 키를 생성해야합니다. 관련 종점은 다음과 같습니다.

• API 엔드 포인트 : https://api.bybit.com/v5/order/execution-list

이 엔드 포인트는 귀하의 계정과 관련된 채워진 계약 주문을 반환합니다. 필요한 매개 변수는 다음과 같습니다.

• category : linear 또는 inverse
• symbol : 예 : BTCUSDT
• start_time 및 end_time : 시간 범위를 정의하는 Unix 타임 스탬프
• limit : 요청 당 최대 50 개의 레코드
• api_key , timestamp 및 sign : 인증 헤더

요청을 생성하는 단계 :

• 밀리 초로 타임 스탬프를 생성하십시오
• API Secret과 함께 HMAC SHA256을 사용하여 서명 생성
• 헤더 포함 : X-BAPI-API-KEY , X-BAPI-TIMESTAMP , X-BAPI-SIGN

서명을위한 Python 코드 예제 :

 import hmac
 import time api_key = 'Your_api_key'
 api_secret = 'your_api_secret'
 timestamp = str (int (time.time () * 1000))


param_str = f'category = linear & symbol = btcusdt & limit = 50 & start_time = 1700000000000 & end_time = 1701000000000 '
 signature = hmac.new (api_secret.encode (), param_str.encode (), digestmod = 'sha256'). hexDigest ()

헤더 = {

'X-BAPI-API-KEY': api_key, 'X-BAPI-TIMESTAMP': timestamp, 'X-BAPI-SIGN': signature
 }
 
응답 = requests.get (url, params = params, 헤더 = 헤더)

각 레코드에는 exec_price, exec_qty, side, fee 및 order_id가 포함됩니다.

무역 이력에 Bybit 웹 인터페이스 사용

API를 사용하지 않는 사용자의 경우 Bybit은 개인 계약 무역 이력을 볼 수있는 웹 기반 인터페이스를 제공합니다. Bybit 계정에 로그인하고 다음으로 탐색하십시오.

• 파생 상품 → 주문 → 무역사

여기, 당신은 할 수 있습니다 :

• 선형 계약 또는 역 계약을 선택하십시오
• 드롭 다운에서 특정 기호를 선택하십시오
• 날짜 범위 별로 필터
• CSV 형식으로 한 번에 최대 100 개의 레코드를 내보내기

표시된 열에는 기호, 측면, 수량, 가격, 수수료, 폐쇄 된 PNL 및 시간이 포함됩니다. 웹 인터페이스는 한 번의 클릭으로 모든 과거 데이터의 대량 내보내기를 허용하지 않습니다. 날짜를 통해 수동으로 페이지를 찍고 필요한 경우 여러 CSV 파일을 다운로드해야합니다.

과거 데이터 처리 및 저장

검색되면 역사적 무역 데이터는 분석을 위해 저장해야합니다. 권장 형식에는 CSV, Parquet 또는 데이터베이스 테이블이 포함됩니다. 연속 데이터 수집의 경우 정기적으로 API를 호출하고 새로운 레코드를 추가하는 CRON 작업 또는 스크립트를 설정하십시오.

주요 고려 사항 :

• 요금 제한 : Bybit은 공개 엔드 포인트에 대해 분당 60 개의 요청을, 개인의 경우 120을 허용합니다.
• 데이터 중복 제거 : Exec_id 또는 Trade_Time을 고유 식별자로 사용합니다.
• 시간대 처리 : 모든 타임 스탬프는 UTC에 있습니다
• 데이터 보존 : Bybit은 웹 인터페이스에서 최대 6 개월 동안 개인 무역 이력을 유지하지만 API 액세스는 계정 활동에 따라 이전 데이터를 검색 할 수 있습니다.

구조화 된 디렉토리에 데이터 저장 :

 /trade_data/
 /public/ btcusdt_20231201.csv

/사적인/

my_trades_20231201.csv

Python에서 판다를 사용하여 병합 및 분석하십시오.

import pandas as pd

df = pd.read_csv ( 'btcusdt_20231201.csv')
df [ 'time'] = pd.to_dateTime (df [ 'time'], unit = 'ms')

자주 묻는 질문

Bybit의 계약 무역 이력은 얼마나 거슬러 올라 갑니까?

Bybit의 공개 API는 일반적으로 최근 recent-trade 종점에서 최대 7 일 동안 최근의 거래 데이터를 유지합니다. 구형 공개 데이터의 경우 타사 애그리 게이터 또는 사용자 정의 데이터 수집 스크립트가 필요합니다. 개인 무역 기록은 개인 무역 이력을 계정 생성 날짜와 Bybit의 내부 보존 정책에 따라 몇 달을 거슬러 올라갈 수 있습니다.

백 테스트를위한 진드기 수준의 히스토리 데이터를 얻을 수 있습니까?

예, /v5/market/recent-trade 엔드 포인트는 거래 당 가격 및 거래량을 포함한 진드기 수준 데이터를 제공합니다. 완전한 진드기 이력을 구축하려면 API를 지속적으로 폴링하거나 WebSocket 스트림 ( publicTrade Topic)을 사용하여 실시간 거래를 캡처하고 저장해야합니다.

개인 데이터에 액세스 할 때 "유효하지 않은 서명"오류가 발생하는 이유는 무엇입니까?

이 오류는 HMAC 서명이 일치하지 않을 때 발생합니다. 매개 변수 문자열이 알파벳순으로 올바르게 정렬되어 있는지 확인하고 타임 스탬프는 밀리 초이며 API 비밀이 올바르게 입력됩니다. 또한 HTTP 메소드 (get/post)가 엔드 포인트에 대한 예상 형식과 일치하는지 확인하십시오.

만료 된 선물 계약에 대한 과거 데이터가 이용 가능합니까?

예, 만료 된 선물 계약 에 대한 역사적 무역 데이터는 계약의 활성 기간 동안 사용되는 올바른 기호 이름을 지정하여 API를 통해 액세스 할 수 있습니다. 예를 들어, 2023 년 12 월 BTC 역 미래의 BTCUSD231229 . category=inverse 및 적절한 기호와 함께 동일한 API 엔드 포인트가 적용됩니다.