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 Secretを使用して生成された署名の組み合わせを使用します。リクエストを認証する方法は次のとおりです。

• 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（）
 
署名を生成します
signature = 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'
 response = requests.get（url、headers = headers）
 print（respons.json（））

• 注文を行う： /v1/order/newエンドポイントを使用して、新しい注文を配置します。シンボル、量、価格、および注文タイプを指定する必要があります。

 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（）
signature = 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、headers = headers）
print（respons.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（内部サーバーエラー）などの一般的なエラーコードに慣れてください。

Pythonのエラーを処理する方法の例は次のとおりです。

 import requests url = 'https://api.bitfinex.com/v1/balances'
 response = requests.get（url、headers = headers）





response.status_code == 200の場合：




print('Request successful:', response.json())
それ以外：
 
print('Error:', response.status_code, response.text)
リアルタイムデータにWebSocketsを使用します
REST APIは多くのタスクに適していますが、WebSocketを使用すると、リアルタイムのデータ更新を提供できます。 BitfinexのWebSocketAPIに接続するには、次の手順に従ってください。
 
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には、認証された認証されていないリクエストに対して異なるレート制限があります。認証されたリクエストは、通常、1分あたり90のリクエストに制限されます。
• コードにレート制限を実装する：Pythonのratelimitなどのライブラリを使用して、制限内にとどまることを確認します。

 from ratelimit import limits, sleep_and_retry @sleep_and_retry
 @limits（calls = 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リクエストをテストできるテストネット環境を提供します。テストネットアカウントにサインアップし、テストネットAPIエンドポイントを使用して、取引やその他の操作をシミュレートできます。

Q：認証エラーが発生した場合はどうすればよいですか？

A：認証エラーが発生した場合は、APIキー、秘密、および署名生成プロセスを再確認してください。 NONCEが各リクエストに対して一意であり、ペイロードが正しくフォーマットされていることを確認してください。問題が続く場合は、APIキーと秘密を再生することを検討してください。