tokenintel_health_matrix

io.github.BrunoPessoa22/fan-token-intel · Verify this server

Get health grades (A-F) for all tracked fan tokens. Each token is scored across trading volume, order-book liquidity, spread, holder distribution and price stability -- 5-pillar weighted: volume(25%) + liquidity(25%) + spread(20%) + holders(15%) + price_stability(15%). The grade is the token's percentile standing WITHIN the fan-token universe (A=top 10%, B=next 20%, C=middle 40%, D=next 20%, F=bottom 10%); health_score stays the absolute 0-100 pillar score. A pillar whose collector delivered no data is excluded and the remaining weights are renormalized (see missing_pillars), never scored as 0. Use this to quickly filter which tokens deserve attention relative to their peers. IMPORTANT for agents: cross-check 'coverage_summary' (detailed) or the per-token 'pillars' count (n_pillars, 2-5) — a token can hit 100/100 on only volume+price_stability when liquidity/spread/holders data is missing, so a high grade on thin coverage is NOT the same as full market depth. Detailed mode (default) includes the per-pillar sub-scores + coverage_summary; pass response_format='concise' to get just symbol/grade/score/change/pillars (~70% smaller).