So erstellst du einen snapshot der Holder auf NEAR: die Wallet-Liste jedes token oder jeder NFT-Collection als CSV
Wenn du deine Community belohnen, eine Allowlist vorbereiten oder einfach nur wissen willst, wer deinen token hält, ist der erste Schritt zu lernen, wie man einen snapshot der Holder auf NEAR erstellt. In Sekunden bekommst du die komplette Liste der Accounts, die einen token oder einen NFT halten, bereit zum Download als CSV oder zur direkten Übergabe an einen airdrop.
In dieser Guide zeige ich dir, wofür ein snapshot auf NEAR gut ist, wie du ihn für einen token und für eine NFT-Collection mit dem Tool von Smithii ziehst, was die Liste enthält und was draußen bleibt, und was er kostet. Legen wir los.
Was ein snapshot der Holder ist und wofür er auf NEAR nützlich ist
Ein snapshot ist eine Momentaufnahme der Verteilung eines Assets zu einem bestimmten Zeitpunkt, mit allen Accounts, die es halten, samt ihren Beständen. Auf NEAR hat das einen netten Vorteil gegenüber anderen Netzwerken, weil viele dieser Accounts lesbare Namen sind, etwa alice.near oder ein Telegram-User, und du die Liste auf einen Blick verstehst.
Die typischen Use Cases für einen Dev sind diese:
- Airdrops an Holder: einen neuen token an alle verteilen, die einen anderen halten, oder an die Besitzer eines NFT aus deiner Collection.
- Allowlists: priorisierten Zugang zu einem Sale oder Mint für alle, die schon zum Projekt gehören.
- Migrationen: wenn du einen token neu launchst, kannst du mit der Liste jedem Holder zurückgeben, was er vorher hatte.
- Verteilungs-Analyse: checken, ob ein paar wenige Wallets zu viel Supply halten, bevor du Entscheidungen triffst.
Keiner dieser Use Cases verlangt, dass die Holder irgendwas tun oder dir eine Erlaubnis geben. Die Bestände jedes token liegen für alle sichtbar on-chain, und was das Tool dir bringt, ist, sie zu sammeln, zu säubern und in einem Format auszugeben, mit dem du direkt arbeiten kannst, ohne die API eines Explorers abzufragen oder ein Skript zu schreiben. Deshalb funktioniert das auch bei Tokens, die nicht deine sind, zum Beispiel bei einem Projekt, mit dessen Community du zusammenarbeiten willst.
So erstellst du einen snapshot der Holder auf NEAR für einen token
Der Token Snapshot von Smithii für NEAR ist ein Tool, mit dem du alle Accounts exportierst, die einen NEP-141-token halten, ohne eine Zeile Code zu schreiben oder die API eines Explorers abzufragen. Es schlägt dir die aktivsten Tokens des Moments vor und lässt dich jeden anderen einfügen. In der Oberfläche siehst du Folgendes:
Wenn du den Account des token parat hast und 11,55 NEAR für die Gebühr, läuft es so:
- Verbinde deine NEAR-wallet: HOT, Meteor oder eine beliebige aus dem Selector.
- Wähle den token: klick einen der Trending-Tokens an oder füge seinen Account ein, zum Beispiel token.rhealab.near.
- Klick auf Take Snapshot: das Tool prüft die Zahl der Holder und bittet dich, die Gebühr zu bestätigen.
- Lad die Liste runter oder nutze sie direkt weiter: als CSV oder TXT, oder schick sie direkt an den NEAR-Multisender.
Bevor dir irgendwas berechnet wird, liest das Tool, wie viele Holder der token hat, und zeigt eine Schätzung neben seinem Namen. Wenn das Limit überschritten wird, erfährst du das vor der Zahlung; du zahlst also nie für eine Liste, die sich gar nicht erstellen lässt.
So ziehst du die Holder einer NFT-Collection auf NEAR
Dasselbe Tool hat einen zweiten Tab, den NFT Snapshot für NEAR, der mit Collections nach dem NEP-171-Standard arbeitet. Statt Beständen gibt er dir die Accounts aus, die mindestens einen NFT aus der Collection halten. Beim Öffnen siehst du den Collection-Selector:
Die Bedienung ist dieselbe wie bei Tokens. Du wählst eine aktive Collection oder fügst den Account ihres Contracts ein, etwa asac.near, klickst auf Take Snapshot, bestätigst die 11,55 NEAR und lädst die Liste runter oder schickst sie an den multisender. Die Collections im Selector sind die mit den meisten Transfers an diesem Tag, zusammen mit ihrer Holder-Zahl.
Was die Holder-Liste enthält und was nicht
Die Liste kommt aus den von NearBlocks indexierten Daten und das Tool räumt sie auf, bevor du sie bekommst. Accounts mit Nullsaldo und der Account des token selbst fliegen raus, weil sie bei einer Verteilung nichts beitragen.
Was drin bleibt, sind die Contract-Accounts mit Saldo, zum Beispiel die Pools von Rhea oder die Treasuries eines DAO. Technisch sind das echte Holder, aber keine Menschen. Schau dir die Liste also an, bevor du sie für einen airdrop verwendest, und entscheide, ob du sie dabei haben willst.
Der Sonderfall: Tokens mit Reflection
Bei Tokens mit Reflection wachsen die Bestände bei jedem Transfer von selbst, und der Indexer kann hinterherhinken. Für Tokens, die mit Smithii erstellt wurden, liest das Tool die Bestände der größten Holder noch mal direkt on-chain, damit die Zahlen oben in der Liste wirklich stimmen.
Wann du den snapshot deines token auf NEAR machen solltest
Der Zeitpunkt, zu dem du die Momentaufnahme machst, entscheidet, wen du belohnst. Wenn du das Datum vorher ankündigst, ziehst du Last-Minute-Käufe an von Leuten, die verkaufen, sobald sie die Belohnung bekommen haben, und auch solche, die ihren Bestand auf viele Accounts aufteilen, um mehrfach zu kassieren.
Es gibt drei einfache Wege, das zu vermeiden, ohne die Kampagne zu verkomplizieren:
- Mach den snapshot bevor du den airdrop ankündigst: so zeigt die Liste wirklich, wer schon da war, und nicht die, die nur wegen des Rewards aufgetaucht sind.
- Kombiniere zwei Snapshots: einen heute, einen in ein paar Wochen, und belohne nur die Accounts, die in beiden auftauchen. Ein direkter Weg, um die zu belohnen, die wirklich halten.
- Setze einen Mindestbestand fest: Accounts mit symbolischen Beträgen sind meist Dust oder Leute, die versuchen, ihren Anteil zu vervielfachen. Sie rauszulassen senkt das Rauschen.
Keine Regel schließt Missbrauch komplett aus, aber eine sauber gefilterte Liste verteilt den token an holders, die auch wirklich bleiben, und genau das wollen alle Projekte mit solchen Kampagnen.
Was ein snapshot auf NEAR kostet und was passiert, wenn etwas schiefgeht
| snapshot-Typ | Was abgefragt wird | Limit | Gebühr |
|---|---|---|---|
| Token Snapshot | Accounts mit Guthaben eines NEP-141-token | 5.000 holders | 11,55 NEAR |
| NFT Snapshot | Accounts mit mindestens einem NFT aus einer NEP-171-Collection | 5.000 holders | 11,55 NEAR |
Die Zahlung ist in beide Richtungen abgesichert. Wenn der token zu groß ist, weißt du es, bevor du zahlst. Und falls du zahlst, aber die Liste nicht geladen wird, bleibt die Zahlung für einen Tag für diesen token und diese wallet gespeichert, du kannst den snapshot also ohne zweite Gebühr wiederholen.
Vom snapshot zum airdrop ohne Zwischenschritte
Nach einem snapshot willst du normalerweise etwas an diese Accounts verteilen. Mit Smithii musst du die Datei nicht runterladen und wieder hochladen, denn ein Klick lädt die holders in den Multisender von NEAR, der zusätzlich die Accounts in deinem token registriert, bei denen das nötig ist.
Ein typisches Beispiel: holders einer Collection mit dem token deines Projekts belohnen. Du machst den NFT Snapshot, schickst die Liste an den multisender, wählst einen gleichen Betrag für alle und in wenigen Minuten hat jeder holder seinen Reward.
Hier hast du den kompletten Ablauf, um einen airdrop auf NEAR inklusive Account-Registrierung zu machen.
Die Snapshots bleiben außerdem in deinem Verlauf. Du kannst einen alten jederzeit erneut herunterladen oder zwei Daten vergleichen, um zu sehen, wie sich die Verteilung deines token nach einer Kampagne verändert hat.
FAQ
Was kostet ein holder-snapshot auf NEAR?
Jeder snapshot kostet 11,55 NEAR, egal ob für einen token oder eine NFT-Collection, plus etwas gas. Die Gebühr wird an Smithii gezahlt, bevor die Liste aufgebaut wird.
Welche Tokens und Collections kann ich abfragen?
Jeden NEP-141-token und jede NEP-171-Collection im NEAR-Mainnet mit bis zu 5.000 holders. Übersteigt der token oder die Collection dieses Limit, lehnt das Tool es ab, bevor du zahlst.
Was passiert, wenn die Liste nach der Zahlung nicht lädt?
Deine Zahlung bleibt für einen Tag für diesen token und diese wallet gespeichert. Mach den snapshot einfach noch mal und du wirst kein zweites Mal belastet.
Enthält der snapshot auch Wallets mit Null-Guthaben?
Nein. Accounts mit Null-Guthaben und der Account des token selbst fallen aus der Liste raus. Contract-Accounts mit Guthaben, etwa Pools, tauchen dagegen schon auf, und du solltest sie vor einem airdrop checken.
Kann ich einen snapshot wiederholen, den ich vor ein paar Tagen gemacht habe?
Ja. Die Snapshots landen in deiner Historie und du kannst sie später runterladen oder erneut nutzen, zum Beispiel um zu vergleichen, wie sich die Verteilung zwischen zwei Daten verändert hat.
Fazit
Sobald du weißt, wie ein Holder-snapshot auf NEAR funktioniert, kannst du jeden token oder jede Collection in eine fertige Account-Liste verwandeln, bereit für einen airdrop, eine Allowlist oder eine Analyse. Das Tool prüft die Größe vor der Abrechnung und filtert leere Guthaben automatisch raus.
Check die Contract-Accounts vor dem Verteilen und nutz die Anbindung an den multisender. Damit geht der Schritt von der Liste zur Ausschüttung sofort.
Content Creator und SEO-Contributor bei Smithii. Student der Systemtechnik und Crypto-Tech-Enthusiast.
