Bybit에서 API 트랜잭션 레코드를 보는 방법은 무엇입니까? 거래 수에 제한이 있습니까?

Bybit의 API를 통해 사용자는 속도 및 과거 데이터 액세스에 대한 제한이있는/v2/private/wallet/transaction-log endpoint를 사용하여 트랜잭션 레코드를 검색 할 수 있습니다.

2025/05/19 07:07

Bybit은 거래 전략을 자동화하거나 프로그래밍 방식으로 포트폴리오를 관리하려는 거래자에게 강력한 API 서비스를 제공하는 인기있는 암호 화폐 거래소입니다. 사용자가 API를 통해 종종 액세스 해야하는 주요 기능 중 하나는 트랜잭션 레코드입니다. 이 기사에서는 BYBIT에서 API 트랜잭션 레코드를 보는 프로세스를 안내하고 검색 할 수있는 트랜잭션 수에 대한 제한 사항을 논의합니다.

Bybit의 API 이해

트랜잭션 레코드 검색의 세부 사항을 다이빙하기 전에 Bybit의 API의 기본 사항을 이해하는 것이 필수적입니다. Bybit의 API를 통해 사용자는 프로그래밍 방식으로 플랫폼과 상호 작용할 수 있습니다. 여기에는 거래 실행, 주문 관리 및 거래 레코드와 같은 다양한 데이터 가져 오기가 포함됩니다. API는 안전하고 효율적으로 설계되어 사용자가 계정을 효과적으로 관리 할 수 ​​있도록 설계되었습니다.

API 액세스

Bybit의 API 사용을 시작하려면 API 키를 설정해야합니다. 다음은 다음과 같습니다.

• Bybit 계정에 로그인하십시오 .
• API 관리 섹션으로 이동하십시오 . 일반적으로 계정 설정 또는 사용자 프로필 섹션에서 찾을 수 있습니다.
• 새 API 키를 만듭니다 . 키의 이름을 제공하고 필요에 따라 설정 권한을 설정해야합니다.
• API 키와 비밀을 저장하십시오 . 이들은 API 요청을 인증하는 데 사용됩니다.

거래 레코드 검색

API 키를 설정하면 트랜잭션 레코드 검색 요청을 시작할 수 있습니다. Bybit의 API는 트랜잭션 데이터를 가져 오도록 특별히 설계된 엔드 포인트를 제공합니다. 당신이 사용할 끝점은 /v2/private/wallet/transaction-log 입니다.

이 엔드 포인트를 요청하는 방법은 다음과 같습니다.

• 귀하의 요청을 준비하십시오 . 요청 헤더에 API 키와 비밀을 포함시켜야합니다.
• 매개 변수를 지정합니다 . currency , start_date , end_date 및 exec_type 와 같은 매개 변수를 지정하여 트랜잭션 레코드를 필터링 할 수 있습니다. 이 매개 변수는 관심있는 거래에 대한 결과를 좁히는 데 도움이됩니다.
• 요청을 보내십시오 . Postman과 같은 도구를 사용하거나 선호하는 프로그래밍 언어로 스크립트를 작성하여 Bybit의 API 서버로 요청을 보냅니다.

다음은 requests 도서관을 사용하여 Python에서 요청이 어떻게 보일지에 대한 예입니다.

 import requests
 import time api_key = 'Your_api_key'
 api_secret = 'your_api_secret'
 base_url = 'https://api.bybit.com'
 endpoint = '/v2/private/wallet/transaction-log'


매개 변수를 준비하십시오
 params = {

'currency': 'BTC', 'start_date': '2023-01-01', 'end_date': '2023-01-31', 'exec_type': 'Deposit'
 }
 
타임 스탬프를 생성하십시오
 timestamp = int (time.time () * 1000)
 
헤더를 준비하십시오
 헤더 = {
 
'Content-Type': 'application/json', 'api_key': api_key, 'timestamp': str(timestamp), 'sign': generate_signature(api_secret, timestamp, params) # You need to implement the generate_signature function
 }
 
요청을 보내십시오
 응답 = requests.get (base_url + endpoint, 헤더 = 헤더, params = params)
 
응답을 처리하십시오
 if response.status_code == 200 :
 
print(response.json())
 또 다른:
 
print(f'Error: {response.status_code}')
 응답 이해
 트랜잭션 레코드를 성공적으로 검색하면 Bybit의 API는 요청 된 데이터가 포함 된 JSON 응답을 반환합니다. 응답에는 id , time , currency , amount , type 및 status 와 같은 필드가 포함됩니다. 거래 기록을 이해하기 위해이 데이터를 올바르게 구문 분석하는 것이 중요합니다.
 
다음은 응답이 어떻게 보일지에 대한 예입니다.
 
