BitfinexのAPIを使用してアカウントの残高を照会する方法は？

BitfinexのAPIを使用して、APIキーで認証し、/V2/Auth/R/ウォレットへのPOSTリクエストを作成し、JSON応答を解析することにより、アカウントの残高をクエリします。

2025/04/13 15:21

BitfinexのAPIを使用してアカウントの残高を照会する方法は？

主要な暗号通貨交換の1つであるBitfinexは、ユーザーがプログラムでプラットフォームと対話できるようにする堅牢なAPIを提供します。ユーザーが実行する最も一般的なオペレーションの1つは、アカウント残高のクエリです。この記事では、BitfinexのAPIを使用してアカウントの残高を確認し、資金を効率的かつ安全に管理できるようにするプロセスをガイドします。

BitfinexのAPI認証の理解

アカウントの残高を照会する前に、APIリクエストを認証する方法を理解する必要があります。 Bitfinexは、APIキーと署名の組み合わせを使用して、アカウントへの安全なアクセスを確保します。

• APIキーを生成：BitFinexアカウントにログインし、APIセクションに移動し、新しいAPIキーを生成します。アカウントの残高を読み取るために必要な権限を有効にするようにしてください。
• APIキーとシークレット：APIキーとシークレットキーを受け取ります。秘密の鍵を安全に保ち、それを共有しないでください。
• 署名の作成：各APIリクエストについて、シークレットキーを使用して署名を作成する必要があります。署名は、シークレットキーを使用してリクエストペイロードをハッシュすることによって生成されます。

開発環境を設定します

BitfinexのAPIと対話するには、開発環境を設定する必要があります。これがそれを行う方法です：

• プログラミング言語を選択します。BitfinexのAPIは、さまざまなプログラミング言語で使用できます。一般的な選択肢には、Python、JavaScript、Rubyが含まれます。
• 必要なライブラリをインストールする：たとえば、Pythonを選択する場合、httpリクエストを作成するためにrequestsライブラリを使用し、署名を作成するためにhmacとhashlib使用できます。
• API資格情報を設定する：APIキーとシークレットキーを開発環境に安全に保存します。

APIリクエストの構築

アカウントの残高を照会するには、適切なエンドポイントにAPI要求を作成する必要があります。 Bitfinexは、この目的のために/v2/auth/r/walletsエンドポイントを提供します。

• エンドポイント： https://api.bitfinex.com/v2/auth/r/wallets
• HTTPメソッド： POST
• ペイロード：空の配列[]がこのリクエストに使用されます。

署名を作成します

署名を作成することは、リクエストを認証する上で重要なステップです。これがそれを行う方法です：

• タイムスタンプ：ミリ秒単位でタイムスタンプを生成します。このタイムスタンプはペイロードに含める必要があります。
• ノンセ：リクエストが一意であることを確認するために、タイムスタンプをノンセとして使用します。
• ペイロード：APIパスとJSONエンコードされたペイロードを連結してペイロードを構築します。
• 署名：HMAC-SHA384アルゴリズムを使用して、シークレットキーとペイロードで署名を作成します。

Pythonで署名を作成する方法の例は次のとおりです。

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





タイムスタンプとノンセを生成します
タイムスタンプ= str（int（time.time（） * 1000））
 nonce =タイムスタンプ




ペイロードを作成します
ペイロード= '/api/v2/auth/r/wallets' + json.dumps（[]）




署名を作成します
signature = hmac.new（api_secret.encode（）、payload.encode（）、hashlib.sha384）.hexdigest（）

APIリクエストの送信

ペイロードを作成して署名を作成したら、APIリクエストを送信できます。これがPythonでそれを行う方法です：

• ヘッダー：リクエストのヘッダーにAPIキー、署名、およびノンセを含めます。
• リクエストの送信： requestsライブラリを使用して、ポストリクエストをエンドポイントに送信します。

Pythonでリクエストを送信する方法の例は次のとおりです。

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





ヘッダー= {




'bfx-nonce': nonce, 'bfx-apikey': api_key, 'bfx-signature': signature
 }
 
response = requests.post（url、headers = headers、data = json.dumps（[]））
 
response.status_code == 200の場合：
 
print(response.json())
それ以外：
 
print('Error:', response.status_code, response.text)
応答を解析します
リクエストを送信した後、アカウントの残高を抽出するための応答を解析する必要があります。 Bitfinexからの応答は、JSON形式で、ウォレットオブジェクトの配列が含まれています。
 
ウォレットオブジェクト：各ウォレットオブジェクトには、通貨、バランス、タイプのウォレット（交換またはマージンなど）などの情報が含まれています。
バランスの抽出：配列を繰り返して、各通貨のバランスを抽出します。
 Pythonで応答を解析する方法の例は次のとおりです。
 
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要求にレート制限を課します。通常、1分あたり最大90のリクエストを作成できますが、BitFinex APIドキュメントの現在の制限を確認するのが最善です。
 
Q：アカウントの残高を照会するときに認証エラーが発生した場合はどうすればよいですか？
 
A：認証エラーは、通常、signatureが誤っていないために発生します。タイムスタンプが正確であり、正しい秘密キーを使用して署名を生成していることを確認してください。問題が続く場合は、APIキーを再生して再試行してください。
 
Q：BitfinexのAPIを使用してアカウントの残高をリアルタイムで照会できますか？
 
A：BitfinexのAPIは、アカウント残高のリアルタイムストリーミングを提供しません。最新のバランスを取得するには、 /v2/auth/r/walletsエンドポイントに定期的なリクエストを行う必要があります。