Referencia

Tipos y enumeraciones

Clases de holders, indicadores, estados, pasos del escaneo y factores de puntuación que se usan en toda la API.

Estados del reporte#

`NONE`	Nunca se escaneó. Inicia un escaneo con `POST /scans.`
`QUEUED`	Esperando un worker disponible.
`RUNNING`	Se está analizando; consulta step y progress.
`DONE`	Terminado; el reporte está completo.
`ERROR`	El último escaneo falló; consulta `errorMessage` e inténtalo de nuevo.

Pasos del escaneo#

`queued`	Esperando en la cola.
`market`	Obteniendo precio, liquidez y datos del mint.
`holders`	Leyendo la lista de holders.
`trades`	Leyendo las primeras operaciones para detectar snipers.
`profiles`	Perfilando a los mayores holders: origen de fondos, antigüedad, PnL.
`classify`	Asignando clases y formando clústeres.
`dev`	Revisando los lanzamientos anteriores del creador.
`save`	Calculando el Holder Score y guardando.
`done`	Terminado.
`error`	Falló.

Clases de holders#

`SMART_MONEY`	Trader rentable en los últimos 30 días, con un win rate alto.
`REGULAR`	Nada destacable.
`DEV`	El creador del token.
`DEV_BUNDLE`	Compró junto con el creador o recibió fondos del creador.
`SNIPER`	Compró en los primeros bloques tras el lanzamiento.
`FRESH`	Billetera creada hace muy poco.
`POOL`	Pool de liquidez, bóveda o bonding curve.
`CEX`	Billetera de un exchange centralizado.
`BURN`	Dirección de quema.

Indicadores de holders#

`smart`	Billetera de smart money.
`sniper`	Compró en los primeros bloques.
`fresh`	Billetera recién creada.
`cluster`	Miembro de un clúster.
`funded_by_dev`	Recibió fondos del creador del token.

El Holder Score parte de 100. Cada factor de riesgo resta puntos hasta un máximo igual a su peso y el smart money suma una bonificación. Las participaciones de los holders se miden sobre el suministro circulante (fuera de pools y direcciones de quema), así que una bonding curve no puede ocultar que unas pocas billeteras tienen todo lo que se compró. Los factores críticos además ponen un tope a la puntuación: un dev que hizo rug en la mayoría de sus lanzamientos, una autoridad de acuñación o de congelamiento activa, liquidez drenada, una caída del 90% o más, una capitalización de mercado muerta o casi ningún holder. El nivel de riesgo es low desde 70, medium desde 40 y high por debajo. breakdown lista cada factor con sus puntos y el valor medido (total es el denominador; cap, el tope que fija un factor crítico); mainReason es el factor que más puntos restó, incluido su tope. scoreVersion es el modelo con el que se puntuó el reporte.

`top10`	Porcentaje del suministro circulante en manos de los 10 mayores holders.
`topHolder`	Porcentaje del suministro circulante en manos del mayor holder.
`devBundle`	Porcentaje del suministro circulante en manos del creador y de las billeteras de su bundle.
`snipers`	Porcentaje del suministro circulante en manos de snipers.
`clusters`	Porcentaje del suministro circulante en manos de clústeres.
`fresh`	Porcentaje del suministro circulante en manos de billeteras nuevas.
`holders`	Pocos holders; con 3 o menos, la puntuación se limita a 30.
`authorities`	Autoridad de acuñación o de congelamiento sin revocar; limita la puntuación a 45, o a 35 si son ambas.
`devRugs`	Lanzamientos muertos del creador (value de total). Un dev con rugs en serie limita la puntuación a 35 o a 15.
`liquidity`	Liquidez del pool inferior a $5K; por debajo de $1K, limita la puntuación a 20.
`marketCap`	Capitalización de mercado inferior a $1K: el token está muerto; limita la puntuación a 15.
`priceCrash`	Caída del precio en 6 o 24 horas; una caída del 90% o más limita la puntuación a 25.
`smartMoneyBonus`	Bonificación por smart money entre los holders.

Niveles de riesgo#

`low`	Puntuación 70–100: no hay señales de alarma importantes en la base de holders.
`medium`	Puntuación 40–69: hay algo de concentración, snipers o clústeres que vale la pena revisar.
`high`	Puntuación 0–39: dominan los insiders o las billeteras coordinadas, o un factor crítico pone un tope a la puntuación.

Funciones del plan en locked#