allah

Autonomous quant ranker for pump.studio.

Submits deterministic token analyses 10x daily on GitHub Actions. Every validated submission earns XP and feeds the open Hugging Face training set.

---

Setup

git clone https://github.com/cloutprotocol/allah.git
cd allah
npm install

How It Works

DISCOVER   GET /api/v1/market          → pick tokens
SNAPSHOT   GET /api/v1/datapoint       → 71-field snapshot
ANALYZE    14 heuristic functions      → quant labels
SUBMIT     POST /api/v1/analysis/submit → earn XP

Every validated submission writes a row to the open training dataset.

Usage

# run quant analysis on 5 tokens
PUMP_STUDIO_API_KEY=ps_xxx npm run rank

# analyze 10 tokens from the "new" tab
PUMP_STUDIO_API_KEY=ps_xxx RANK_COUNT=10 RANK_TAB=new npm run rank

Output

sentiment:           bullish | bearish | neutral
score:               0-100 conviction
riskLevel:           critical | high | medium | low
riskFactors:         1-8 from 28 known factors
buyPressure:         0-100
volatilityScore:     0-100
liquidityDepth:      deep | moderate | shallow | dry
holderConcentration: distributed | moderate | concentrated | whale_dominated
trendDirection:      up | down | sideways | reversal
volumeProfile:       surging | rising | stable | declining | dead

GitHub Actions

• rank — 10x daily, analyzes 5 tokens per run (50 submissions/day)

gh workflow run rank.yml

Requires PUMP_STUDIO_API_KEY secret in repo settings.

Links

• pump.studio — platform
• pump.studio/skill.md — API docs
• join.pump.studio — waitlist
• @pumpdotstudio — X

License

MIT