SDK

from yoriichi import read
from yoriichi.models import DexToken

token = DexToken(
    token_mint="YoriXyz...pump",
    symbol="YORI",
    dex_volume_24h=800_000.0,
    dex_volume_7d_avg=400_000.0,
    liquidity_usd=500_000.0,
    unique_traders_24h=600,
    buy_sell_ratio=1.6,
    pool_count=6,
)

report = read(token)

print(report.phase)           # ASCENDANT
print(report.breathing_score) # 88.4
print(report.yoriichi_read)

from yoriichi import read_batch, strongest_dex

tokens = [token1, token2, token3]

# Read all tokens
reports = read_batch(tokens)

for report in reports:
    print(f"{report.symbol}: {report.phase} ({report.breathing_score})")

# Find strongest DEX signal
best = strongest_dex(tokens)
print(f"Strongest: {best.symbol} — {best.phase}")

# React dashboard updates every 4 seconds
# Dark orange/red DEX theme

cd dashboard
npm install
npm run dev

# Opens at localhost:3000
# Real-time signal updates
# Phase visualizations