Bitfinex의 REST API를 사용하는 방법?

Bitfinex의 REST API를 사용하면 거래, 시장 데이터를 얻고 프로그래밍 방식으로 계정을 관리 할 수 ​​있습니다. 이 안내서는 효과적인 사용을위한 단계와 예를 제공합니다.

2025/04/14 03:35

Bitfinex의 REST API를 사용하면 교환과 프로그래밍 방식으로 상호 작용할 수 있으므로 거래, 시장 데이터 검색 및 계정 관리와 같은 작업을 수행 할 수 있습니다. 이 안내서는 필수 단계를 안내하고 Bitfinex의 REST API를 효과적으로 사용하는 방법에 대한 자세한 지침을 제공합니다.

Bitfinex의 REST API를 시작합니다

Bitfinex의 REST API 사용을 시작하기 전에 API 키를 설정해야합니다. 이렇게하려면 다음을 수행하십시오 .

• BitFinex 계정에 로그인하십시오.
• '계정'섹션으로 이동하여 'API'를 선택하십시오.
• 새 API 키를 생성하려면 '새 키'를 클릭하십시오.
• 거래, 인출 또는 읽기 전용 액세스와 같은 키에 부여 할 권한을 선택하십시오.
• 키 생성을 확인하고 API 키와 비밀을 안전하게 저장하십시오.

API 키와 비밀이 있으면 Bitfinex REST API에 요청을 시작할 수 있습니다. API는 HTTPS를 사용하고 데이터 교환을 위해 JSON을 지원합니다.

인증 및 보안

API 상호 작용을 보호하는 데 인증이 중요합니다 . Bitfinex는 API 키와 API 비밀을 사용하여 생성 된 서명의 조합을 사용합니다. 요청을 인증하는 방법은 다음과 같습니다.

• Nonce : 각 요청이 고유한지 확인하는 고유 한 숫자를 생성하십시오 . 이것은 타임 스탬프 또는 증분 정수 일 수 있습니다.
• 페이로드 생성 : API 경로, Nonce 및 추가 매개 변수를 JSON 객체에 결합하십시오.
• 서명 생성 : API 비밀과 함께 HMAC-SHA384 알고리즘을 사용하여 페이로드에 서명하십시오.
• 헤더 포함 : API 키, 페이로드 및 서명을 요청 헤더에 추가하십시오.

다음은 Python에서 필요한 헤더를 만드는 방법의 예입니다.

 import time
 import json
 import hmac
 import hashlib api_key = 'Your_api_key'
 api_secret = 'your_api_secret'.encode ()


Nonce를 생성하십시오
 nonce = str (int (time.time () * 1000))

페이로드를 만듭니다
 페이로드 = {

'request': '/v1/balance', 'nonce': nonce
 }
 
페이로드를 JSON으로 변환하고 인코딩하십시오
 payload_json = json.dumps (payload) .encode ()
 
서명을 생성하십시오
 서명 = hmac.new (api_secret, payload_json, hashlib.sha384) .HexDigest ()
 
헤더 준비
 헤더 = {
 
'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature
 }

API 요청

인증을 통해 BitFinex의 REST API를 요청할 수 있습니다. 다음은 몇 가지 일반적인 엔드 포인트와 사용 방법입니다 .

• 계정 잔액 검색 : /v1/balances 엔드 포인트를 사용하여 계정 잔액을 확인하십시오.

 import requests url = 'https://api.bitfinex.com/v1/balances'
 응답 = requests.get (URL, 헤더 = 헤더)
 print (response.json ())

• 순서 대상 : /v1/order/new endpoint를 사용하여 새 주문을 배치하십시오. 기호, 금액, 가격 및 주문 유형을 지정해야합니다.

 payload = { 'request': '/v1/order/new', 'nonce': nonce, 'symbol': 'btcusd', 'amount': '0.01', 'price': '10000', 'exchange': 'bitfinex', 'type': 'exchange limit', 'side': 'buy'

}

payload_json = json.dumps (payload) .encode ()
서명 = hmac.new (api_secret, payload_json, hashlib.sha384) .HexDigest ()

헤더 = {

'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature

}

url = 'https://api.bitfinex.com/v1/order/new'
응답 = requests.post (URL, 헤더 = 헤더)
print (response.json ())

• 시장 데이터 검색 : /v1/pubticker 엔드 포인트를 사용하여 특정 거래 쌍의 현재 시세를 얻습니다.

 url = 'https://api.bitfinex.com/v1/pubticker/btcusd'
 response = requests.get(url)
 print(response.json())

