Skip to main content

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

Project description


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

Hyper-Sentinel

AI trading terminal with 54 tools.

One command. Every exchange. Every signal.


PyPI Python License Downloads

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

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 |
|------|-------|----------|----------|--------|----------|
| BTC  | 0.7   | $70,711  | +$752    | +50.1% | 33x      |
| SOL  | 220   | $82.55   | +$169    | +18.6% | 20x      |

> 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.

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 AI news recaps, sentiment scores
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 54 available tools
add Configure exchanges & data sources
add ai Swap your LLM provider
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

Exchange keys are encrypted client-side with AES-256-GCM before leaving your machine.


Links

License

AGPL-3.0 — 2026 Sentinel Labs LLC


Soli Deo Gloria

Project details


Release history Release notifications | RSS feed

This version

0.7.3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hyper_sentinel-0.7.3.tar.gz (136.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hyper_sentinel-0.7.3-py3-none-any.whl (153.0 kB view details)

Uploaded Python 3

File details

Details for the file hyper_sentinel-0.7.3.tar.gz.

File metadata

  • Download URL: hyper_sentinel-0.7.3.tar.gz
  • Upload date:
  • Size: 136.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.0

File hashes

Hashes for hyper_sentinel-0.7.3.tar.gz
Algorithm Hash digest
SHA256 dcc029de14b8004374d0c763176fe070485911571e16d273e142324e2a93c391
MD5 61abd311192d4dd501600aa0a7fa6b8f
BLAKE2b-256 7f75f14cd2ab4416e990305ecc1c94df1fe182b4e8109e72fd3a384357d8dc0f

See more details on using hashes here.

File details

Details for the file hyper_sentinel-0.7.3-py3-none-any.whl.

File metadata

  • Download URL: hyper_sentinel-0.7.3-py3-none-any.whl
  • Upload date:
  • Size: 153.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.0

File hashes

Hashes for hyper_sentinel-0.7.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7a0db00c135985d69d4a89a587bb37d8de778475491ea6220e28bcc9459d49ba
MD5 1610444e00449655f8c124a3828552ad
BLAKE2b-256 8709c3c05f7755b025b45add38a51cba9e6e995beefc5ce140ca65d342f2c75a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page