██╗ ██╗██╗ ██╗██████╗ ███████╗██████╗
██║ ██║╚██╗ ██╔╝██╔══██╗██╔════╝██╔══██╗
███████║ ╚████╔╝ ██████╔╝█████╗ ██████╔╝
██╔══██║ ╚██╔╝ ██╔═══╝ ██╔══╝ ██╔══██╗
██║ ██║ ██║ ██║ ███████╗██║ ██║
╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝
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
pipisn't recognized on Windows, trypy -m pip install hyper-sentinel
Launch
sentinel
Windows: Same command —
sentinel— works after pip install. If it's not found, trypy -m sentinel.clior 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/boosted tokens, on-chain analytics (free, no key) |
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
1 maintainer
Metadata
1 maintainer
Release files for hyper-sentinel 0.9.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hyper_sentinel-0.9.7.tar.gz | 163.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hyper_sentinel-0.9.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 343.0 kB
Release files / hyper_sentinel-0.9.7.tar.gz
| Download URL | hyper_sentinel-0.9.7.tar.gz |
|---|---|
| Size | 163.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b3ff3c7e93953a5659424b19747b82c62d73f2f3d3470cecf16b51c02d3b5e7d
|
|
BLAKE2b-256 checksum How to use checksums |
cdc8dadfa3c9f1e4d21ea7067029cf05466b669db27dd8ca92cb59e828960743
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.0
|
Release files / hyper_sentinel-0.9.7-py3-none-any.whl
| Download URL | hyper_sentinel-0.9.7-py3-none-any.whl |
|---|---|
| Size | 179.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
04d101216357ba240d89f6861030533b199ad690a10b26d61b965133d49eb223
|
|
BLAKE2b-256 checksum How to use checksums |
bd421c58464032e8787b1b2a8ec489bfe80a38fe6a59e2c8e4e6ff1f36c4a0c2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.0
|
