Comment extraire la liste des holders sur Arc, aussi bien d’un token que d’une collection

Avant de lancer un airdrop, de monter une allowlist ou de fermer l’accès à ceux qui sont déjà dans la boucle, il y a une question à régler en priorité : qui détient ton token ou ta collection à cet instant précis. Pour ça, autant savoir comment extraire la liste des holders sur Arc et pouvoir télécharger un fichier avec tous les holders d’un token ou d’une NFT.

Que ce soit pour un token ou pour un NFT, la démarche est la même. Ce qu’il faut bien avoir en tête, c’est quel snapshot tu dois faire et la façon la plus simple d’en tirer parti. Dans ce guide, je t’explique comment procéder. On y va.

Comment extraire la liste des holders d’un token sur Arc, étape par étape

Le Token Snapshot de Smithii pour Arc fait la requête on-chain directement, sans passer par un indexeur externe et sans exiger que le token figure dans un quelconque listing. L’adresse du contrat lui suffit, donc ça marche avec n’importe quel ERC-20 du réseau, qu’il soit à toi ou non. Voici son interface :

Une fois l’adresse du contrat en main, ça tient en cinq étapes :

1. Connecte un wallet au réseau. C’est nécessaire pour régler les frais et pour que l’outil puisse te garder l’historique.
2. Reste sur l’onglet Token Snapshot, c’est celui qui gère les ERC-20.
3. Renseigne le contrat : colle l’adresse ou cherche-le par son nom. Sous le champ, tu as des raccourcis vers les tokens les plus actifs du réseau.
4. Clique sur Take Snapshot et valide le paiement. Le montant apparaît juste au-dessus du bouton avant que tu ne signes.
5. Attends la fin de la lecture et télécharge le CSV avec les adresses.

Comment extraire la liste des holders d’une collection sur Arc sans écrire une ligne de code

Le deuxième onglet, c’est le NFT Snapshot pour les collections d’Arc, et tu passes de l’un à l’autre via les onglets en haut. Il demande la même donnée unique, l’adresse du contrat, sauf qu’ici il s’agit d’un ERC-721. Comme la propriété d’un NFT est une donnée publique, ça fonctionne avec n’importe quelle collection existant sur Arc. Voilà à quoi ça ressemble :

La séquence change peu par rapport à la précédente :

1. Connecte ton wallet à Arc. Sans ça, impossible de régler les frais ni d’enregistrer l’extraction.
2. Va dans l’onglet NFT Snapshot, le second des deux. Le premier lit les ERC-20 et ne reconnaît pas les collections.
3. Colle l’adresse du contrat ERC-721 dans le champ de recherche, ou tape le nom de la collection pour la sélectionner dans la liste.
4. Clique sur Take Snapshot et signe le paiement. Le total apparaît sous le bouton avant que tu ne confirmes quoi que ce soit.
5. Télécharge le CSV une fois la lecture terminée. Il reste également rattaché au wallet avec lequel tu as payé, au cas où tu aurais besoin de le récupérer.

Ce que chaque liste te renvoie

C’est ici que les deux onglets cessent de se ressembler. Les deux exportent des adresses et rien de plus, mais le critère qui construit les lignes n’est pas le même, et c’est ce qui détermine à quoi le fichier va te servir.

Cette déduplication dans la seconde colonne mérite d’être bien comprise, parce qu’elle surprend beaucoup de monde. Un wallet avec quarante pièces de la collection occupe une seule ligne, exactement comme celui qui n’en a qu’une, et rien dans le fichier ne t’indique lequel des deux tu regardes.

Pour une allowlist, ce format est le bon : l’objectif, c’est de réserver une place par personne, et celui qui a accumulé quarante unités ne devrait pas rafler quarante places. Pour récompenser au prorata de ce que chacun détient, c’est une limite, et le même raisonnement s’applique dans l’onglet tokens, où il n’y a pas non plus de soldes qui permettraient de moduler quoi que ce soit.

Les contrats sortent sans étiquette dans les deux listes

