레퍼런스

타입과 열거형

API 전반에서 쓰는 홀더 유형, 플래그, 상태, 스캔 단계, 점수 요소.

리포트 상태#

`NONE`	아직 스캔된 적이 없어요. `POST /scans` 요청으로 스캔을 시작하세요.
`QUEUED`	워커를 기다리는 중이에요.
`RUNNING`	분석 중이에요. step, progress 값을 확인하세요.
`DONE`	완료됐어요. 리포트의 모든 데이터가 준비됐어요.
`ERROR`	마지막 스캔이 실패했어요. `errorMessage` 값을 확인하고 다시 시도하세요.

스캔 단계#

`queued`	대기열에서 기다리는 중이에요.
`market`	가격, 유동성, 민트 데이터를 가져오는 중이에요.
`holders`	홀더 목록을 읽는 중이에요.
`trades`	스나이퍼를 찾기 위해 초기 거래를 읽는 중이에요.
`profiles`	상위 홀더의 자금 출처, 지갑 나이, 손익을 분석하는 중이에요.
`classify`	유형을 분류하고 클러스터를 구성하는 중이에요.
`dev`	생성자의 이전 발행 이력을 확인하는 중이에요.
`save`	Holder Score를 계산하고 저장하는 중이에요.
`done`	완료됐어요.
`error`	실패했어요.

홀더 유형#

`SMART_MONEY`	최근 30일 동안 수익을 냈고 승률이 높은 트레이더예요.
`REGULAR`	특이 사항이 없는 지갑이에요.
`DEV`	토큰 생성자예요.
`DEV_BUNDLE`	생성자와 함께 매수했거나 생성자에게서 자금을 받은 지갑이에요.
`SNIPER`	거래 시작 직후 처음 몇 블록 안에 매수한 지갑이에요.
`FRESH`	아주 최근에 만들어진 지갑이에요.
`POOL`	유동성 풀, 볼트 또는 본딩 커브예요.
`CEX`	중앙화 거래소 지갑이에요.
`BURN`	소각 주소예요.

홀더 플래그#

`smart`	스마트 머니 지갑이에요.
`sniper`	처음 몇 블록 안에 매수했어요.
`fresh`	새로 만들어진 지갑이에요.
`cluster`	클러스터에 속한 지갑이에요.
`funded_by_dev`	토큰 생성자에게서 자금을 받았어요.

Holder Score는 100점에서 시작해요. 위험 요소마다 가중치를 한도로 점수를 깎고, 스마트 머니는 보너스 점수를 더해요. 홀더 비중은 유통 공급량(풀과 소각 주소 밖의 물량)을 기준으로 측정하므로, 본딩 커브가 물량 대부분을 들고 있어도 소수의 지갑이 매수된 물량을 독차지한 사실을 가릴 수 없어요. 치명적인 요소는 점수 상한도 정해요. 발행한 토큰 대부분을 러그풀한 개발자, 해제되지 않은 민트 또는 동결 권한, 고갈된 유동성, 90% 이상의 폭락, 죽은 토큰 수준의 시가총액, 거의 없는 홀더가 여기에 해당해요. 위험 등급은 70점 이상이면 low, 40점 이상이면 medium, 그 미만이면 high예요. breakdown 배열에는 모든 요소가 점수, 측정값과 함께 나열돼요(total은 분모, cap은 치명적인 요소가 정한 상한이에요). mainReason 값은 상한으로 인한 감점을 포함해 가장 많은 점수를 깎은 요소예요. scoreVersion 값은 리포트 채점에 사용된 모델 버전이에요.

`top10`	유통 공급량 중 상위 홀더 10명의 비중.
`topHolder`	유통 공급량 중 최대 홀더의 비중.
`devBundle`	유통 공급량 중 생성자와 번들 지갑의 비중.
`snipers`	유통 공급량 중 스나이퍼의 비중.
`clusters`	유통 공급량 중 클러스터의 비중.
`fresh`	유통 공급량 중 신규 지갑의 비중.
`holders`	홀더가 너무 적어요. 3명 이하이면 점수 상한이 30이에요.
`authorities`	해제되지 않은 민트 또는 동결 권한. 하나만 남아 있으면 점수 상한이 45, 둘 다 남아 있으면 35예요.
`devRugs`	생성자가 발행한 토큰 중 죽은 토큰(value는 그 수, total은 전체 발행 수). 상습 러그풀 개발자이면 점수 상한이 35 또는 15예요.
`liquidity`	$5K 미만의 풀 유동성. $1K 미만이면 점수 상한이 20이에요.
`marketCap`	$1K 미만의 시가총액. 죽은 토큰으로 보고 점수 상한을 15로 정해요.
`priceCrash`	6시간 또는 24시간 동안의 가격 하락. 90% 이상 하락하면 점수 상한이 25예요.
`smartMoneyBonus`	홀더 중 스마트 머니가 있을 때 주는 보너스.

위험 등급#

`low`	점수 70~100: 홀더 구성에 큰 위험 신호가 없어요.
`medium`	점수 40~69: 집중도, 스나이퍼, 클러스터 등 살펴볼 부분이 있어요.
`high`	점수 0~39: 내부자나 조직적으로 움직이는 지갑이 장악하고 있거나, 치명적인 요소 때문에 점수 상한이 걸려 있어요.

locked 목록의 플랜 기능#