[REFERENCE]

SDK Reference

01

Installation

[terminal]
pip install ginko
02

Examples

from ginko import GinkoEngine, TokenSnapshot
import time

engine = GinkoEngine()

snapshots = [
    TokenSnapshot(
        token_ca="YourCA...",
        token_name="TOKEN",
        timestamp=time.time() - 86400,
        holder_count=450,
        holder_growth_24h=1.8,
        top10_concentration=0.28,
        lp_locked=True,
        lp_lock_days=180,
        volume_24h=18000,
        market_cap=120000,
    )
]

result = engine.analyze("YourCA...", "TOKEN", snapshots)

print(f"Bloom Index: {result.bloom_index}/100")
print(f"Phase: {result.bloom_phase.value}")
print(f"Action: {result.recommended_action}")
03

API Reference

GinkoEngine

Main analysis engine

analyze(token_ca, token_name, snapshots)AnalysisResult
set_model(model_name)None
enable_heuristic_mode()None

TokenSnapshot

Input data structure

token_castr
holder_countint
holder_growth_24hfloat
top10_concentrationfloat (0-1)
lp_lockedbool
volume_24hint

AnalysisResult

Analysis output

bloom_indexfloat (0-100)
bloom_phaseBloomPhase enum
bloom_probabilityfloat (0-100)
recommended_actionstr
estimated_bloom_daysfloat

BloomPhase

Phase enumeration

DORMANT0-19
ROOTING20-39
BUDDING40-59
EMERGING60-79
BLOOMING80-100