Bitfinex의 API를 사용하여 계정 잔액을 쿼리하는 방법은 무엇입니까?

Bitfinex의 API를 사용하여 API 키로 인증하고/v2/auth/r/wallets에 대한 게시물 요청을 구성하고 JSON 응답을 구문 분석하여 계정 잔액을 쿼리합니다.

2025/04/13 15:21

Bitfinex의 API를 사용하여 계정 잔액을 쿼리하는 방법은 무엇입니까?

주요 암호 화폐 거래소 중 하나 인 Bitfinex는 사용자가 프로그래밍 방식으로 플랫폼과 상호 작용할 수있는 강력한 API를 제공합니다. 사용자가 수행하는 가장 일반적인 운영 중 하나는 계정 잔액을 쿼리하는 것입니다. 이 기사에서는 Bitfinex의 API를 사용하여 계정 잔액을 확인하여 자금을 효율적이고 안전하게 관리 할 수 ​​있도록하는 과정을 안내합니다.

Bitfinex의 API 인증 이해

계정 잔액을 쿼리하기 전에 API 요청을 인증하는 방법을 이해해야합니다. Bitfinex는 API 키와 서명을 사용하여 계정에 대한 안전한 액세스를 보장합니다.

• API 키 생성 : BitFinex 계정에 로그인하고 API 섹션으로 이동 한 다음 새 API 키를 생성하십시오. 계정 잔액을 읽는 데 필요한 권한을 활성화하십시오.
• API 키 및 비밀 : API 키와 비밀 키를 받게됩니다. 비밀 키를 안전하게 지키고 공유하지 마십시오.
• 서명 생성 : 각 API 요청마다 비밀 키를 사용하여 서명을 만들어야합니다. 시그니처는 비밀 키로 요청 페이로드를 해싱하여 생성됩니다.

개발 환경 설정

Bitfinex의 API와 상호 작용하려면 개발 환경을 설정해야합니다. 다음은 다음과 같은 방법입니다.

• 프로그래밍 언어 선택 : Bitfinex의 API는 다양한 프로그래밍 언어와 함께 사용할 수 있습니다. 인기있는 선택으로는 Python, JavaScript 및 Ruby가 있습니다.
• 필수 라이브러리 설치 : 예를 들어, Python을 선택한 경우 requests 라이브러리를 사용하여 HTTP 요청 및 hmac 및 hashlib 사용하여 서명을 작성할 수 있습니다.
• API 자격 증명 설정 : 개발 환경에 API 키와 비밀 키를 안전하게 저장하십시오.

API 요청 구성

계정 잔액을 쿼리하려면 적절한 엔드 포인트에 API 요청을 구성해야합니다. Bitfinex는이 목적을 위해 /v2/auth/r/wallets 엔드 포인트를 제공합니다.

• 끝점 : https://api.bitfinex.com/v2/auth/r/wallets
• HTTP 방법 : POST
• 페이로드 :이 요청에는 빈 배열 [] 가 사용됩니다.

서명 생성

서명을 만드는 것은 요청을 인증하는 데 중요한 단계입니다. 다음은 다음과 같은 방법입니다.

• 타임 스탬프 : 밀리 초로 타임 스탬프를 생성합니다. 이 타임 스탬프는 페이로드에 포함되어야합니다.
• NONCE : TimeStamp를 NONCE로 사용하여 요청이 고유한지 확인하십시오.
• 페이로드 : API 경로와 JSON 인코딩 페이로드를 연결하여 페이로드를 구성하십시오.
• 서명 : HMAC-SHA384 알고리즘을 사용하여 비밀 키와 페이로드로 서명을 만듭니다.

파이썬에서 서명을 만드는 방법의 예는 다음과 같습니다.

 import time
 import json
 import hmac
 import hashlib api_key = 'Your_api_key'
 api_secret = 'your_api_secret'


타임 스탬프와 비 세를 생성합니다
 timestamp = str (int (time.time () * 1000))
 nonce = timestamp

페이로드를 구성하십시오
 페이로드 = '/api/v2/auth/r/wallets' + json.dumps ([])

