Referência

Tipos e enums

Classes de holders, flags, status, etapas de scan e fatores de score usados em toda a API.

Status do relatório#

`NONE`	Nunca escaneado. Inicie um scan com `POST /scans.`
`QUEUED`	Aguardando um worker.
`RUNNING`	Em análise; veja step e progress.
`DONE`	Concluído; o relatório está completo.
`ERROR`	O último scan falhou; veja `errorMessage` e tente novamente.

Etapas do scan#

`queued`	Aguardando na fila.
`market`	Buscando preço, liquidez e dados do mint.
`holders`	Lendo a lista de holders.
`trades`	Lendo os primeiros trades para encontrar snipers.
`profiles`	Perfilando os maiores holders: origem dos fundos, idade, PnL.
`classify`	Atribuindo classes e montando clusters.
`dev`	Verificando os lançamentos anteriores do criador.
`save`	Calculando o Holder Score e salvando.
`done`	Concluído.
`error`	Falhou.

Classes de holders#

`SMART_MONEY`	Trader lucrativo nos últimos 30 dias, com win rate alto.
`REGULAR`	Nada digno de nota.
`DEV`	O criador do token.
`DEV_BUNDLE`	Comprou junto com o criador ou recebeu fundos dele.
`SNIPER`	Comprou nos primeiros blocos após o lançamento.
`FRESH`	Carteira criada muito recentemente.
`POOL`	Pool de liquidez, vault ou bonding curve.
`CEX`	Carteira de exchange centralizada.
`BURN`	Endereço de queima.

Flags de holders#

`smart`	Carteira smart money.
`sniper`	Comprou nos primeiros blocos.
`fresh`	Carteira recém-criada.
`cluster`	Membro de um cluster.
`funded_by_dev`	Financiada pelo criador do token.

O Holder Score começa em 100. Cada fator de risco subtrai pontos até o limite do seu peso, e a presença de smart money rende um bônus. As participações dos holders são medidas em relação ao supply circulante (fora de pools e de endereços de queima), então uma bonding curve não consegue esconder que poucas carteiras detêm tudo o que foi comprado. Fatores críticos também impõem um teto ao score: um dev que deu rug na maioria dos lançamentos, uma autoridade de mint ou de congelamento ainda ativa, liquidez drenada, uma queda de 90% ou mais, um market cap morto ou quase nenhum holder. O nível de risco é low a partir de 70, medium a partir de 40 e high abaixo disso. breakdown lista cada fator com seus pontos e o valor medido (total é o denominador; cap, o teto definido por um fator crítico); mainReason é o fator que mais custou pontos, incluindo o seu teto. scoreVersion é o modelo com que o relatório foi pontuado.

`top10`	Participação dos 10 maiores holders no supply circulante.
`topHolder`	Participação do maior holder no supply circulante.
`devBundle`	Participação do criador e das carteiras do bundle no supply circulante.
`snipers`	Participação dos snipers no supply circulante.
`clusters`	Participação dos clusters no supply circulante.
`fresh`	Participação das carteiras novas no supply circulante.
`holders`	Poucos holders; 3 ou menos limitam o score a 30.
`authorities`	Autoridade de mint ou de congelamento não revogada; limita o score a 45, e as duas juntas, a 35.
`devRugs`	Lançamentos mortos do criador (value de total). Um dev com rugs em série limita o score a 35 ou 15.
`liquidity`	Liquidez do pool abaixo de US$ 5 mil; abaixo de US$ 1 mil, limita o score a 20.
`marketCap`	Market cap abaixo de US$ 1 mil: o token está morto; limita o score a 15.
`priceCrash`	Queda de preço em 6 ou 24 horas; 90% ou mais limita o score a 25.
`smartMoneyBonus`	Bônus por smart money entre os holders.

Níveis de risco#

`low`	Score 70–100: nenhum sinal de alerta grave na base de holders.
`medium`	Score 40–69: alguma concentração, snipers ou clusters que merecem atenção.
`high`	Score 0–39: insiders ou carteiras coordenadas dominam, ou um fator crítico impõe um teto ao score.

Recursos do plano em locked#