Cómo hacer un snapshot de holders en NEAR: la lista de wallets de cualquier token o colección NFT en CSV
Si vas a premiar a tu comunidad, preparar una allowlist o simplemente quieres saber quién tiene tu token, aprender cómo hacer un snapshot de holders en NEAR es el primer paso. En unos segundos obtienes la lista completa de cuentas que tienen un token o un NFT, lista para descargar en CSV o convertir directamente en un airdrop.
En esta guía te explico para qué sirve un snapshot en NEAR, cómo sacarlo de un token y de una colección NFT con la herramienta de Smithii, qué incluye la lista y qué deja fuera, y cuánto cuesta. Vamos a ello.
Qué es un snapshot de holders y para qué sirve en NEAR
Un snapshot es una fotografía del reparto de un activo en un momento concreto, con todas las cuentas que lo tienen y su saldo. En NEAR tiene una ventaja curiosa frente a otras redes, porque muchas de esas cuentas son nombres legibles, como alice.near o un usuario de Telegram, y la lista se entiende de un vistazo.
Los usos más habituales para un dev son estos:
- Airdrops a holders: repartir un token nuevo a quien tiene otro, o a quien posee un NFT de tu colección.
- Allowlists: dar acceso prioritario a una venta o a un mint a quien ya forma parte del proyecto.
- Migraciones: si relanzas un token, la lista te permite devolver a cada holder lo que tenía.
- Análisis de distribución: ver si unas pocas wallets concentran demasiado supply antes de tomar decisiones.
Ninguno de estos usos requiere que los holders hagan nada ni que te den permiso. Los saldos de cualquier token están en la cadena a la vista de todos, y lo que aporta la herramienta es reunirlos, limpiarlos y dártelos en un formato que puedas usar sin consultar la API de un explorador ni escribir un script. Por eso también sirve para estudiar tokens que no son tuyos, por ejemplo el de un proyecto con cuya comunidad quieres colaborar.
Cómo hacer un snapshot de holders en NEAR para un token
El Token Snapshot de Smithii para NEAR es una herramienta que te permite exportar todas las cuentas que tienen un token NEP-141 sin escribir código ni consultar la API de un explorador. Te sugiere los tokens con más actividad del momento y te deja pegar cualquier otro. Cuando estés en la interfaz de la tool, verás lo siguiente:
Si tienes la cuenta del token a mano y 11,55 NEAR para la comisión, el proceso es este:
- Conecta tu wallet de NEAR: HOT, Meteor o cualquiera del selector.
- Elige el token: pulsa uno de los tokens en tendencia o pega su cuenta, por ejemplo token.rhealab.near.
- Pulsa Take Snapshot: la herramienta comprueba el número de holders y te pide aprobar la comisión.
- Descarga o reutiliza la lista: en CSV o TXT, o envíala directamente al Multisender de NEAR.
Antes de cobrarte nada, la herramienta lee cuántos holders tiene el token y muestra una estimación junto a su nombre. Si supera el límite, te lo dice antes del pago, así que nunca pagas por una lista que no se puede construir.
Cómo sacar los holders de una colección NFT de NEAR
La misma herramienta tiene una segunda pestaña, el NFT Snapshot para NEAR, que funciona con colecciones del estándar NEP-171. En lugar de saldos, te devuelve las cuentas que tienen al menos un NFT de la colección. Al abrirla verás el selector de colecciones:
El funcionamiento es idéntico al de los tokens. Eliges una colección activa o pegas la cuenta de su contrato, como asac.near, pulsas Take Snapshot, apruebas los 11,55 NEAR y descargas la lista o la mandas al multisender. Las colecciones que aparecen en el selector son las que más transferencias tienen ese día, junto con su número de holders.
Qué incluye la lista de holders y qué deja fuera
La lista sale de los datos indexados por NearBlocks y la herramienta la depura antes de entregártela. Las cuentas con saldo cero y la propia cuenta del token se eliminan, porque no aportan nada a un reparto.
Lo que sí se mantiene son las cuentas de contratos que tienen saldo, como las pools de Rhea o las tesorerías de un DAO. Son holders reales a efectos técnicos, pero no personas, así que revisa la lista antes de usarla en un airdrop y decide si las quieres incluir.
El caso de los tokens con reflection
En los tokens con reflection, los saldos crecen solos con cada transferencia y el indexador puede ir con retraso. Para los tokens creados con Smithii, la herramienta vuelve a leer directamente de la cadena el saldo de los mayores holders, de modo que las cifras de arriba de la lista sean las reales.
Cuándo hacer el snapshot de tu token en NEAR
El momento en que tomas la fotografía decide a quién premias. Si anuncias la fecha con antelación, atraes compras de última hora de gente que venderá en cuanto reciba la recompensa, y también a quien reparte su saldo entre muchas cuentas para cobrar varias veces.
Hay tres formas sencillas de evitarlo sin complicar la campaña:
- Haz el snapshot antes de anunciar el airdrop: así la lista refleja a quien ya estaba, no a quien llegó por la recompensa.
- Combina dos fotografías: toma una hoy y otra dentro de unas semanas, y premia solo a las cuentas que aparecen en las dos. Es una forma directa de recompensar a quien mantiene.
- Pon un saldo mínimo: las cuentas con cantidades simbólicas suelen ser de polvo o de quien intenta multiplicar su parte, y dejarlas fuera reduce el ruido.
Ninguna regla elimina del todo el abuso, pero una lista bien filtrada reparte el token entre holders que se quedan, que es lo que busca cualquier proyecto con este tipo de campañas.
Cuánto cuesta un snapshot en NEAR y qué pasa si algo falla
| Tipo de snapshot | Qué consulta | Límite | Comisión |
|---|---|---|---|
| Token Snapshot | Cuentas con saldo de un token NEP-141 | 5.000 holders | 11,55 NEAR |
| NFT Snapshot | Cuentas con al menos un NFT de una colección NEP-171 | 5.000 holders | 11,55 NEAR |
El pago está protegido en los dos sentidos. Si el token es demasiado grande, lo sabes antes de pagar. Y si pagas pero la lista no llega a cargar, el pago queda guardado durante un día para ese token y esa wallet, así que puedes repetir el snapshot sin un segundo cargo.
Del snapshot al airdrop sin pasos intermedios
Lo habitual después de un snapshot es repartir algo a esas cuentas. Con Smithii no hace falta descargar el archivo y volver a subirlo, porque un clic carga los holders en el Multisender de NEAR, que además registra en tu token las cuentas que lo necesiten.
Un ejemplo típico es premiar a los holders de una colección con el token de tu proyecto. Haces el NFT Snapshot, envías la lista al multisender, eliges una cantidad igual para todos y en unos minutos cada holder tiene su recompensa.
Aquí tienes el proceso completo para hacer un airdrop en NEAR con el registro de cuentas incluido.
Los snapshots quedan además en tu historial. Puedes descargar de nuevo uno antiguo o comparar dos fechas para ver cómo ha cambiado la distribución de tu token después de una campaña.
FAQ
¿Cuánto cuesta hacer un snapshot de holders en NEAR?
Cada snapshot cuesta 11,55 NEAR, tanto el de un token como el de una colección NFT, más un poco de gas. La comisión se paga a Smithii antes de que se construya la lista.
¿Qué tokens y colecciones puedo consultar?
Cualquier token NEP-141 y cualquier colección NEP-171 de NEAR mainnet con hasta 5.000 holders. Si el token o la colección supera ese límite, la herramienta lo rechaza antes de que pagues.
¿Qué pasa si la lista no carga después de pagar?
Tu pago se guarda durante un día para ese token y esa wallet. Vuelve a hacer el snapshot y no se te cobrará una segunda vez.
¿El snapshot incluye las wallets con saldo cero?
No. Las cuentas con saldo cero y la propia cuenta del token quedan fuera de la lista. Las cuentas de contratos con saldo, como las pools, sí aparecen, y conviene revisarlas antes de un airdrop.
¿Puedo repetir un snapshot que hice hace días?
Sí. Los snapshots se guardan en tu historial y puedes descargarlos o reutilizarlos más tarde, por ejemplo para comparar cómo ha cambiado la distribución entre dos fechas.
Conclusión
Una vez sabes cómo hacer un snapshot de holders en NEAR, eres capaz de convertir cualquier token o colección en una lista de cuentas lista para un airdrop, una allowlist o un análisis. La herramienta comprueba el tamaño antes de cobrar y depura los saldos vacíos por ti.
Revisa las cuentas de contratos antes de repartir y aprovecha la conexión con el multisender. Con eso, el paso de la lista al reparto es inmediato.
Creador de contenido y colaborador SEO en Smithii. Estudiante de Ingeniería de Sistemas y entusiasta de crypto y tecnología.
