So exportierst du die Holder-Liste auf Arc, sowohl für einen token als auch für eine Collection

Bevor du einen airdrop startest, eine Allowlist aufbaust oder Bestandsnutzern den Zugang sperrst, gibt es eine Frage, die du zuerst klären musst: Wer hält gerade deinen token oder deine Collection? Genau dafür lohnt es sich zu wissen, wie du die Holder-Liste auf Arc exportierst, damit du dir eine Datei mit allen Holdern eines token oder NFT herunterladen kannst.

Ob für einen token oder einen NFT: der Ablauf ist derselbe. Was du wissen musst, ist welchen snapshot du machen musst und wie du das Ganze am einfachsten für dich nutzt. In diesem Guide zeige ich dir Schritt für Schritt, wie es geht. Legen wir direkt los.

So exportierst du die Holder-Liste eines token auf Arc, Schritt für Schritt

Der Token Snapshot von Smithii für Arc zieht die Daten direkt on-chain, ohne auf einen externen Indexer angewiesen zu sein oder darauf, dass das token irgendwo gelistet ist. Es reicht die Contract-Adresse, deshalb funktioniert das Ganze mit jedem ERC-20 im Netzwerk, egal ob es deins ist oder nicht. So sieht das Interface aus:

Sobald du die Contract-Adresse hast, sind es fünf Schritte:

1. Verbinde ein wallet mit dem Netzwerk. Das brauchst du, um die Gebühr zu zahlen und damit das Tool dir die Historie speichern kann.
2. Bleib auf dem Tab Token Snapshot, der ist für ERC-20 zuständig.
3. Gib den Contract ein: Adresse einfügen oder per Name suchen. Direkt unter dem Feld findest du Shortcuts zu den Tokens mit dem meisten Traffic auf dem Netzwerk.
4. Klick auf Take Snapshot und bestätige die Zahlung. Der Betrag steht direkt über dem Button, bevor du unterschreibst.
5. Warte, bis der Read durchgelaufen ist und lade die CSV mit den Adressen herunter.

So exportierst du die Holder-Liste einer Collection auf Arc, ganz ohne Code

Der zweite Tab ist der NFT Snapshot für Collections auf Arc, und du wechselst über die Tabs oben zwischen beiden hin und her. Er verlangt dieselbe Info, die Contract-Adresse, nur dass es hier um einen ERC-721 geht. Da das Ownership eines NFT öffentliche Information ist, funktioniert es mit jeder existierenden Collection auf Arc. So sieht es aus:

Der Ablauf unterscheidet sich kaum vom vorherigen:

1. Verbinde deine wallet mit Arc. Ohne sie kannst du die Gebühr nicht bezahlen und die Extraktion wird auch nicht registriert.
2. Wechsel in den Tab NFT Snapshot, den zweiten von beiden. Der erste liest ERC-20 aus und erkennt keine Collections.
3. Füge die Adresse des ERC-721-Contracts ins Suchfeld ein, oder tippe den Namen der Collection ein, um sie aus der Liste auszuwählen.
4. Klick auf Take Snapshot und signiere die Zahlung. Der Gesamtbetrag steht unter dem Button, bevor du irgendetwas bestätigst.
5. Lade die CSV herunter, sobald der Auslesevorgang fertig ist. Sie bleibt außerdem mit der wallet verknüpft, mit der du bezahlt hast, falls du sie später nochmal brauchst.

Was dir jede Liste zurückgibt

Ab hier hören die beiden Tabs auf, sich zu ähneln. Beide exportieren ausschließlich Adressen, aber das Kriterium, nach dem die Zeilen zusammengestellt werden, ist nicht dasselbe, und genau das entscheidet, wofür dir die Datei nützt.

Diese Deduplizierung in der zweiten Spalte solltest du wirklich verstehen, weil sie viele überrascht. Eine wallet mit vierzig Stücken der Collection belegt eine Zeile, genauso wie eine mit einem einzigen, und in der Datei steht nichts, das dir sagt, welche der beiden du gerade vor dir hast.

Für eine Allowlist ist genau das die richtige Logik: Ziel ist, einen Platz pro Person zu reservieren, und wer vierzig Einheiten gehortet hat, sollte nicht vierzig Plätze abgreifen. Willst du dagegen proportional zum Besitz belohnen, ist das eine Einschränkung, und dieselbe Überlegung gilt im Token-Tab, wo es ebenfalls keine Balances gibt, mit denen du irgendetwas abstufen könntest.

Contracts erscheinen in beiden Listen ohne Label

Holder ist für die Chain die Adresse, die dort als solche eingetragen ist. Und dahinter steckt nicht immer jemand, mit dem du reden kannst.

