Quels tokens et collections puis-je consulter ?

N'importe quel token NEP-141 et n'importe quelle collection NEP-171 du mainnet NEAR avec jusqu'à 5 000 holders. Si le token ou la collection dépasse cette limite, l'outil le rejette avant que tu paies.

Le snapshot inclut-il les wallets au solde nul ?

Non. Les comptes au solde nul et le compte du token lui-même sont exclus de la liste. Les comptes de contrats avec un solde, comme les pools, apparaissent, et il vaut mieux les vérifier avant un airdrop.

Sommaire

Start your
Airdrop Campaign!

Send tokens to your investors for rewards, allocations or community distribution.

Use Multisender

Comment faire un snapshot des holders sur NEAR : la liste des wallets de n’importe quel token ou collection NFT en CSV

Si tu veux récompenser ta communauté, préparer une allowlist ou simplement savoir qui détient ton token, apprendre comment faire un snapshot des holders sur NEAR est la première étape. En quelques secondes, tu obtiens la liste complète des comptes qui détiennent un token ou un NFT, prête à être téléchargée en CSV ou convertie directement en airdrop.

Dans ce guide, je t’explique à quoi sert un snapshot sur NEAR, comment le sortir d’un token et d’une collection NFT avec l’outil de Smithii, ce que la liste contient et ce qu’elle laisse de côté, et combien ça coûte. C’est parti.

Qu’est-ce qu’un snapshot des holders et à quoi ça sert sur NEAR

Un snapshot est une photographie de la répartition d’un actif à un instant donné, avec tous les comptes qui le détiennent et leur solde. Sur NEAR, il y a un avantage sympa par rapport à d’autres réseaux : beaucoup de ces comptes portent des noms lisibles, comme alice.near ou un identifiant Telegram, et on comprend la liste d’un coup d’œil.

Les usages les plus courants pour un dev sont les suivants :

Airdrops aux holders : distribuer un nouveau token à ceux qui en détiennent un autre, ou à ceux qui possèdent un NFT de ta collection.
Allowlists : donner un accès prioritaire à une vente ou à un mint à ceux qui font déjà partie du projet.
Migrations : si tu relances un token, la liste te permet de restituer à chaque holder ce qu’il avait.
Analyse de la distribution : voir si quelques wallets concentrent trop de supply avant de prendre des décisions.

Aucun de ces usages n’exige que les holders fassent quoi que ce soit ni qu’ils te donnent leur accord. Les soldes de n’importe quel token sont onchain et visibles par tous, et ce qu’apporte l’outil, c’est de les rassembler, les nettoyer et te les livrer dans un format exploitable sans passer par l’API d’un explorer ni écrire un script. C’est aussi pour ça qu’il te sert à étudier des tokens qui ne sont pas les tiens, par exemple celui d’un projet dont tu veux approcher la communauté.

Comment faire un snapshot de holders sur NEAR pour un token

Le Token Snapshot de Smithii pour NEAR est un outil qui te permet d’exporter tous les comptes qui détiennent un token NEP-141 sans écrire une ligne de code ni consulter l’API d’un explorer. Il te suggère les tokens les plus actifs du moment et te laisse coller n’importe quel autre. Une fois dans l’interface de la tool, voilà ce que tu verras :

comment faire un snapshot de holders sur NEAR : onglet Token Snapshot de Smithii avec le compte du token et les frais du snapshot

Si tu as le compte du token sous la main et 11,55 NEAR pour les frais, le processus est le suivant :

Connecte ton wallet NEAR : HOT, Meteor ou n’importe lequel du sélecteur.
Choisis le token : clique sur l’un des tokens en tendance ou colle son compte, par exemple token.rhealab.near.
Clique sur Take Snapshot : l’outil vérifie le nombre de holders et te demande d’approuver les frais.
Télécharge ou réutilise la liste : en CSV ou TXT, ou envoie-la directement au Multisender de NEAR.

Avant de te facturer quoi que ce soit, l’outil lit combien de holders détient le token et affiche une estimation à côté de son nom. S’il dépasse la limite, il te prévient avant le paiement, donc tu ne paies jamais pour une liste qui ne peut pas être construite.

Fais le snapshot de ton token sur NEAR

Comment extraire les holders d’une collection NFT sur NEAR

Le même outil propose un second onglet, le NFT Snapshot pour NEAR, qui fonctionne avec les collections du standard NEP-171. Au lieu de soldes, il te renvoie les comptes qui détiennent au moins un NFT de la collection. En l’ouvrant, tu verras le sélecteur de collections :

snapshot de holders d'une collection NFT sur NEAR : onglet NFT Snapshot de Smithii avec le sélecteur de collections

Le fonctionnement est identique à celui des tokens. Tu choisis une collection active ou tu colles le compte de son contrat, comme asac.near, tu cliques sur Take Snapshot, tu approuves les 11,55 NEAR et tu télécharges la liste ou tu l’envoies au multisender. Les collections qui apparaissent dans le sélecteur sont celles qui ont le plus de transferts ce jour-là, avec leur nombre de holders.

Ce que contient la liste de holders et ce qu’elle laisse de côté

