Como obter a lista de holders no Arc, tanto de um token quanto de uma coleção
Antes de fazer um airdrop, montar uma allowlist ou fechar o acesso a quem já está dentro, tem uma pergunta que precisa ser respondida primeiro: quem tem o seu token ou a sua coleção neste momento. Para isso, vale a pena saber como obter a lista de holders no Arc que permita baixar um arquivo com todos os holders de um token ou NFT.
Seja para um token ou para um NFT, o processo é o mesmo. O que você precisa ter claro é qual snapshot deve fazer e qual é a forma mais simples de tirar proveito dele. Neste guia eu explico como se faz. Vamos direto ao ponto.
Como obter a lista de holders de um token no Arc passo a passo
O Token Snapshot da Smithii para Arc faz a consulta on-chain direto, sem depender de nenhum indexador externo nem de que o token apareça em alguma lista. Basta o endereço do contrato, então funciona com qualquer ERC-20 da rede, seja seu ou não. Esta é a interface:
Com o endereço do contrato em mãos, são cinco passos:
- Conecte uma wallet à rede. É necessária para pagar a taxa e para que a ferramenta consiga salvar seu histórico.
- Fique na aba Token Snapshot, que é a que trabalha com ERC-20.
- Insira o contrato: cole o endereço ou busque pelo nome. Abaixo do campo você tem atalhos para os tokens com mais atividade na rede.
- Clique em Take Snapshot e aprove o pagamento. O valor aparece logo acima do botão antes de você assinar.
- Espere a leitura terminar e baixe o CSV com os endereços.
Como obter a lista de holders de uma coleção no Arc sem escrever código
A segunda aba é o NFT Snapshot para coleções da Arc, e você alterna entre ela e a anterior pelas abas no topo. Pede o mesmo dado único, o endereço do contrato, só que aqui se trata de um ERC-721. Como a propriedade de um NFT é informação pública, funciona com qualquer coleção existente na Arc. Fica assim:
A sequência muda pouco em relação à anterior:
- Conecte sua wallet à Arc. Sem ela, não tem como pagar a taxa nem registrar a extração.
- Vá até a aba NFT Snapshot, a segunda das duas. A primeira lê ERC-20 e não reconhece coleções.
- Cole o endereço do contrato ERC-721 no campo de busca, ou digite o nome da coleção para selecioná-la na lista.
- Clique em Take Snapshot e assine o pagamento. O total aparece embaixo do botão antes de você confirmar qualquer coisa.
- Baixe o CSV quando a leitura terminar. Ele também fica associado à wallet com a qual você pagou, caso precise recuperá-lo depois.
O que cada lista te devolve
É aqui que as duas abas deixam de se parecer. Ambas exportam endereços e nada mais, mas o critério para montar as linhas não é o mesmo, e é isso que define para que o arquivo vai te servir.
| Token Snapshot (ERC-20) | NFT Snapshot (ERC-721) | |
|---|---|---|
| O que é uma linha | Um endereço com saldo do token | Um endereço com pelo menos uma peça do NFT |
| Repetições | Uma por detentor | Deduplicada por proprietário |
Vale a pena entender bem essa deduplicação da segunda coluna, porque pega muita gente de surpresa. Uma wallet com quarenta peças da coleção ocupa uma linha, exatamente igual a uma com apenas uma, e no arquivo não há nada que te diga qual das duas você está olhando.
Para uma allowlist, esse formato é o certo: o objetivo é reservar um lugar por pessoa e quem acumulou quarenta unidades não deveria levar quarenta vagas. Para premiar em proporção ao que cada um possui, é uma limitação, e o mesmo raciocínio vale para a aba de tokens, onde também não há saldos com os quais graduar nada.
Os contratos saem sem rótulo nas duas listas
Detentor é, para a chain, o endereço que consta como tal. E por trás dele nem sempre há alguém com quem você possa falar.
Na lista de um ERC-20, o liquidity pool aparece como mais um endereço, junto com qualquer contrato que custodie tokens. Na de uma coleção o caso típico é outro: quando uma peça está à venda em um marketplace que a custodia enquanto dura o anúncio, o proprietário durante esse período é o contrato de custódia. O mesmo acontece com cofres, staking e empréstimos que aceitam NFTs como garantia. A pessoa continua por trás da operação, mas quem aparece no arquivo é o contrato.
Como nenhuma das duas exportações inclui rótulos, essas linhas são indistinguíveis a olho nu. A verificação é barata: procure os endereços que você não reconhece no explorador da Arc e repare se mostram código associado. Se mostrar, é um contrato. Vale a pena fazer isso antes de distribuir, porque um envio para um contrato que não sabe o que fazer com o que recebe ninguém reverte.
Defina o corte antes de executar a leitura
O arquivo é uma foto do estado da chain no instante em que você a lança. Não se atualiza sozinho: cada transferência posterior muda a realidade e o CSV fica como estava.
Isso pesa mais em uma coleção do que em um token, porque os NFTs não trocam de mãos num ritmo constante, e sim em ondas. Um anúncio, uma alta de preço ou um secundário que acorda movimentam num intervalo curto o que em semanas tranquilas nem se mexe, então duas leituras separadas por uma hora podem não coincidir em uma parte considerável dos endereços.
Por isso a ordem importa. Primeiro se fixa o momento do corte, depois se executa a leitura. Anunciar ‘a foto será tirada sexta às 18:00’ te poupa da reclamação previsível de quem vendeu meia hora antes e não entrou. E se o que você quer é premiar quem segura, a saída é repetir a consulta: duas execuções separadas no tempo, cruzadas numa planilha, te dão a lista dos endereços que aparecem em ambas.
Quanto custa fazer um snapshot no Arc
62,5 USDC por execução, taxa fixa e idêntica nas duas abas, mais o gas da transação. Como a Arc cobra o gas também em USDC, o desembolso completo fica numa única moeda e sem conversões pelo caminho. Se a wallet ainda não tem saldo, é preciso trazer o USDC para a rede antes de lançar a leitura.
Fixa significa que o tamanho não entra no cálculo: custa o mesmo um token com cinquenta wallets e um com vinte mil, e o mesmo uma série de duzentas peças e uma de dez mil. A consequência é dupla. Numa base grande, cada endereço obtido sai muito barato, o que inverte a intuição de quem vem de ferramentas que cobram por registro. Num projeto pequeno acontece o contrário, então convém que cada extração já tenha um destino decidido em vez de lançá-la por curiosidade.
Uma nota sobre custos antes de continuar: se o único destino da lista é um envio imediato, o próprio multisender pode extraí-la pelo mesmo valor e você economiza um passo. Fazer a extração aqui em separado faz sentido quando você quer o arquivo para guardar, reutilizar ou comparar mais adiante.
Para que serve exportar os holders de um token no Arc
A ausência de saldos e contagens parece uma limitação até você olhar para o uso real do arquivo na prática. Estes três casos não precisam de nada além do endereço:
- Um envio plano, em que todos recebem o mesmo. O CSV entra direto no envio em massa de tokens na Arc sem precisar reformatar nada.
- Uma allowlist para um mint, uma pré-venda ou um acesso antecipado, onde a única coisa que importa é se um endereço está dentro ou fora.
- Acompanhar a evolução da sua base. Duas leituras espaçadas no tempo mostram quantos entram, quantos saem e quem continua ali desde o começo.
Esse terceiro uso é o mais subestimado. Comparar dois arquivos numa planilha te dá a lista de quem ficou e a de quem saiu, o que é uma segmentação excelente e não exige nenhum saldo. Numa chain recém-lançada como a Arc esse acompanhamento vale ainda mais, porque a base é pequena e cada entrada ou saída pesa.
Por honestidade, também vale dizer o que fica de fora. Você não vai conseguir distribuir por faixas, nem medir a concentração do supply, nem saber qual wallet acumula boa parte de uma coleção. Essas três perguntas se respondem no explorer da rede, que sim mostra saldos e permite inspecionar um endereço específico. O snapshot te dá o alcance; o explorer, o detalhe.
FAQ
Quanto custa um snapshot de holders na Arc?
62,5 USDC por extração, com tarifa fixa, mais o gas da rede, que também é pago em USDC. O preço é o mesmo na aba de tokens e na de coleções, e não muda em função do número de holders nem do tamanho da série.
O CSV inclui saldos ou o número de NFTs de cada wallet?
Não, em nenhum dos dois casos. A exportação de um ERC-20 traz endereços sem saldo nem percentual do supply, e a de uma coleção também não inclui token IDs nem a contagem de peças por dono. Se a sua campanha precisa ponderar a recompensa, esse dado tem que ser levantado por outro caminho antes de desenhar a ação.
Posso extrair os holders de um token ou de uma coleção que não são meus?
Sim. Quem possui o quê é informação aberta na blockchain, então basta o endereço do contrato e não é exigido nenhum vínculo com o projeto. É o caminho habitual para chegar com um envio à comunidade de um projeto afim, ou para estudar o tamanho real de uma base de holders.
De qual aba eu preciso, a de token ou a de NFT?
A que corresponde ao tipo de contrato. Se o ativo é fungível e as pessoas têm uma quantidade dele, é um ERC-20 e vai em Token Snapshot. Se cada unidade é distinta e a posse é por peças, é um ERC-721 e vai em NFT Snapshot. Colocar um contrato na aba errada não devolve resultado nenhum.
Serve para distribuir um airdrop entre os holders?
Serve, desde que todos recebam o mesmo. Com uma linha por endereço, o arquivo encaixa sem ajustes no multisender da rede. O que não dá para fazer é graduar a entrega conforme o que cada um tem, porque esse número não viaja no CSV.
Posso recuperar um snapshot antigo?
Sim, a ferramenta guarda um histórico das extrações associado à sua wallet, então conectando-a você volta a ver as que já fez. Ainda assim vale guardar cada CSV por conta própria, principalmente se você pensa em comparar duas listas espaçadas no tempo.
Conclusão
Agora que você já sabe como fazer um snapshot na Arc, para tokens e coleções NFT, só falta decidir o que fazer com essa lista. Se você faz um controle de wallets do seu próprio projeto, essa informação vai te ajudar a saber se a quantidade de holders mudou ou aumentou, ou a montar um airdrop de recompensa dentro da sua própria comunidade.
Com essa expectativa ajustada, o arquivo cobre o que de fato se pede dele na maior parte das vezes: filtrar um acesso, montar uma allowlist ou alimentar um envio igual para todos. Defina o corte, execute a leitura e revise a lista antes de assinar qualquer coisa com ela.
Criador de conteúdo e contribuidor SEO na Smithii. Estudante de Engenharia de Sistemas e entusiasta de crypto e tecnologia.
