██╗ ██╗██╗ ██╗██████╗ ███████╗██████╗
██║ ██║╚██╗ ██╔╝██╔══██╗██╔════╝██╔══██╗
███████║ ╚████╔╝ ██████╔╝█████╗ ██████╔╝
██╔══██║ ╚██╔╝ ██╔═══╝ ██╔══╝ ██╔══██╗
██║ ██║ ██║ ██║ ███████╗██║ ██║
╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝
Hyper-Sentinel
AI trading terminal with 75 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 75 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
Metadata
Release files for hyper-sentinel 0.9.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hyper_sentinel-0.9.11.tar.gz | 167.1 kB | Without provenance | Details for hyper_sentinel-0.9.11.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hyper_sentinel-0.9.11-py3-none-any.whl | Python 3 | none | any | Details for hyper_sentinel-0.9.11-py3-none-any.whl |
Total release size: 348.4 kB
Release files / hyper_sentinel-0.9.11.tar.gz
| Download URL | hyper_sentinel-0.9.11.tar.gz |
|---|---|
| Size | 167.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
029dd78dbc5e7b14c81c6ba8a1f933e33a2e3ecd7a2dc69cccf2d5aae31fe4fb
|
|
BLAKE2b-256 checksum How to use checksums |
344b6ea31475785c5ef15d08be45e710b177f01d7df60cb84e32d28d07369aff
|
| 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.11-py3-none-any.whl
| Download URL | hyper_sentinel-0.9.11-py3-none-any.whl |
|---|---|
| Size | 181.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
30b5dbe3b1ceb99c7e93a28302c44c15881fbd65e8b7f9703958fc894cdefe18
|
|
BLAKE2b-256 checksum How to use checksums |
726b0c6ffc2c8df66bfcea16c758a6dd781e7fb4bf799cd6a7e8d8942b3d9831
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.0
|
Security for hyper-sentinel 0.9.11
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.