Pour la blockchain, un détenteur, c’est l’adresse qui figure comme telle. Et derrière cette adresse, il n’y a pas toujours quelqu’un à qui tu peux parler.

Dans la liste d’un ERC-20, la liquidity pool apparaît comme une adresse parmi d’autres, et avec elle n’importe quel contrat qui garde des tokens en dépôt. Sur celle d’une collection, le cas typique est différent : quand une pièce est mise en vente sur une marketplace qui la garde en dépôt le temps de l’annonce, le propriétaire pendant cette période est le contrat de dépôt. Pareil pour les vaults, le staking et les prêts qui acceptent des NFTs en garantie. La personne reste derrière l’opération, mais celui qui figure dans le fichier, c’est le contrat.

Comme aucun des deux exports n’inclut d’étiquettes, ces lignes sont indistinguables à l’œil nu. La vérification coûte peu : cherche les adresses que tu ne reconnais pas dans l’explorateur d’Arc et regarde si elles affichent du code associé. Si oui, c’est un contrat. Ça vaut la peine de le faire avant de distribuer, parce qu’un envoi vers un contrat qui ne sait pas quoi faire de ce qu’il reçoit, personne ne pourra l’annuler.

Fixe le moment du snapshot avant de lancer la lecture

Le fichier est une photo de l’état de la chain à l’instant où tu la lances. Elle ne se met pas à jour toute seule : chaque transfert postérieur change la réalité, et le CSV reste tel quel.

Ça pèse plus dans une collection que dans un token, parce que les NFTs ne changent pas de mains à un rythme constant, mais par vagues. Une annonce, une hausse de prix ou un secondaire qui se réveille bougent en peu de temps ce qui ne bouge pas pendant des semaines calmes, donc deux lectures espacées d’une heure peuvent ne pas coïncider sur une partie non négligeable des adresses.

C’est pour ça que l’ordre compte. On fixe d’abord le moment du snapshot, ensuite on lance la lecture. Annoncer «la photo se prend vendredi à 18h00» t’évite la réclamation prévisible de celui qui a vendu une demi-heure avant et n’est pas rentré. Et si tu veux récompenser ceux qui tiennent, la solution est de répéter la requête : deux exécutions espacées dans le temps, croisées dans un tableur, te donnent la liste des adresses qui apparaissent dans les deux.

Combien coûte un snapshot sur Arc

62,5 USDC par exécution, tarif fixe et identique sur les deux onglets, plus le gas de la transaction. Comme Arc facture le gas aussi en USDC, la dépense totale reste dans une seule monnaie, sans conversions au milieu. Si le wallet n’a pas encore de solde, il faut amener le USDC sur le réseau avant de lancer la lecture.

Fixe veut dire que la taille n’entre pas dans le calcul : un token avec cinquante wallets coûte pareil qu’un avec vingt mille, et pareil pour une série de deux cents pièces face à une de dix mille. La conséquence est double. Sur une grosse base, chaque adresse obtenue revient très bon marché, ce qui inverse l’intuition de ceux qui viennent d’outils facturés au registre. Sur un petit projet, c’est l’inverse, donc autant s’assurer que chaque extraction a déjà un usage prévu avant de la lancer par simple curiosité.

Petite note budgétaire avant de continuer : si la seule destination de la liste est une distribution immédiate, le multisender peut l’extraire lui-même pour le même prix, et tu gagnes une étape. La sortir ici séparément a du sens quand tu veux garder le fichier, le réutiliser ou le comparer plus tard.

À quoi sert d’exporter les holders d’un token sur Arc

L’absence de soldes et de comptages ressemble à un manque, jusqu’au moment où tu regardes à quoi sert vraiment le fichier en pratique. Ces trois cas n’ont besoin de rien d’autre que de l’adresse :

• Une distribution à plat, où tout le monde reçoit la même chose. Le CSV entre directement dans l’envoi massif de tokens sur Arc sans rien reformater.
• Une allowlist pour un mint, une prévente ou un accès anticipé, où la seule chose qui compte, c’est de savoir si une adresse est dedans ou dehors.
• Mesurer l’évolution de ta base. Deux lectures espacées dans le temps te disent combien entrent, combien partent et qui est encore là depuis le début.

