Como obter a lista de holders na TRON e saber quem realmente tem o seu TRC-20
Saber como obter a lista de holders na TRON com um token snapshot te dá todas as wallets que possuem um TRC-20, com o saldo de cada uma, em poucos minutos e sem escrever código. É o passo anterior a qualquer airdrop, whitelist ou análise de como está distribuído o seu token.
O Token Snapshot da Smithii consulta a chain diretamente e te devolve o arquivo pronto para baixar em CSV. Abaixo você tem o passo a passo e, depois, o que vale a pena observar nessa lista antes de usá-la.
O que o snapshot te devolve exatamente
Vale esclarecer isso logo de cara porque nem toda ferramenta desse tipo entrega o mesmo. Aqui você recebe três colunas úteis: o endereço da wallet, o saldo que ela tem desse token e o porcentual do supply total que isso representa.
É uma foto do estado da chain no momento em que é executado. Não se atualiza sozinho: se você precisar de dados daqui a um mês, tem que repetir o snapshot.
Inclui todos os holders sem filtro de saldo, da whale até a wallet com poeira. Isso é o certo para auditar, e algo a ter em conta se depois você for distribuir: provavelmente não vai querer mandar tokens para endereços com saldos residuais.
O resultado se copia ou se baixa em CSV, no formato que o multisender aceita direto, sem precisar reformatar nada.
Como obter a lista de holders na TRON passo a passo
O Token Snapshot de Smithii para TRON consulta a chain e te entrega a lista completa de holders em segundos, sem depender de um indexador externo nem de que o token esteja listado em nenhum lugar. Só precisa do endereço do contrato, então funciona com qualquer TRC-20, seja seu ou não. A interface é esta:
Com o endereço do contrato em mãos, são três passos:
- Cole o endereço do token no campo Token contract address. Não precisa ser o dono do contrato.
- Rode o snapshot e confirme o pagamento. O processo leva alguns minutos dependendo do número de holders.
- Copie os endereços ou baixe o CSV com a lista completa, pronta para analisar ou para carregar no multisender.
As três leituras que você tem que fazer da sua lista
Ter o CSV não serve de nada se você não olhar para ele. Estas três coisas se veem em cinco minutos com a coluna de porcentagem ordenada de maior para menor.
- Quanto pesam as dez primeiras wallets. É o número que qualquer um que pense em entrar vai olhar. Se essas dez somam a maior parte do supply, o seu token depende de nenhuma delas vender.
- Quantas wallets têm saldo de verdade. Separar as que têm uma quantidade relevante das que só têm restos transforma o seu número de holders em algo defensável.
- Se a pool está onde você acha que está. A liquidez aparece como mais uma wallet na lista. Vê-la te confirma quanto do supply está de fato no mercado e quanto está nas mãos das pessoas.
A utilidade mais direta vem depois: segmentar. Com os saldos na frente, dá para premiar por faixas em vez de distribuir no escuro, ou excluir do reparto os endereços com poeira para não gastar taxa em wallets que não vão voltar.
Esse último ponto tem consequências de dinheiro em TRON, onde o reparto é cobrado por endereço. Se dos seus 3.000 holders 1.200 têm saldos residuais que nunca moveram, filtrá-los antes do airdrop te economiza a taxa dessas 1.200 wallets e concentra o reparto em quem realmente sustenta o projeto.
Se alguma dessas leituras te preocupa, aqui tem como detectar um rug pull em TRON revisando a concentração de holders e o resto dos controles do token.
Comparar dois snapshots separados no tempo
Uma lista solta descreve um momento. Duas listas separadas por algumas semanas descrevem uma tendência, e essa é bem mais informativa.
Ao compará-las você vê se entram holders novos ou se o saldo só circula entre os de sempre, se as wallets grandes estão acumulando ou distribuindo, e se o crescimento no número de holders vem de gente real ou de endereços que aparecem com saldos mínimos e nunca mais voltam a operar.
É também a forma honesta de medir se uma campanha funcionou. Um airdrop que multiplica os holders e não muda mais nada, seis semanas depois, não captou ninguém: distribuiu tokens que foram vendidos.
Com a lista na mão, o passo natural seguinte é distribuir o token entre essas wallets
Quanto custa tirar a lista de holders de um token em TRON
180 TRX por snapshot, e a tarifa não muda com o número de holders: custa o mesmo um token com duzentas wallets e um com cinquenta mil. É um pagamento único por execução, então repetir isso dentro de alguns meses volta a custar o mesmo.
Agora, existem duas formas de chegar à mesma lista e convém saber qual compensa mais antes de pagar.
| Via | O que você obtém | Quando escolher |
|---|---|---|
| Snapshot separado | Arquivo CSV baixado, seu, com endereços, saldos e porcentagens | Quando você vai analisar, salvar ou reutilizar |
| A partir do multisender | A lista carrega sozinha no formulário da distribuição | Quando o único destino é um airdrop imediato |
As duas custam o mesmo, então a decisão não é de preço e sim do que você vai fazer depois. Tirar a lista separada compensa quando ela é um ativo: para compará-la com outra daqui a alguns meses, para segmentar por faixas com calma numa planilha, ou para justificar diante de um partner como está distribuído o seu token.
Se por outro lado você já sabe que vai distribuir para todos os holders sem filtrar, o passo intermediário não agrega nada: o multisender extrai a mesma lista e já deixa ela carregada.
FAQ
Quanto custa um token snapshot em TRON?
180 TRX por cada snapshot que você executar. O preço é o mesmo independentemente de quantos holders o token tenha, e é um pagamento por execução: se mais adiante você precisar da lista atualizada, tem que lançar um novo e pagar de novo.
O arquivo inclui os saldos de cada wallet?
Sim. O CSV traz o endereço, o saldo que essa wallet tem do token e a porcentagem do supply total que representa. Com essas três colunas dá para ordenar por peso e segmentar a distribuição por faixas em vez de tratar todos os holders igual.
Posso tirar os holders de um token que não é meu?
Sim. A ferramenta só precisa do endereço do contrato e os dados de holders são públicos na blockchain. Costuma ser usada para estudar a distribuição de outros projetos antes de entrar ou para alcançar uma comunidade afim com uma distribuição.
A lista se atualiza sozinha com o tempo?
Não. Um snapshot é uma foto do momento exato em que é executado, e os saldos mudam a cada transferência. Para ter dados frescos tem que lançar um snapshot novo, e comparar dois separados no tempo é justamente o que mostra se a sua base de holders cresce ou se concentra.
Conclusão
O snapshot é a ferramenta mais barata que você tem para parar de supor como está distribuído o seu token. Custa 180 TRX e alguns minutos, e o que ele devolve é a base de praticamente qualquer decisão posterior: a quem premiar, com quanto e em que ordem.
Faça isso antes de desenhar a distribuição, não depois. Segmentar com os saldos na mão e distribuir às cegas custa exatamente o mesmo, mas não dá o mesmo resultado.
Se o seu token vive na rede da Circle, tanto o procedimento quanto o conteúdo do arquivo mudam: tudo detalhado no guia para exportar a lista de holders na Arc.
Criador de conteúdo e contribuidor SEO na Smithii. Estudante de Engenharia de Sistemas e entusiasta de crypto e tecnologia.
