TRONでホルダーリストを取得して、TRC-20を本当に保有しているのは誰かを把握する方法
TRONでホルダーリストを取得する方法をsnapshotトークンで押さえておけば、TRC-20を保有する全ウォレットとそれぞれの残高を、コードを書かずに数分で手に入れられます。エアドロップ、ホワイトリスト、トークン分布の分析など、あらゆる施策の前提となる作業です。
SmithiiのToken Snapshotはチェーンに直接問い合わせて、CSVでダウンロードできる状態のファイルを返してくれます。以下に手順を、そのあとにリストを使う前に確認しておきたいポイントをまとめました。
snapshotで正確に何が得られるのか
この種のツールはどれも同じ出力をしてくれるわけではないので、まず最初にはっきりさせておきましょう。ここで得られるのは3つの使えるカラムです：ウォレットのアドレス、そのトークンの残高、そして総供給量に占める割合。
実行したその瞬間のチェーンの状態を切り取ったスナップショットです。自動では更新されないので、1ヶ月後のデータが必要ならsnapshotをもう一度実行する必要があります。
残高でフィルタせず、すべてのホルダーが含まれます。whaleからダスト残高のウォレットまで全部入るということです。監査目的ならそれが正しい仕様ですが、あとで配布に使うなら注意点でもあります。残高がほぼゼロのアドレスにトークンを送りたくはないはずです。
結果はコピーするかCSVでダウンロードでき、multisenderがそのまま受け付ける形式なので、再フォーマット作業はいりません。
TRONでホルダーリストを取得する手順
SmithiiのToken Snapshot (TRON向け)はチェーンに直接クエリを投げて、ホルダーの完全なリストを数秒で返してくれます。外部のインデクサーに頼る必要も、トークンがどこかに上場している必要もありません。必要なのはコントラクトアドレスだけなので、自分のものかどうかに関係なく、あらゆるTRC-20で動きます。インターフェースはこちらです。
コントラクトアドレスさえ用意できれば、あとは3ステップです。
- トークンのアドレスを貼り付ける: Token contract addressの欄に入力します。コントラクトのオーナーである必要はありません。
- snapshotを実行し、支払いを確定します。ホルダー数によりますが、処理には数分ほどかかります。
- アドレスをコピーするか、CSVをダウンロードすれば、完全なリストが手元に残ります。そのまま分析にも、multisenderに読み込ませるのにも使えます。
リストから読み取るべき3つのポイント
CSVはただ持っているだけでは意味がありません。パーセンテージの列を降順に並べ替えれば、次の3つは5分もあれば見えてきます。
- 上位10ウォレットが占める割合。エントリーを検討する人が真っ先に見る数字です。この10個で供給量の過半数を握っているなら、あなたのトークンは彼らが売らないことに依存している状態です。
- 実際に意味のある残高を持つウォレットの数。まとまった量を持つアドレスと、ダストしか残っていないアドレスを分けることで、ホルダー数という数字にはじめて説得力が出ます。
- プールが想定した場所にあるか。流動性はリスト上では1つのウォレットとして現れます。これを確認すれば、供給量のうち実際に市場に出ているのはどれくらいで、どれくらいが個人の手元にあるのかがわかります。
そのあとに一番わかりやすい使い道が来ます。セグメント分けです。残高が見えていれば、闇雲に配布する代わりに層ごとにリワードを分けたり、ダストしか持っていないアドレスを配布対象から外して、戻ってこないウォレットに手数料を使わずに済ませたりできます。
この最後のポイントは、TRONでは実際にお金に響きます。配布はアドレス単位で課金されるからです。3,000人のホルダーのうち1,200人が一度も動かしていない残りカスの残高しか持っていないなら、エアドロップ前にフィルタリングしておけばその1,200ウォレット分の手数料が浮きます。配布はプロジェクトを本当に支えている人に集中させられます。
気になる数値が見つかったら、TRON でホルダー分布をチェックして rug プルを見抜く方法と、トークンのその他のチェック項目を確認してみてください。
時間をあけて取得した2つの snapshot を比較する
単発のリストは一瞬の状態を映すだけです。数週間あけて取った2つのリストを並べれば、そこにトレンドが見えてきます。こちらのほうがはるかに情報量があります。
比較すれば、新しいホルダーが入ってきているのか、それとも常連の間で残高が動いているだけなのかが分かります。大口ウォレットが積み増しているのか放出しているのか、ホルダー数の伸びが実在ユーザーによるものなのか、それとも最小残高で現れてその後取引しないアドレスによるものなのかも見えてきます。
キャンペーンが機能したかを正直に測る方法でもあります。エアドロップでホルダー数が跳ね上がっても、6週間後に他の指標が何も変わっていないなら、誰も掴めなかったということ。配ったトークンは売られただけです。
リストが手元にあれば、次の自然なステップはそのウォレット群にトークンを配布することです
TRON でトークンのホルダーリストを取得するコスト
1 snapshot あたり 180 TRX。ホルダー数で料金が変わることはありません。200ウォレットのトークンでも5万ウォレットのトークンでも同じ価格です。実行ごとの単発支払いなので、数ヶ月後に再実行する場合も同じ料金が発生します。
ただし、同じリストに到達する方法は2通りあります。支払う前にどちらが自分に合うかを把握しておきましょう。
| 経由 | 得られるもの | 選ぶべきタイミング |
|---|---|---|
| 単独で Snapshot | ダウンロード済みの CSV ファイル。アドレス、残高、割合が自分の手元に残ります | 分析、保存、再利用したいとき |
| multisender から | 配布フォームに自動でリストが読み込まれます | 目的がその場でエアドロップを行うことだけのとき |
料金はどちらも同じなので、判断基準は価格ではなく、その後に何をするかです。リストが資産として機能するなら、別途取得する価値があります。数ヶ月後に別のリストと比較する、スプレッドシートでじっくりセグメント分けする、パートナーに自分のトークンの分布状況を説明する、といった用途に使えます。
逆に、フィルタをかけずに全ホルダーに配布することが既に決まっているなら、途中のステップは不要です。multisender が同じリストを抽出し、そのまま読み込んでくれます。
FAQ
TRON の snapshot トークンのコストはいくらですか?
実行する snapshot 1回につき 180 TRX です。トークンのホルダー数に関係なく価格は同じで、実行ごとの支払いになります。後日最新のリストが必要になった場合は、新たに実行して再度支払う必要があります。
ファイルには各ウォレットの残高も含まれますか?
はい。CSV にはアドレス、そのウォレットが保有するトークン残高、そして総供給量に対する割合が含まれます。この3列があれば、保有量順にソートして、全ホルダーを一律に扱うのではなく、ティアごとに配布を分けることができます。
自分が所有していないトークンのホルダーも取得できますか?
はい。ツールが必要とするのはコントラクトアドレスだけで、ホルダー情報はブロックチェーン上で公開されています。参入前に他プロジェクトの分布を調べたり、親和性の高いコミュニティに配布でアプローチしたりする用途でよく使われています。
リストは時間とともに自動更新されますか?
いいえ。snapshot はまさにその実行時点を切り取ったスナップショットであり、残高は転送があるたびに変化します。最新のデータを得るには新しい snapshot を実行する必要があります。時間をあけて取得した2つを比較することこそが、ホルダー層が広がっているのか、それとも集中しているのかを教えてくれます。
まとめ
snapshot は、トークンの分配状況を『たぶんこうだろう』で済ませないための、いちばん安いツールです。コストは180 TRXと数分だけ。得られるのは、その後のほぼすべての判断、誰に、どれだけ、どの順番で配るかを決めるための土台になります。
配分設計を始める前に取得してください。終わってからでは遅いです。残高を見ながらセグメント分けするのも、手探りで配るのも、コストは同じ。でも結果はまったく違います。
トークンがCircleのネットワーク上にある場合、手順もファイルの中身も変わります。詳細は Arcでholderリストをエクスポートする方法 のガイドで解説しています。