Ce troisième usage est le plus sous-estimé. Comparer deux fichiers dans un tableur te donne la liste de ceux qui ont tenu et celle de ceux qui sont partis, une segmentation excellente qui n’exige même pas de solde. Sur une chaîne toute jeune comme Arc, ce suivi vaut encore plus, parce que la base est petite et que chaque entrée ou sortie pèse.

Par honnêteté, autant dire aussi ce qui reste dehors. Tu ne pourras pas distribuer par paliers, ni mesurer la concentration du supply, ni savoir quel wallet accumule la moitié de la collection. Ces trois questions trouvent leur réponse dans l’explorateur du réseau, qui affiche les soldes et permet d’inspecter une adresse précise. Le snapshot te donne la portée ; l’explorateur, le détail.

FAQ

Combien coûte un snapshot de holders sur Arc ?

62,5 USDC par extraction, en tarif fixe, plus les gas fees du réseau, qui se règlent aussi en USDC. Le prix est le même dans l’onglet tokens et dans celui des collections, et il ne bouge pas selon le nombre de holders ni selon la taille de la série.

Le CSV inclut-il les soldes ou le nombre de NFT de chaque wallet ?

Non, ni dans un cas ni dans l’autre. L’export d’un ERC-20 contient des adresses sans solde ni pourcentage du supply, et celui d’une collection n’inclut pas non plus les token IDs ni le nombre de pièces par propriétaire. Si ta campagne a besoin de pondérer la récompense, cette donnée doit se réunir par un autre chemin avant de la concevoir.

Puis-je extraire les holders d’un token ou d’une collection qui ne sont pas les miens ?

Oui. Qui possède quoi est une information ouverte sur la blockchain, il suffit donc de l’adresse du contrat et aucun lien avec le projet n’est requis. C’est la voie habituelle pour toucher avec une distribution la communauté d’un projet proche, ou pour étudier la taille réelle d’une base de holders.

Quel onglet me faut-il, celui de token ou celui de NFT ?

Celui qui correspond au type de contrat. Si l’actif est fongible et que chacun en détient une quantité, c’est un ERC-20 et ça va dans Token Snapshot. Si chaque unité est distincte et qu’on la possède à la pièce, c’est un ERC-721 et ça va dans NFT Snapshot. Mettre un contrat dans le mauvais onglet ne renvoie aucun résultat.

Est-ce que ça sert à distribuer un airdrop entre les holders ?

Oui, tant que tout le monde reçoit la même chose. Avec une ligne par adresse, le fichier s’insère sans retouches dans le multisender du réseau. Ce qui n’est pas possible, c’est de moduler la distribution selon ce que chacun détient, parce que ce chiffre ne voyage pas dans le CSV.

Puis-je récupérer un ancien snapshot ?

Oui, l’outil garde un historique des extractions associé à ton wallet, il suffit donc de le connecter pour retrouver celles que tu as faites. Ceci dit, mieux vaut sauvegarder chaque CSV de ton côté, surtout si tu comptes comparer deux listes espacées dans le temps.

Conclusion

Maintenant que tu sais comment faire un snapshot sur Arc, pour les tokens et pour les collections NFT, il ne reste plus qu’à décider quoi faire de cette liste. Si tu suis les wallets de ton propre projet, cette information te sera utile pour savoir si le nombre de holders a changé ou augmenté, ou pour organiser un airdrop de récompense au sein de ta propre communauté.

Avec cette attente bien calibrée, le fichier couvre ce qu’on lui demande vraiment presque tout le temps : filtrer un accès, monter une allowlist ou alimenter une distribution identique pour tous. Fixe le point de coupure, lance la lecture et vérifie la liste avant de signer quoi que ce soit avec elle.

Jose Araujo

Créateur de contenu et contributeur SEO chez Smithii. Étudiant en ingénierie des systèmes et passionné de crypto et tech.