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

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.1.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.1-py3-none-any.whl (152.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: hyper_sentinel-0.7.1.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.1.tar.gz
Algorithm Hash digest
SHA256 9a17f535ca6f16a09e0479bade7af1e12c5072e1eee5d519983e1cb871838eeb
MD5 3b134c177d11d573664621f2c26f1059
BLAKE2b-256 1abc41120c9539bb1655d89bc3ba5b433912dc721ff9aa6d4fb2be2571ab0005

See more details on using hashes here.

File details

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

File metadata

  • Download URL: hyper_sentinel-0.7.1-py3-none-any.whl
  • Upload date:
  • Size: 152.9 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5c372cff944e0c7a4ce8d03a256d8a46709d484c6b9859d94769d182e958df70
MD5 b61b5d6b24ba40ea44a407a45e40a6f6
BLAKE2b-256 0772e73c3bf80be5c7d0497888eb3a0d972aa92893b8a1579072fe985cdc602b

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