In der Liste eines ERC-20 taucht der Liquidity Pool als eine Adresse unter vielen auf, und mit ihm jeder Contract, der Token verwahrt. Bei einer Collection ist der typische Fall ein anderer: wenn ein Stück in einem Marktplatz zum Verkauf steht, der es während des Listings verwahrt, ist der Besitzer in dieser Zeit der Custody-Contract. Dasselbe gilt für Vaults, Staking und Kredite, die NFTs als Sicherheit akzeptieren. Die Person steht weiter hinter der Operation, aber in der Datei erscheint der Contract.

Da keiner der beiden Exporte Labels enthält, sind diese Zeilen mit bloßem Auge nicht auseinanderzuhalten. Die Prüfung kostet fast nichts: schlag die Adressen, die dir nicht bekannt vorkommen, im Arc-Explorer nach und schau, ob dort zugehöriger Code angezeigt wird. Wenn ja, ist es ein Contract. Das lohnt sich vor jedem Airdrop, denn einen Transfer an einen Contract, der mit dem Empfangenen nichts anfangen kann, dreht dir niemand mehr zurück.

Leg den Cutoff fest, bevor du den Auslesevorgang startest

Die Datei ist ein Snapshot vom Zustand der Chain in dem Moment, in dem du sie ausführst. Sie aktualisiert sich nicht von selbst: jeder spätere Transfer verändert die Realität, und die CSV bleibt so, wie sie war.

Das wiegt bei einer Collection schwerer als bei einem token, denn NFTs wechseln nicht in gleichmäßigem Tempo den Besitzer, sondern in Schüben. Ein Listing, ein Preisanstieg oder ein Secondary, das plötzlich wieder aufwacht, bewegen in kurzer Zeit, was in ruhigen Wochen liegenbleibt. Zwei Auslesungen im Abstand von einer Stunde können also bei einem spürbaren Teil der Adressen nicht mehr übereinstimmen.

Deshalb zählt die Reihenfolge. Erst wird der Zeitpunkt des Cutoffs fixiert, dann läuft der Auslesevorgang. Wenn du vorher ansagst »Der Snapshot wird am Freitag um 18:00 gezogen«, ersparst du dir die absehbare Beschwerde von dem, der eine halbe Stunde vorher verkauft hat und nicht mehr drin ist. Und wenn du diejenigen belohnen willst, die durchhalten, ist der Weg, die Abfrage zu wiederholen: zwei zeitlich getrennte Durchläufe, in einer Tabelle abgeglichen, ergeben dir die Liste der Adressen, die in beiden auftauchen.

Was ein snapshot auf Arc kostet

62,5 USDC pro Durchlauf, Flatrate und in beiden Tabs identisch, plus das Gas für die Transaktion. Da Arc das Gas ebenfalls in USDC abrechnet, fällt die komplette Ausgabe in einer einzigen Währung an, ganz ohne Umrechnungen. Falls die wallet noch kein Guthaben hat, musst du USDC auf das Netzwerk bringen, bevor du den Auslesevorgang startest.

Flatrate heißt, die Größe fließt nicht in die Berechnung ein: Ein token mit fünfzig Wallets kostet dasselbe wie einer mit zwanzigtausend, und eine Serie von zweihundert Stücken dasselbe wie eine von zehntausend. Die Folge ist doppelt. Bei einer großen Base kommt jede gewonnene Adresse extrem günstig raus, was die Intuition auf den Kopf stellt, die man aus Tools kennt, die pro Eintrag abrechnen. Bei einem kleinen Projekt läuft es andersherum, also solltest du vor jeder Extraktion schon wissen, wofür du sie einsetzt, statt sie aus Neugier zu starten.

Ein kurzer Hinweis zum Budget, bevor es weitergeht: Wenn die Liste am Ende ohnehin nur für einen direkten Airdrop dient, kann der multisender sie selbst zum gleichen Preis ziehen, und du sparst dir einen Schritt. Sie hier separat zu exportieren, lohnt sich, wenn du die Datei sichern, wiederverwenden oder später mit einer neuen Version vergleichen willst.

Wofür du den Export der Holder eines token auf Arc nutzen kannst

Fehlende Balances und Stückzahlen wirken wie eine Lücke, bis du dir anschaust, wofür die Datei in der Praxis tatsächlich gebraucht wird. Diese drei Fälle brauchen nichts weiter als die Adresse:

• Ein flacher Airdrop, bei dem alle dasselbe bekommen. Die CSV geht direkt in den Massenversand von Tokens auf Arc, ohne dass du irgendetwas umformatieren musst.
• Eine Allowlist für einen Mint, einen Presale oder Early Access, bei der es einzig zählt, ob eine Adresse drin ist oder nicht.
• Die Entwicklung deiner Base messen. Zwei Snapshots zu unterschiedlichen Zeitpunkten sagen dir, wie viele dazukommen, wie viele abspringen und wer seit dem ersten Tag dabei ist.

