Cómo sacar la lista de holders en Arc, tanto de un token como de una colección NFT
Antes de hacer un airdrop, montar una allowlist o cerrar un acceso a quienes ya están dentro, hay una pregunta que toca resolver primero: quién tiene tu token o tu colección en este momento. Para eso conviene saber cómo sacar la lista de holders en Arc que te permita descargar un archivo con todos los holders de un token o NFT.
Sea para un token o para un NFT, el proceso es el mismo. Lo que debes tener claro es qué snapshot debes hacer y cuál es la forma más sencilla de sacarle provecho. En esta guía te explico cómo se hace. Empecemos directamente.
Cómo sacar la lista de holders de un token en Arc paso a paso
El Token Snapshot de Smithii para Arc hace la consulta on-chain directamente, sin depender de un indexador externo ni de que el token figure en ningún listado. Le basta la dirección del contrato, así que sirve con cualquier ERC-20 de la red, sea tuyo o no. Esta es su interfaz:
Con la dirección del contrato localizada, son cinco pasos:
- Conecta una wallet a la red. Hace falta para abonar la tarifa y para que la herramienta pueda guardarte el historial.
- Quédate en la pestaña Token Snapshot, que es la que trabaja con ERC-20.
- Introduce el contrato: pega la dirección o búscalo por nombre. Debajo del campo tienes accesos directos a los tokens con más actividad en la red.
- Pulsa Take Snapshot y aprueba el pago. El importe aparece justo encima del botón antes de que firmes.
- Espera a que termine la lectura y descarga el CSV con las direcciones.
Cómo sacar la lista de holders de una colección NFT en Arc sin escribir código
La segunda pestaña es el NFT Snapshot para colecciones de Arc, y se alterna con la anterior desde las pestañas en la parte superior. Pide el mismo dato único, la dirección del contrato, solo que aquí se trata de un ERC-721. Como la propiedad de un NFT es información pública, funciona con cualquier colección existente en Arc. Así se ve:
La secuencia cambia poco respecto a la anterior:
- Conecta tu wallet a Arc. Sin ella no hay forma de liquidar la tarifa ni de que la extracción quede registrada.
- Sitúate en la pestaña NFT Snapshot, la segunda de las dos. La primera lee ERC-20 y no reconoce colecciones.
- Pega la dirección del contrato ERC-721 en el campo de búsqueda, o escribe el nombre de la colección para seleccionarla del listado.
- Pulsa Take Snapshot y firma el pago. El total figura debajo del botón antes de que confirmes nada.
- Descarga el CSV cuando la lectura termine. Queda además asociado a la wallet con la que pagaste, por si necesitas recuperarlo.
Qué te devuelve cada lista
Aquí es donde las dos pestañas dejan de parecerse. Las dos exportan direcciones y nada más, pero el criterio con el que arman las filas no es el mismo, y eso determina para qué te sirve el archivo.
| Token Snapshot (ERC-20) | NFT Snapshot (ERC-721) | |
|---|---|---|
| Qué es una fila | Una dirección con saldo del token | Una dirección con al menos una pieza del NFT |
| Repeticiones | Una por poseedor | Deduplicada por propietario |
Esa deduplicación de la segunda columna conviene entenderla bien, porque sorprende a mucha gente. Una wallet con cuarenta piezas de la colección ocupa una línea, exactamente igual que una con una sola, y en el archivo no hay nada que te diga a cuál de las dos estás mirando.
Para una allowlist esa forma es la correcta: el objetivo es reservar un sitio por persona y quien acumuló cuarenta unidades no debería llevarse cuarenta plazas. Para premiar en proporción a lo que cada uno posee es un límite, y el mismo razonamiento vale en la pestaña de tokens, donde tampoco hay saldos con los que graduar nada.
Los contratos salen sin etiqueta en las dos listas
Poseedor es, para la cadena, la dirección que consta como tal. Y detrás de ella no siempre hay alguien con quien puedas hablar.
En la lista de un ERC-20 la pool de liquidez aparece como una dirección más, y con ella cualquier contrato que custodie tokens. En la de una colección el caso típico es otro: cuando una pieza está a la venta en un mercado que la custodia mientras dura el anuncio, el propietario durante ese periodo es el contrato de custodia. Lo mismo pasa con bóvedas, staking y préstamos que aceptan NFTs como garantía. La persona sigue detrás de la operación, pero quien figura en el archivo es el contrato.
Como ninguna de las dos exportaciones incluye etiquetas, esas filas son indistinguibles a simple vista. La comprobación es barata: busca las direcciones que no te suenen en el explorador de Arc y fíjate en si muestran código asociado. Si lo muestra, es un contrato. Merece la pena hacerlo antes de repartir, porque un envío a un contrato que no sabe qué hacer con lo que recibe no lo revierte nadie.
Decide el corte antes de ejecutar la lectura
El archivo es una foto del estado de la cadena en el instante en que lo lanzas. No se actualiza solo: cada transferencia posterior cambia la realidad y el CSV se queda como estaba.
Eso pesa más en una colección que en un token, porque los NFTs no cambian de manos a ritmo constante sino a rachas. Un anuncio, una subida de precio o un secundario que se despierta mueven en un rato lo que en semanas tranquilas no se mueve, así que dos lecturas separadas por una hora pueden no coincidir en una parte apreciable de las direcciones.
Por eso el orden importa. Primero se fija el momento del corte, después se ejecuta la lectura. Anunciar «la foto se toma el viernes a las 18:00» te ahorra la reclamación previsible de quien vendió media hora antes y no entró. Y si lo que quieres es premiar a quien aguanta, la salida es repetir la consulta: dos ejecuciones separadas en el tiempo, cruzadas en una hoja de cálculo, te dan la lista de las direcciones que aparecen en ambas.
Cuánto cuesta hacer un snapshot en Arc
62,5 USDC por ejecución, tarifa plana e idéntica en las dos pestañas, más el gas de la transacción. Como Arc cobra el gas también en USDC, el desembolso completo te queda en una sola moneda y sin conversiones de por medio. Si la wallet aún no tiene saldo, toca traer el USDC a la red antes de lanzar la lectura.
Plana significa que el tamaño no entra en el cálculo: cuesta lo mismo un token con cincuenta wallets que uno con veinte mil, y lo mismo una serie de doscientas piezas que una de diez mil. La consecuencia es doble. En una base grande, cada dirección obtenida sale muy barata, lo cual invierte la intuición de quien viene de herramientas que cobran por registro. En un proyecto pequeño ocurre lo contrario, así que conviene que cada extracción tenga ya un destino decidido en lugar de lanzarla por curiosidad.
Un apunte de presupuesto antes de seguir: si el único destino de la lista es un reparto inmediato, el multisender puede extraerla él mismo por el mismo importe y te ahorras un paso. Sacarla aquí por separado tiene sentido cuando quieres el archivo para guardarlo, reutilizarlo o compararlo más adelante.
Para qué sirve exportar los holders de un token en Arc
La ausencia de saldos y de recuentos parece una carencia hasta que miras para qué se usa el archivo en la práctica. Estos tres casos no necesitan nada más que la dirección:
- Un reparto plano, en el que todos reciben lo mismo. El CSV entra directo en el envío masivo de tokens en Arc sin reformatear nada.
- Una allowlist para un mint, una preventa o un acceso anticipado, donde lo único que importa es si una dirección está dentro o fuera.
- Medir la evolución de tu base. Dos lecturas separadas en el tiempo te dicen cuántos entran, cuántos se van y quiénes siguen ahí desde el principio.
Ese tercer uso es el más infravalorado. Comparar dos archivos con una hoja de cálculo te da la lista de quién aguantó y la de quién se fue, que es una segmentación excelente y no requiere ni un saldo. En una cadena recién estrenada como Arc ese seguimiento vale todavía más, porque la base es pequeña y cada entrada o salida pesa.
Por honestidad conviene decir también lo que queda fuera. No podrás repartir por tramos, ni medir la concentración del suministro, ni saber qué wallet acumula media colección. Esas tres preguntas se responden en el explorador de la red, que sí muestra saldos y permite inspeccionar una dirección concreta. El snapshot te da el alcance; el explorador, el detalle.
FAQ
¿Cuánto cuesta un snapshot de holders en Arc?
62,5 USDC por cada extracción, con tarifa plana, más el gas de la red, que también se liquida en USDC. El precio es el mismo en la pestaña de tokens y en la de colecciones, y no cambia según el número de holders ni según el tamaño de la serie.
¿El CSV incluye saldos o el número de NFTs de cada wallet?
No, en ninguno de los dos casos. La exportación de un ERC-20 contiene direcciones sin saldo ni porcentaje del suministro, y la de una colección tampoco incorpora token IDs ni el recuento de piezas por propietario. Si tu campaña necesita ponderar la recompensa, ese dato hay que reunirlo por otra vía antes de diseñarla.
¿Puedo sacar los holders de un token o una colección NFT que no son míos?
Sí. Quién posee qué es información abierta en la blockchain, así que basta con la dirección del contrato y no se exige ninguna relación con el proyecto. Es la vía habitual para llegar con un reparto a la comunidad de un proyecto afín, o para estudiar el tamaño real de una base de holders.
¿Qué pestaña necesito, la de token o la de NFT?
La que corresponda al tipo de contrato. Si el activo es fungible y la gente tiene una cantidad de él, es un ERC-20 y va en Token Snapshot. Si cada unidad es distinta y se posee por piezas, es un ERC-721 y va en NFT Snapshot. Poner un contrato en la pestaña equivocada no devuelve resultados.
¿Sirve para repartir un airdrop entre los holders?
Sirve siempre que todos reciban lo mismo. Con una línea por dirección, el archivo encaja sin retoques en el multisender de la red. Lo que no permite es graduar la entrega según lo que tenga cada uno, porque ese número no viaja en el CSV.
¿Puedo recuperar un snapshot antiguo?
Sí, la herramienta guarda un historial de las extracciones asociado a tu wallet, así que conectándola vuelves a ver las que hiciste. Aun así conviene guardar cada CSV por tu cuenta, sobre todo si piensas comparar dos listas separadas en el tiempo.
Conclusión
Ahora que ya sabes cómo hacer un snapshot en Arc, para tokens y colecciones NFT, solo queda decidir qué hacer con esa lista. Si haces un control de wallets de tu propio proyecto, esta información te será útil para conocer si la cantidad de holders ha cambiado o aumentado, o para hacer un airdrop de recompensa entre tu propia comunidad.
Con esa expectativa ajustada, el archivo cubre lo que de verdad se le pide casi siempre: filtrar un acceso, montar una allowlist o alimentar un reparto igual para todos. Fija el corte, ejecuta la lectura y revisa la lista antes de firmar nada con ella.
Creador de contenido y colaborador SEO en Smithii. Estudiante de Ingeniería de Sistemas y entusiasta de crypto y tecnología.
