query-address-info
作成者 binancequery-address-info は、ウォレットアドレスと対応チェーン上のトークン保有量を確認するための Web3 スキルです。トークン名、シンボル、価格、24時間の価格変動、保有数量を返し、素早いポートフォリオ確認、ウォレットのデューデリジェンス、アドレス監視に役立ちます。推測を減らした、構造化された残高スナップショットが必要なときに使えます。
このスキルは72/100で、掲載は可能ですが注意付きで紹介するのが適切です。ウォレット照会の用途が明確で、呼び出すべき具体的なAPIもあります。一方で、リポジトリ内のワークフロー説明はやや薄く、実行手順の一部は利用者が補う必要があるかもしれません。ディレクトリ利用者にとっては、エンドツーエンドで洗練された実装というより、オンチェーンのアドレス検索に特化したスキルを導入したい場合に十分な内容です。
- ウォレット残高、トークン保有量、ポートフォリオ、資産ポジションに関する問い合わせ意図が明確です。
- 必須パラメータとリクエストヘッダーを備えた具体的な GET エンドポイントがあり、エージェントから直接呼び出しやすいです。
- プレースホルダーや試験的な表記がなく、本文も実際の API 利用例として十分な分量があります。
- 公開されているのは1つの skill ファイルのみで、補助スクリプト、参照資料、ルール類がないため、例外処理やバリデーションは十分に文書化されていません。
- 表示例は途中で切れており、説明文も短いため、初めて使う人には導入の分かりやすさがやや不足しています。
query-address-info skill の概要
query-address-info でできること
query-address-info skill は、対応チェーン上のウォレットアドレスが保有するトークンを取得します。Web3 ユーザーがウォレットの現在のポジションを素早く確認したいときに向けた設計で、トークン名、シンボル、価格、24時間の価格変動、保有数量までまとめて把握できます。
この skill が向いている人
query-address-info skill は、ポートフォリオ確認、ウォレットのデューデリジェンス、アドレス監視、軽めのオンチェーン分析に使えます。すでにアドレスと chain ID が分かっていて、構造化された残高スナップショットをすぐに取りたい場合に特に便利です。
どんな場面に最適か
「このウォレットはいま何を持っているのか？」に答えるための実用的な query-address-info guide を探しているなら、この skill は適しています。一方で、取引履歴、DeFi の全体的な帰属分析、NFT の保有一覧、アクティブなトークンポジションを超える深い分析にはあまり向きません。
導入判断のポイント
query-address-info を入れる主な理由はスピードです。アドレス検索の手順で迷いにくくなり、必要なリクエスト形式も明確になります。制約はスコープで、特定のアドレスとチェーンにおけるトークン保有に絞られるため、クロスチェーン集計や履歴ベースの会計処理までは期待しないほうがよいです。
query-address-info skill の使い方
skill をインストールしてファイルを開く
query-address-info install を行う場合は、binance/binance-skills-hub から skill を追加し、まず skill のエントリーファイルを読みます。最初に SKILL.md を確認し、必要に応じてリンクされているリポジトリ内ファイルも見てください。この repo では skill が自己完結しているため、SKILL.md が最初に見るべき一次情報です。
skill に必要な入力
query-address-info をうまく使うには、次を指定します。
0x...のような EVM アドレスのウォレットアドレス- BSC なら
56、Base なら8453のような対応chainId - ページネーション用の
offset値。通常は最初のページなら0
「このウォレットを見て」のような曖昧な指示だと、解釈の余地が大きすぎます。例えば「query-address-info を使って chain 56 のアドレス 0x... を確認し、アクティブなトークンポジションを返しつつ、大きな残高集中があれば注記して」と指定すると、必要な文脈が揃い、絞り込まれた結果を返しやすくなります。
より良い結果を出すための実践ワークフロー
query-address-info usage は、次の 3 ステップで進めると扱いやすいです。
- chain とアドレスが正しいか確認する。
offset=0で最初の保有一覧を取得する。- ウォレットの保有数が多い場合は、後続の offset でさらにポジションを確認する。
分析用途では、保有をトークン集中度、ステーブルコイン比率、目立つ価格変動で要約するよう依頼してください。そうすると、単なる残高一覧が、ただの API ダンプではなく実用的なウォレット読解になります。
先に読むべきファイルと詳細
skill を調整する場合は、プロンプトや自動化を組む前に SKILL.md のリクエストパラメータ、ヘッダー、サンプルリクエストを読んでください。エンドポイントは特定のアドレス、chain ID、ページネーション形式を前提としており、値の誤りが空結果や誤解を招く結果の最も一般的な原因になるため、この情報は重要です。
query-address-info skill の FAQ
query-address-info は Web3 アドレス専用ですか？
はい。query-address-info for Web3 というユースケースが中心設計です。メールアカウント、取引所プロフィール、オフチェーンの ID データではなく、オンチェーンのウォレットアドレスとトークンポジションを対象にしています。
普通のプロンプトと何が違うのですか？
通常のプロンプトでも目的は伝えられますが、query-address-info skill なら API 指向の正確なワークフローと必要入力が明示されます。そのため、フォーマットのミスが減り、やり取りの往復も少なくなり、ウォレット保有を素早く確認したい場面でより安定した出力が得やすくなります。
初心者でも使いやすいですか？
はい、すでにウォレットアドレスと chain が分かっているなら使いやすいです。初心者がつまずきやすいのは、正しい chain ID を選ぶことと、この skill が返すのはアクティブなポジションであって、ウォレットが持ちうるあらゆる資産データではないと理解することです。
どんなときに使わないほうがいいですか？
履歴ベースの PnL、完全な取引トレース、クロスチェーンのポートフォリオ集計、NFT 分析が必要なら query-address-info は使わないでください。そうした用途には別のツールとデータソースが必要です。
query-address-info skill の改善方法
できるだけ正確なアドレスと chain を渡す
query-address-info の結果を良くする最善策は、有効な checksum 形式のアドレスと正確な chain ID を指定することです。どちらかが間違っていると、出力が不完全になったり、別のウォレット文脈を参照したりする可能性があります。
本当に必要な分析を明示する
残高だけを求めるのではなく、意思決定の目的を具体的に伝えてください。たとえば「価値順に上位 5 件の保有を要約して」「ステーブルコイン比率が高いウォレットをフラグして」「24h の変動が大きいトークンを強調して」といった依頼です。そうすると、保有一覧を、より実用的な query-address-info guide の出力に変えやすくなります。
ページネーションを意図して使う
保有数の多いウォレットは、1 ページに収まらないことがあります。最初の応答が不完全に見えたら、空だと決めつけずに次の offset へ進んでください。これは、アクティブトレーダー、LP、複数資産を持つウォレットで特に重要です。
例外パターンを確認してから使う
wrapped asset、流動性の低いトークン、古く見える残高に注意してください。スクリーニングやレポート用途で結果を使うなら、上位保有をウォレットの想定戦略と照らし合わせ、出力が期待している chain や address と合わない場合は、フレッシュなプロンプトで再実行してください。