La liste provient des données indexées par NearBlocks et l’outil les affine avant de te les livrer. Les comptes au solde zéro et le compte du token lui-même sont retirés, parce qu’ils n’apportent rien à une distribution.

Ce qui reste, ce sont les comptes de contrats qui ont du solde, comme les pools de Rhea ou les trésoreries d’un DAO. Ce sont de vrais holders d’un point de vue technique, mais pas des personnes : vérifie donc la liste avant de t’en servir dans un airdrop et décide si tu veux les inclure.

Le cas des tokens avec reflection

Sur les tokens avec reflection, les soldes grandissent tout seuls à chaque transfert et l’indexeur peut accuser du retard. Pour les tokens créés avec Smithii, l’outil relit directement onchain le solde des plus gros holders, afin que les chiffres en haut de la liste reflètent la réalité.

Quand faire le snapshot de ton token sur NEAR

Le moment où tu prends la photo décide qui tu récompenses. Si tu annonces la date à l’avance, tu attires des achats de dernière minute de gens qui vendront dès qu’ils auront reçu la récompense, et aussi de ceux qui éclatent leur solde sur plusieurs comptes pour toucher plusieurs fois.

Il existe trois méthodes simples pour éviter ça sans compliquer la campagne :

Fais le snapshot avant d’annoncer le airdrop : comme ça, la liste reflète ceux qui étaient déjà là, pas ceux qui sont venus pour la récompense.
Combine deux clichés : prends-en un aujourd’hui et un autre dans quelques semaines, et récompense uniquement les comptes qui apparaissent sur les deux. C’est une manière directe de récompenser ceux qui tiennent sur la durée.
Fixe un solde minimum : les comptes avec des quantités symboliques sont souvent de la poussière ou appartiennent à quelqu’un qui essaie de multiplier sa part. Les écarter réduit le bruit.

Aucune règle n’élimine totalement l’abus, mais une liste bien filtrée répartit le token entre les holders qui restent, et c’est exactement ce que vise tout projet qui lance ce genre de campagnes.

Combien coûte un snapshot sur NEAR et que se passe-t-il si ça foire

Type de snapshot	Ce qu’il interroge	Limite	Commission
Token Snapshot	Comptes avec un solde d’un token NEP-141	5 000 holders	11,55 NEAR
NFT Snapshot	Comptes détenant au moins un NFT d’une collection NEP-171	5 000 holders	11,55 NEAR

Le paiement est protégé dans les deux sens. Si le token est trop volumineux, tu le sais avant de payer. Et si tu paies mais que la liste ne charge pas, le paiement reste enregistré pendant une journée pour ce token et cette wallet : tu peux donc relancer le snapshot sans être facturé une seconde fois.

Du snapshot au airdrop sans étapes intermédiaires

Après un snapshot, le réflexe habituel est de distribuer quelque chose à ces comptes. Avec Smithii, pas besoin de télécharger le fichier et de le réuploader : un clic charge les holders dans le Multisender de NEAR, qui enregistre en plus dans ton token les comptes qui en ont besoin.

Un cas typique, c’est récompenser les holders d’une collection avec le token de ton projet. Tu fais le NFT Snapshot, tu envoies la liste au multisender, tu choisis un montant identique pour tous et en quelques minutes chaque holder a sa récompense.

Voici le process complet pour faire un airdrop sur NEAR avec l’enregistrement des comptes inclus.

Les snapshots restent aussi dans ton historique. Tu peux retélécharger un ancien snapshot ou comparer deux dates pour voir comment la distribution de ton token a évolué après une campagne.

FAQ

Combien coûte un snapshot des holders sur NEAR ?

Chaque snapshot coûte 11,55 NEAR, aussi bien celui d’un token que celui d’une collection NFT, plus un peu de gas. La commission se paie à Smithii avant que la liste ne soit construite.

Quels tokens et collections puis-je interroger ?

N’importe quel token NEP-141 et n’importe quelle collection NEP-171 du mainnet NEAR jusqu’à 5 000 holders. Si le token ou la collection dépasse cette limite, l’outil le refuse avant que tu paies.

Que se passe-t-il si la liste ne charge pas après le paiement ?

Ton paiement reste valable pendant une journée pour ce token et cette wallet. Relance le snapshot et aucun second prélèvement ne sera effectué.

Le snapshot inclut-il les wallets à solde zéro ?

Non. Les comptes à solde zéro ainsi que celui du token lui-même sont exclus de la liste. Les comptes de contrats avec du solde, comme les pools, apparaissent bien, et mieux vaut y jeter un œil avant un airdrop.

Puis-je relancer un snapshot réalisé il y a plusieurs jours ?

Oui. Les snapshots sont conservés dans ton historique et tu peux les télécharger ou les réutiliser plus tard, par exemple pour voir comment la distribution a évolué entre deux dates.

Conclusion

Une fois que tu sais faire un snapshot de holders sur NEAR, tu peux transformer n’importe quel token ou n’importe quelle collection en une liste de comptes prête pour un airdrop, une allowlist ou une analyse. L’outil vérifie la taille avant de facturer et élimine les soldes vides à ta place.

Vérifie les comptes de contrats avant de distribuer et profite de la connexion avec le multisender. Avec ça, le passage de la liste à la distribution est immédiat.