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

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.4.tar.gz (136.2 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.4-py3-none-any.whl (153.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: hyper_sentinel-0.7.4.tar.gz
  • Upload date:
  • Size: 136.2 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.4.tar.gz
Algorithm Hash digest
SHA256 33362a9b9a3fde826b65891a164d5c59d36ddc9e1c640860fde1532005b9b66e
MD5 4c48eb6d0b788d7efaea4fbaca5d9f19
BLAKE2b-256 6d74412be7a6618c4d40db2cf6b0c7e7690d30d090c3b9b3cc4179ab2f027cf2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: hyper_sentinel-0.7.4-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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 21135b1994ab8818a6c02a0bd71afe89d25f731624a0ba73c7de2cd9b92e317b
MD5 4d0a259082785a0a9837cee1583de497
BLAKE2b-256 44f5dafff17a5c3a043a8cf9d2a971ffa2b0585dba166d0b8f7c9436abb57631

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