Check DeFi Risk from Your Terminal

The Hindenrank CLI puts protocol risk grades, vault screening, and portfolio analysis one command away.

1 Install

Install globally or use npx for one-off commands.

npm
npm install -g hindenrank
or use npx
npx hindenrank risk aave-v3
✓The CLI works without an API key (500 requests/day). Run hr auth login to save your key for higher limits.

2 Check a Protocol

Terminal
$ hr risk aave-v3

┌──────────────────────────────────────────────┐
│  Aave V3                                     │
│  Lending · ethereum                          │
├──────────────────────────────────────────────┤
│  Risk:  A- (14/100)                          │
│  Value: B+ (68/100)                          │
│  TVL:   $12.5B                               │
├──────────────────────────────────────────────┤
│  Top Risks:                                  │
│    · Oracle dependency on Chainlink          │
│    · Governance concentration                │
│  Verdict: Well-established lending protocol  │
│  with strong track record and battle-tested  │
│  smart contracts.                            │
└──────────────────────────────────────────────┘

3 Search Protocols

Don't know the exact slug? Search by name.

Terminal
$ hr search uniswap

Found 3 protocol(s) matching "uniswap":
  A   Uniswap V3 (uniswap-v3)     TVL: $4.2B
  A-  Uniswap V2 (uniswap-v2)     TVL: $1.8B
  B+  Uniswap V4 (uniswap-v4)     TVL: $320M

4 Compare Protocols

Side-by-side comparison of up to 5 protocols.

Terminal
$ hr compare aave-v3 compound-v3 morpho-blue

Protocol Comparison
═══════════════════

Aave V3 ✦ SAFEST
  Risk: A- (14/100) | TVL: $12.5B
  Key risks: oracle dependency, governance concentration

Compound V3
  Risk: B+ (22/100) | TVL: $2.1B
  Key risks: oracle dependency, liquidation cascades

Morpho Blue ⚠ RISKIEST
  Risk: B (28/100) | TVL: $890M
  Key risks: novel vault architecture, oracle dependency

Summary:
  Safest: Aave V3
  Riskiest: Morpho Blue
  Best Value: Morpho Blue

5 Screen Vaults

Filter 4,000+ vaults by source, chain, and risk grade.

Terminal
$ hr vaults --source hyperliquid --max-grade B --limit 5

Grade │ Vault              │ APY     │ TVL
──────┼────────────────────┼─────────┼────────
A-    │ HYPE Maxi          │ 12.50%  │ $45.2M
A     │ ETH Delta Neutral  │  8.20%  │ $12.1M
B+    │ BTC Basis          │ 15.30%  │  $8.5M
B     │ SOL Momentum       │ 22.10%  │  $5.2M
B     │ ARB Market Making  │ 11.40%  │  $3.8M

6 JSON Output and Scripting

Add --json to any command for machine-readable output. Pipe to jq, use in CI/CD, or feed to other tools.

Terminal
$ hr risk aave-v3 --json | jq '.data.grade'
"A-"
Bash script
# Alert if any watched protocol drops below B
for slug in aave-v3 lido compound-v3; do
  grade=$(hr risk "$slug" --json | jq -r '.data.grade')
  score=$(hr risk "$slug" --json | jq -r '.data.rawScore')
  if [ "$score" -gt 35 ]; then
    echo "⚠ $slug is now $grade ($score/100)"
  fi
done

7 Configure Your API Key

Save your API key once and all commands use it automatically.

Terminal
$ hr auth login
Enter API key: hrk_live_••••••••
✓ Key saved to ~/.config/hindenrank/config.json
✓ Tier: Pro (50,000 requests/day)

Next steps