ウォレットアドレスごとにトークン残高を確認するにはどうすればよいですか?

ダイレクトチェーン固有の残高クエリ

1. ユーザーは、GET リクエストを/balance/{chain}/{address}に送信することでトークン残高を取得できます。ここで、 {chain} はサポートされている 7 つのブロックチェーンの 1 つで、 {address} はウォレットの 16 進文字列です。

2. エンドポイントは、チェーン固有の契約基準とインデクサーの適用範囲に応じて、ネイティブ トークンの残高と ERC-20/BEP-20/SPL トークンの保有量を返します。

3. Solana の応答にはウォレットにマッピングされた SPL トークン アカウントが含まれますが、Ethereum と Base はマルチコール集約を通じて ETH とトークンの残高の両方を返します。

4. Hedera クエリはネイティブ HBAR バランスのみを返します。 HTS トークンには、このエンドポイントではカバーされない別のコントラクト インタラクションが必要です。

5. Bitcoin 応答は、RGB またはその他のトークン化レイヤーをサポートせずに、UTXO ベースの BTC バランスを反映します。

認証要件

1. すべての残高リクエストには、AgentHustle AI によって発行された有効な認証情報を含むX-API-Keyヘッダーが含まれている必要があります。

2. キーのスコープは特定のチェーンと権限に限定されます。イーサリアム専用キーを使用して BSC にクエリを実行しようとすると、HTTP 403 が発生します。

3. レート制限はキーごとに適用されます。すべてのエンドポイントにわたって 1 分あたり 60 リクエスト、API ゲートウェイ レベルで適用されます。

4. 無効なキーまたは期限切れのキーは、「invalid_api_key」または「key_expired」を示す JSON 本文を含む HTTP 401 をトリガーします。

5. セッション Cookie や OAuth フローは関係しません。認証はステートレスでヘッダー駆動型です。

応答構造とデータフィールド

1. 成功した応答には HTTP 200 が使用され、基本単位の文字列化された整数として表現されるトップレベルの残高フィールドが含まれます (例: ETH の場合は wei、SOL の場合は lamports)。

2.トークン配列には、非ネイティブ アセットがリストされ、それぞれにcontractAddress 、 symbol 、 decimals 、およびrawBalance が含まれます。

3. lastUpdatedフィールドは、基盤となるブロックチェーン インデクサーの最新の同期ブロックと一致する Unix タイムスタンプをミリ秒単位で報告します。

4. ネイティブ通貨以外のトークンを保持していないウォレットの場合、トークン配列は存在しますが空のままです。

5. JSON シリアル化時の浮動小数点精度の損失を防ぐために、すべての数値は文字列として配信されます。

ENS 名前解決の統合

1. リゾルバー サービスが有効になっている場合、 vitalik.ethなどの ENS 名を 16 進アドレスの代わりに直接使用できます。

2. API は、クエリをチェーン固有のバランス エンドポイントに転送する前に、イーサリアム メインネットの ENS レジストリを介して逆引き参照を自動的に実行します。

3. 名前がアドレスに解決されない場合、または無効なチェックサム形式を指している場合、解決はサイレントに失敗します。

4. サポートされている ENS TLD には、.eth、.xyz、.luxe が含まれます。 .com および .org は、ENS 互換のリゾルバーに登録されていない限り処理されません。

5. PayPal と Venmo の統合により、ENS 名を使用した PYUSD 送金が可能になりますが、残高チェックはチェーンネイティブのままであり、オフチェーンの支払い残高は反映されません。

よくある質問

Q: Cardano や Avalanche などのサポートされていないチェーン上のウォレットの残高を確認できますか? A: いいえ。エンドポイントは、Solana、Ethereum、Base、BSC、Polygon、Hedera、および Bitcoin のみをサポートします。他のチェーンに対するリクエストは、エラー コード「unsupported_chain」とともに HTTP 400 を返します。

Q: API は、イーサリアム ウォレット内の wBTC や wETH などのラップされたトークンを検出しますか? A: はい。 ERC-20 標準に準拠したラップされたトークンは、正しい記号、小数点、および生の残高とともにトークン配列に表示されます。

Q: ウォレットの全資産の残高がゼロの場合はどうなりますか? A: 応答には、残高: '0'と空のトークン配列が含まれています。 HTTPステータスは200のままです。

Q: 1 つのリクエストで複数のアドレスをバッチチェックする方法はありますか? A: ネイティブではありません。各アドレスには個別の HTTP リクエストが必要です。クライアントは、並列化またはキューイング ロジックを外部に実装する必要があります。