오류 및 응답 처리

Bitfinex REST API를 사용하는 경우 오류를 처리하고 응답을 올바르게 해석하는 것이 중요합니다. 몇 가지 팁은 다음과 같습니다 .

• HTTP 상태 코드 확인 : 200 상태 코드는 성공적인 요청을 나타내고 다른 코드는 오류를 나타냅니다.
• 응답 JSON : 응답에는 요청 된 데이터 또는 오류 메시지가 포함 된 JSON 객체가 포함됩니다.
• 일반적인 오류 코드 : 400 (불량 요청), 401 (무단) 및 500 (내부 서버 오류)과 같은 일반적인 오류 코드에 익숙해집니다.

파이썬에서 오류를 처리하는 방법의 예는 다음과 같습니다.

 import requests url = 'https://api.bitfinex.com/v1/balances'
 응답 = requests.get (URL, 헤더 = 헤더)


if response.status_code == 200 :

print('Request successful:', response.json())
 또 다른:
 
print('Error:', response.status_code, response.text)
 실시간 데이터에 Websocket을 사용합니다
 나머지 API는 많은 작업에 적합하지만 WebSockets를 사용하면 실시간 데이터 업데이트를 제공 할 수 있습니다. Bitfinex의 WebSocket API에 연결하려면 다음을 수행하십시오 .
 
WebSocket 연결 설정 : Python에서 websocket-client 와 같은 WebSocket 라이브러리를 사용하십시오.
 import websocket
 ws = websocket.websocket ()
 ws.connect ( 'wss : //api-pub.bitfinex.com/ws/2')

• 채널 구독 : JSON 메시지를 보내 시어 또는 주문서 업데이트와 같은 특정 채널을 구독하십시오.

 subscribe_msg = { 'event': 'subscribe', 'channel': 'ticker', 'symbol': 'tBTCUSD'

}

ws.send (json.dumps (subscribe_msg))

• 수신 메시지 처리 : 실시간 데이터를 처리하기 위해 들어오는 JSON 메시지를 구문 분석합니다.

 result = ws.recv()
 print(result)

API 요율 제한 관리

Bitfinex는 학대를 방지하기 위해 API 요청에 요율 제한을 부과합니다. 이러한 한도를 효과적으로 관리하려면 :

• 한계 이해 : Bitfinex는 인증 및 무분별한 요청에 대해 다른 속도 제한이 다릅니다. 인증 요청은 일반적으로 분당 90 개의 요청으로 제한됩니다.
• 코드에서 속도 제한을 구현하십시오 : Python에서 ratelimit 같은 라이브러리를 사용하여 한계 내에서 유지되도록하십시오.

 from ratelimit import limits, sleep_and_retry @sleep_and_retry
 @Limits (콜 = 90, 기간 = 60)
 def call_api () :


# Make your API call here pass
 기능을 사용하십시오
 call_api ()

자주 묻는 질문

Q : Bitfinex의 REST API를 사용하여 거래 전략을 자동화 할 수 있습니까?

A : 그렇습니다. REST API를 사용하여 프로그래밍 방식으로 주문하고 잔액 확인 및 시장 데이터를 검색하여 거래 전략을 자동화 할 수 있습니다. 안정적인 거래 환경을 유지하기 위해 적절한 오류 처리 및 요금 제한을 구현해야합니다.

Q : Bitfinex REST API를 사용하여 자금을 인출 할 수 있습니까?

A : 예, /v1/withdraw 엔드 포인트를 사용하여 자금을 인출 할 수 있습니다. 인출 방법, 금액 및 주소를 지정해야합니다. 인출을 수행하기 위해 API 키에 필요한 권한이 있는지 확인하십시오.

Q : 라이브 계정에 영향을 미치지 않고 API 요청을 어떻게 테스트 할 수 있습니까?

A : Bitfinex는 라이브 계정에 영향을 미치지 않고 API 요청을 테스트 할 수있는 TestNet 환경을 제공합니다. TestNet 계정에 가입하고 TestNet API 엔드 포인트를 사용하여 거래 및 기타 운영을 시뮬레이션 할 수 있습니다.

Q : 인증 오류가 발생하면 어떻게해야합니까?

A : 인증 오류가 발생하면 API 키, 비밀 및 서명 생성 프로세스를 다시 확인하십시오. 각 요청마다 NONE가 고유하고 페이로드가 올바르게 형식화되어 있는지 확인하십시오. 문제가 지속되면 API 키와 비밀을 재생하는 것을 고려하십시오.