getTokenLargestAccounts RPCメソッドは、指定されたSPLトークン発行の20の最大トークンアカウントのリストを返します。これは、トークンの分布を分析し、特定のトークンの主要な保有者を特定するのに役立ちます。
共通の使用例
- トークン分布分析: トークンの供給が保有者の間でどのように分布しているかを理解する。
- ホエールの特定: 特定のトークンを大量に保有しているアカウントを見つける。
- 市場調査: トークン所有の集中度を測る。
- トップホルダーの表示: トークンエクスプローラやダッシュボードで最大アカウントのリストを表示する。
リクエストパラメータ
-
mintAddress(string, 必須): 最大アカウントを見つけたいトークン発行のbase-58エンコードされた公開鍵。 -
options(object, 任意): 使用可能なオプションの構成オブジェクト:commitment(string, 任意): クエリのコミットメントレベルを指定します(例:"finalized","confirmed","processed")。
応答構造
JSON-RPC応答内のresult.valueフィールドは、最大20個のオブジェクトの配列です。それぞれのオブジェクトは最大トークンアカウントの1つを表し、次のフィールドを含みます:
address(string): トークンアカウントのbase-58エンコードされた公開鍵。amount(string): トークンアカウントの生残高。この値は小数点以下の調整がされていません。decimals(u8): このトークン発行に定義された小数点以下の桁数。uiAmount(number | null): 小数点以下を調整したトークン残高。廃止または信頼性が低下する可能性があるため、uiAmountStringが推奨されます。uiAmountString(string): 小数点以下が調整されたトークン残高の文字列表現。これが最もユーザーフレンドリーな残高表現です。
コード例
開発者向けヒント
- 固定リミット: このメソッドは常に最大20の最大アカウントを返します。ページネーションや20以上のアカウントのリクエストには対応していません。
- データの正確性: データは、指定されたコミットメントレベルによって決定されたスロットでの台帳の状態を反映しています。
- 特定のトークン発行: 結果は、リクエストで提供された単一のトークン発行に特異的です。
- パフォーマンス: これは対象を絞ったクエリで、一般的に良好なパフォーマンスを発揮します。ただし、過度なポーリングは避けるべきです。
getTokenLargestAccounts RPCメソッドの使用をサポートします。