hyper-sentinel 0.9.1

AI trading terminal — Hyperliquid, Aster DEX, CoinGecko, Yahoo Finance, FRED, quant analysis

██╗  ██╗██╗   ██╗██████╗ ███████╗██████╗
██║  ██║╚██╗ ██╔╝██╔══██╗██╔════╝██╔══██╗
███████║ ╚████╔╝ ██████╔╝█████╗  ██████╔╝
██╔══██║  ╚██╔╝  ██╔═══╝ ██╔══╝  ██╔══██╗
██║  ██║   ██║   ██║     ███████╗██║  ██║
╚═╝  ╚═╝   ╚═╝   ╚═╝     ╚══════╝╚═╝  ╚═╝

Hyper-Sentinel

AI trading terminal with 69 tools. See all tools →

One terminal. Multi-LLM. Trade Hyperliquid & Aster — quant + market intel built in.

Website · API Reference · PyPI

---

Install

macOS / Linux

pip3 install hyper-sentinel

Windows (PowerShell)

pip install hyper-sentinel

If pip isn't recognized on Windows, try py -m pip install hyper-sentinel

Launch

sentinel

Windows: Same command — sentinel — works after pip install. If it's not found, try py -m sentinel.cli or add your Python Scripts folder to PATH.

Paste an API key from any supported provider:

Provider	Get a Key
Anthropic (Claude)	console.anthropic.com
OpenAI (GPT)	platform.openai.com
Google (Gemini)	aistudio.google.com — free tier available
xAI (Grok)	console.x.ai
DeepSeek	platform.deepseek.com
Zhipu AI (GLM)	open.bigmodel.cn
Minimax	platform.minimaxi.com
Moonshot (Kimi)	platform.moonshot.cn

Your AI key is exchanged for a Sentinel API key. Both saved locally:

• macOS / Linux: ~/.sentinel/
• Windows: C:\Users\<you>\.sentinel\

---

What You Can Do

Type what you want. The AI agent calls the right tools automatically.

> What's BTC at?
BTC $84,219 (+1.8%) | Vol $31.2B | MCap $1.67T

> Show my Hyperliquid positions
| Coin | Size  | Entry    | PnL      | ROE    | Leverage | Type   |
|------|-------|----------|----------|--------|----------|--------|
| BTC  | 0.7   | $70,711  | +$752    | +50.1% | 33x      | crypto |
| SOL  | 220   | $82.55   | +$169    | +18.6% | 20x      | crypto |
| GOLD | 2.0   | $2,641   | +$38     | +7.2%  | 10x      | tradfi |
| NVDA | 15    | $131.20  | +$94     | +12.0% | 5x       | tradfi |

> Get GDP, unemployment, and fed rate
[calls get_fred_series x3 — real economic data]

> Search X for Mario Nawfal on Israel
[calls search_x — returns latest tweets]

> What's the Sharpe ratio on BTC?
Sharpe: 1.42 | Sortino: 1.87 | Max Drawdown: -18%
→ Good risk-adjusted returns. Sharpe > 1 suggests solid performance.

> Is ETH trending or random right now?
ARIMA forecasts up | Volatility compressing | Non-stationary (trending)
→ Price is trending, not mean-reverting. GARCH vol is compressing.

> What do the ML models say about SOL?
Trend: up (R²=0.72) | Regime: trending_up | Top signal: RSI
→ ML models lean bullish. Next candle prediction: up (64% confidence)

> What's the put/call ratio on AAPL?
P/C Ratio: 0.73 | IV: 28% | Sentiment: mildly bullish
→ Put/call below 1 suggests bullish positioning. IV is moderate.

> Give me options data on LULU for Jan 2028
[calls get_options_expirations → discovers 2028-01-21]
[calls get_options_chain → LEAPS with Greeks]

LULU Options — Jan 2028 LEAPS (585 DTE) | $116.74

| Strike  | Bid/Ask       | Delta | IV    | OI    |
|---------|---------------|-------|-------|-------|
| 115 ITM | 33.65 / 35.45 | 0.69  | 58.8% | 302   |
| 120     | 31.30 / 32.75 | 0.66  | 57.5% | 402   |
| 130     | 28.35 / 29.55 | 0.62  | 57.7% | 1,782 |

→ Positioning leans mildly bullish (call OI > put OI, call IV skew).
  Breakeven on $130 call: ~$158 (+36%). Consider a call spread to cut IV cost.

Pricing

Free tier — no credit card required to start.

• 10 prompts per rolling 7-day window — always free, sign in with any LLM key.
• Unlimited prompts — add a payment method via Stripe. AI calls are billed at a flat 20% markup over raw provider cost, monthly in arrears. No subscriptions, no tiers.
• Trades carry a 0.01% on-chain builder fee, settled automatically with each order — on both Hyperliquid and Aster.

Bring your own LLM key; market data and quant tools are always free. When you hit the 10-prompt cap the CLI shows an amber panel with your Stripe Checkout link.

Data Sources (Always Available)

Source	What
CoinGecko	10,000+ crypto prices, market caps, search
Yahoo Finance	Stocks, ETFs, analyst recs, options chains
FRED	GDP, CPI, unemployment, Fed rate, VIX, yield curve
DexScreener	DEX pairs, trending tokens, on-chain analytics

Quantitative Analysis (Built-In)

Module	What
Risk Metrics	Sharpe, Sortino, Calmar, VaR (3 methods), CVaR, max drawdown
Time Series	ARIMA forecast, GARCH volatility, ADF stationarity test
ML Signals	Linear regression trend, K-Means regime, Random Forest importance, logistic prediction
Options	Put/call ratio, implied volatility, ATM options, sentiment (stocks/ETFs only)

Trading Venues (Connect Your Keys)

Venue	What
Hyperliquid	Perp futures — crypto + TradFi (GOLD, TSLA, SP500)
Aster DEX	Perp futures with leverage

Type add hl or add aster inside the terminal to connect.

Intelligence Feeds (Connect Your Keys)

Source	What
X / Twitter	Tweet search, sentiment
Y2 Intelligence	News sentiment (GloriaAI), AI recaps, intelligence reports, audio narrations, monitoring profiles, OSINT feeds
Elfa AI	Trending tokens, social mentions

Type add x, add y2, or add elfa inside the terminal to connect.

---

Commands

Command	What
status	Connection health + account info
tools	List all 69 available tools
model	Pick your AI model (Fable, Opus, Sonnet, GPT, Gemini, Grok…)
add	Configure exchanges & data sources
add ai	Switch LLM provider / change your AI key
help	Show all commands
quit	Exit
Anything else	Chat with the AI — it has all the tools

---

Security

Key	Purpose	Storage
API Key (sk-sentinel-xxx)	Authenticates API calls	Server (hashed)
Secret Key (sdg-vault-xxx)	Encrypts your config vault	Client only — never sent
AI Provider Key	Forwarded to LLM provider	Never stored on our servers

Your config vault is encrypted locally with Fernet (AES-128-CBC + HMAC-SHA256). Exchange keys never leave your machine in plaintext.

---

Links

• Website: hyper-sentinel.com
• API Reference: api.hyper-sentinel.com/docs
• PyPI: pypi.org/project/hyper-sentinel

License

AGPL-3.0 — 2026 Sentinel Labs LLC

---

_{Soli Deo Gloria}