Der dritte Anwendungsfall ist der am meisten unterschätzte. Zwei Dateien in einer Tabelle nebeneinander zu legen liefert dir die Liste derer, die geblieben sind, und die Liste derer, die weg sind. Das ist eine hervorragende Segmentierung, und dafür brauchst du nicht einmal einen Balance-Wert. In einer frisch gestarteten Chain wie Arc ist dieses Tracking noch mehr wert, weil die Base klein ist und jeder Zu- oder Abgang stark ins Gewicht fällt.

Der Ehrlichkeit halber gehört auch dazu, was nicht drin ist. Nach Tranchen verteilen geht nicht, die Supply-Konzentration lässt sich nicht messen, und du erfährst auch nicht, welche wallet im Schnitt eine Collection anhäuft. Diese drei Fragen beantwortet der Block Explorer des Netzwerks, denn dort werden Balances angezeigt und einzelne Adressen lassen sich inspizieren. Der snapshot liefert dir die Reichweite, der Explorer die Details.

FAQ

Was kostet ein snapshot der Holder auf Arc?

62,5 USDC pro Extraktion, als Flatrate, plus die Gas Fees des Netzwerks, die ebenfalls in USDC abgerechnet werden. Der Preis ist im Token- und im Collection-Tab derselbe und ändert sich weder mit der Anzahl der Holder noch mit der Größe der Serie.

Enthält die CSV Balances oder die Anzahl der NFTs pro wallet?

Nein, in keinem der beiden Fälle. Der Export eines ERC-20 enthält Adressen ohne Balance und ohne Anteil an der Supply, und der Export einer Collection enthält weder token IDs noch die Stückzahl pro Besitzer. Wenn deine Kampagne die Belohnung gewichten soll, musst du diese Daten vor dem Design auf einem anderen Weg zusammentragen.

Kann ich die Holder eines token oder einer Collection ziehen, die nicht mir gehört?

Ja. Wer was hält, ist öffentliche Information auf der Blockchain, also reicht die Contract-Adresse aus und es wird keinerlei Verbindung zum Projekt verlangt. Das ist der klassische Weg, um mit einem Airdrop die Community eines verwandten Projekts zu erreichen oder um zu untersuchen, wie groß eine Holder-Base wirklich ist.

Welcher Tab ist der richtige, token oder NFT?

Der, der zum Contract-Typ passt. Wenn das Asset fungibel ist und Leute eine bestimmte Menge davon halten, ist es ein ERC-20 und gehört in Token Snapshot. Wenn jede Einheit einzigartig ist und stückweise gehalten wird, ist es ein ERC-721 und gehört in NFT Snapshot. Ein Contract im falschen Tab liefert keine Ergebnisse.

Taugt das, um einen airdrop unter den Holdern zu verteilen?

Ja, solange alle dasselbe bekommen. Mit einer Zeile pro Adresse passt die Datei ohne Anpassungen in den multisender des Netzwerks. Was nicht geht: die Verteilung nach dem individuellen Bestand zu staffeln, weil diese Zahl nicht in der CSV mitreist.

Kann ich einen älteren snapshot noch einmal aufrufen?

Ja, das Tool speichert eine Historie deiner Extraktionen, die mit deiner wallet verknüpft ist. Wenn du sie verbindest, siehst du also wieder alles, was du zuvor gezogen hast. Trotzdem lohnt es sich, jede CSV auch selbst zu sichern, vor allem wenn du planst, zwei Listen aus unterschiedlichen Zeitpunkten miteinander zu vergleichen.

Fazit

Jetzt, wo du weißt, wie du einen snapshot auf Arc erstellst, sowohl für Tokens als auch für Collections NFT, bleibt nur noch die Frage, was du mit dieser Liste anfängst. Wenn du die Wallets deines eigenen Projekts im Blick behältst, sagt dir diese Info, ob die Zahl der Holder gestiegen oder gefallen ist, oder du nutzt sie für einen airdrop als Belohnung innerhalb deiner eigenen Community.

Mit dieser realistischen Erwartung liefert die Datei fast immer genau das, was von ihr gebraucht wird: einen Zugang filtern, eine Allowlist aufsetzen oder einen gleichmäßig verteilten Airdrop füttern. Setze den Cutoff, führe die Extraktion durch und prüfe die Liste, bevor du irgendetwas damit unterschreibst.

Jose Araujo

Content Creator und SEO-Contributor bei Smithii. Student der Systemtechnik und Crypto-Tech-Enthusiast.