서명을 만듭니다
 signature = hmac.new (api_secret.encode (), payload.encode (), hashlib.sha384) .HexDigest ()

API 요청을 보냅니다

페이로드를 구축하고 서명을 만든 후에는 API 요청을 보낼 수 있습니다. 파이썬에서 수행하는 방법은 다음과 같습니다.

• 헤더 : 요청의 헤더에 API 키, 서명 및 Nonce를 포함하십시오.
• 요청 보내기 : requests 라이브러리를 사용하여 게시물 요청을 엔드 포인트로 보냅니다.

다음은 Python에서 요청을 보내는 방법의 예입니다.

 import requests url = 'https://api.bitfinex.com/v2/auth/r/wallets'


헤더 = {

'bfx-nonce': nonce, 'bfx-apikey': api_key, 'bfx-signature': signature
 }
 
응답 = requests.post (URL, 헤더 = 헤더, data = json.dumps ([]))
 
if response.status_code == 200 :
 
print(response.json())
 또 다른:
 
print('Error:', response.status_code, response.text)
 응답을 구문 분석합니다
 요청을 보내면 계정 잔액을 추출하기 위해 응답을 구문 분석해야합니다. Bitfinex의 응답은 JSON 형식으로, 일련의 지갑 객체가 포함됩니다.
 
지갑 개체 : 각 지갑 객체에는 통화, 잔액 및 지갑 유형 (예 : 교환 또는 여백)과 같은 정보가 포함됩니다.
 잔액 추출 : 배열을 통해 반복하여 각 통화의 잔액을 추출합니다.
 다음은 파이썬에서 응답을 구문 분석하는 방법의 예입니다.
 
wallets = response.json()
 지갑에있는 지갑 :
 
currency = wallet[1] balance = wallet[2] print(f'Currency: {currency}, Balance: {balance}')
 오류 및 에지 케이스 처리
 계정 잔액을 쿼리 할 때는 잠재적 오류 및 에지 케이스를 처리하는 것이 중요합니다.
 
API 요율 한도 : Bitfinex는 API 요청에 대한 요율 제한이 있습니다. 차단되지 않도록 이러한 한도를 초과하지 않도록하십시오.
 인증 오류 : 서명 또는 NONCE가 올바르지 않은 경우 인증 오류가 수신됩니다. 인증 프로세스를 다시 확인하십시오.
 네트워크 문제 : 시간 초과 또는 연결 오류와 같은 네트워크 관련 문제를 처리 할 수 ​​있도록 준비하십시오.
 자주 묻는 질문
 Q : 동일한 API 키를 사용하여 여러 계정에 대한 계정 잔액을 쿼리 할 수 ​​있습니까?
 
A : 아니요, 각 API 키는 단일 계정에 연결되어 있습니다. 여러 계정의 잔액을 쿼리하려면 각 계정에 대해 별도의 API 키를 생성해야합니다.
 
Q : BitFinex의 API를 사용하여 계정 잔액을 얼마나 자주 쿼리 할 수 ​​있습니까?
 
A : Bitfinex는 API 요청에 대한 요율 제한을 부과합니다. 일반적으로 분당 최대 90 개의 요청을 구성 할 수 있지만 Bitfinex API 문서의 현재 한도를 확인하는 것이 가장 좋습니다.
 
Q : 계정 잔액을 쿼리 할 때 인증 오류가 발생하면 어떻게해야합니까?
 
A : 인증 오류는 일반적으로 부정확 한 서명 또는 NonCE 값으로 인해 발생합니다. 타임 스탬프가 정확하고 올바른 비밀 키를 사용하여 서명을 생성하는지 확인하십시오. 문제가 지속되면 API 키를 재생하고 다시 시도하십시오.
 
Q : BitFinex의 API를 사용하여 계정 잔액을 실시간으로 쿼리 할 수 ​​있습니까?
 
A : Bitfinex의 API는 계정 잔액의 실시간 스트리밍을 제공하지 않습니다. 최신 잔액을 얻으려면 /v2/auth/r/wallets 엔드 포인트에 정기적으로 요청해야합니다.