{
 'ret_code': 0,
 'ret_msg': 'ok',
 'ext_code': '',
 'ext_info': '',
 '결과': {
 
'data': [ { 'id': '123456', 'time': '2023-01-05T12:34:56Z', 'currency': 'BTC', 'amount': '0.1', 'type': 'Deposit', 'status': 'Success' }, { 'id': '123457', 'time': '2023-01-10T12:34:56Z', 'currency': 'BTC', 'amount': '0.2', 'type': 'Withdrawal', 'status': 'Success' } ]
 }
 }

거래 기록에 대한 제한

Bybit은 API를 통해 검색 할 수있는 트랜잭션 수에 특정 한도를 부과합니다. 이러한 한도는 학대를 방지하고 플랫폼 리소스의 공정한 사용을 보장하기 위해 마련되었습니다. 명심해야 할 몇 가지 핵심 사항은 다음과 같습니다.

• 요금 제한 : Bybit은 API 요청에 대한 요금 제한이 있습니다. 예를 들어, 분당 특정 수의 요청으로 제한 될 수 있습니다. 이러한 제한을 초과하면 API 키가 일시적으로 차단 될 수 있습니다.
• Pagination : Bybit은 거래 레코드를 검색 할 때 Pagination을 사용하여 대형 데이터 세트를 관리합니다. 각 응답에서 반환 된 레코드 수를 제어하기 위해 limit 매개 변수를 지정하고 page 매개 변수를 사용하여 여러 페이지의 결과를 탐색 할 수 있습니다.
• 역사적 데이터 : 거래 기록을 얼마나 멀리 검색 할 수 있는지에 대한 제한이있을 수 있습니다. Bybit을 사용하면 일반적으로 과거의 특정 일 또는 몇 달 동안 데이터를 가져올 수 있습니다.

이러한 한도를 효과적으로 관리하려면 다음을 수행해야합니다.

• API 사용량을 모니터링하십시오 . 얼마나 많은 요청을 받고 있는지 추적하고 요금 제한 내에 머무르도록하십시오.
• 페이지 매김을 구현하십시오 . limit 및 page 매개 변수를 사용하여 관리 가능한 청크에서 데이터를 검색하십시오.
• 데이터 검색을 계획하십시오 . 많은 양의 과거 데이터를 가져와야하는 경우 한도에 부딪히지 않도록 요청을주의 깊게 계획하십시오.

처리 오류

Bybit의 API로 작업 할 때 오류가 발생할 수 있습니다. 일반적인 오류에는 인증 실패, 속도 제한 초과 및 잘못된 매개 변수가 포함됩니다. 이러한 오류를 처리하는 방법은 다음과 같습니다.

• 인증 오류 : 인증 오류가 발생하면 API 키와 비밀을 다시 확인하십시오. 요청 헤더에 올바르게 포함되어 있는지 확인하십시오.
• 요율 제한 오류 : 요율 제한을 초과하는 경우 요청을 다시 시도하기 전에 기간을 기다리십시오. 코드 지연을 구현하여 속도 제한을 반복적으로 치는 것을 방지하십시오.
• 유효하지 않은 매개 변수 : API가 잘못된 매개 변수로 인해 API가 오류를 반환하는 경우 요청을 검토하고 모든 매개 변수가 올바르게 서식하고 허용 가능한 범위 내에 있는지 확인하십시오.

FAQ

Q : Bybit의 API를 사용하여 한 번에 여러 통화에 대한 트랜잭션 레코드를 검색 할 수 있습니까?

A : 아니요, Bybit의 API는 트랜잭션 레코드를 검색 할 때 단일 통화를 지정해야합니다. 여러 통화에 대한 레코드가 필요한 경우 각 통화에 대해 별도의 API 요청을해야합니다.

Q : 트랜잭션 레코드를 검색 할 때 API 키의 보안을 어떻게 보장 할 수 있습니까?

A : API 키의 보안을 보장하려면 다른 사람과 공유하지 말고 안전한 환경에서만 사용하십시오. 또한 Bybit의 IP 화이트리스트 기능을 사용하여 특정 IP 주소에 대한 API 액세스를 제한하는 것을 고려하십시오.

Q : 일정에 따라 트랜잭션 레코드 검색을 자동화하는 방법이 있습니까?

A : 그렇습니다. 일정에 API 요청을하는 스크립트를 작성하여 트랜잭션 레코드 검색을 자동화 할 수 있습니다. UNIX 기반 시스템에서 CRON 작업과 같은 스케줄링 도구 또는 Windows의 작업 스케줄러와 같은 스케줄링 도구를 사용하여 정기적으로 스크립트를 실행하십시오.

Q : 429 너무 많은 요청 오류가 발생하면 어떻게해야합니까?

A : 429 오류가 발생하면 Bybit의 요율 제한을 초과했음을 의미합니다. 요청을 다시 시도하기 전에 일정 기간을 기다렸다가 코드 지연을 구현하여 속도 제한을 반복적으로 치는 것을 방지하십시오.