hyper-sentinel 0.3.14

Python SDK + AI Agent for Sentinel — 80+ crypto trading, AI, and market intelligence tools with interactive chat. Free access, usage-based fees.

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

Hyper-Sentinel

Quantitative AI Agent — Crypto, TradFi, Equities & Macro

12 data sources · 49 tools · Multi-agent swarm · Sub-second queries

Website · Docs · PyPI

---

Quickstart

pip install hyper-sentinel
sentinel

Paste your LLM key. No email, no account, no cloud. You're in.

---

What It Does

Sentinel is an autonomous AI agent that executes financial research and trades through natural language. Fast queries resolve instantly. Everything else routes through your chosen LLM with tool calling.

  ⚡ You → price of btc and eth

  ╭───────────────────────────── 🛡️ Sentinel ──╮
  │                                              │
  │  Bitcoin (BTC): $66,839.00                   │
  │    24h: -0.42%  ·  7d: +1.8%                │
  │                                              │
  │  Ethereum (ETH): $1,812.40                   │
  │    24h: +0.21%  ·  7d: -2.1%                │
  │                                              │
  ╰────────────────────── ⚡ instant · 0 LLM ───╯

Query	Speed	How
price of btc / top 10 crypto	< 1s	Fast Path — regex match, direct API, zero LLM
analyze BTC and show AAPL recs	3–8s	LLM agent calls tools, formats response
run quant analysis on TSLA	10–20s	Deep quant — valuation, technicals, risk, targets

---

Boot Sequence

When you launch sentinel, the system runs an animated boot sequence — authenticating your LLM, loading credentials, connecting exchanges, and deploying the MarketAgent:

  ✓ 🤖 Authenticating LLM — CLAUDE → claude-sonnet-4-20250514
  ✓ 🔑 Loading credentials — ~/.sentinel/config
   ✓ 🔧 Initializing tool registry — 49 tools
   ✓ 📡 Bridging environment — 12 services
  ✓ 📊 Connecting data sources — CoinGecko · YFinance · DexScreener
  ✓ ⚡ Connecting exchanges — Hyperliquid · Aster · Polymarket
  ✓ 🛡️ Deploying MarketAgent — sentinel.market.data

---

Data Sources

All sources execute locally via built-in scrapers. No gateway dependency.

Source	What You Get	Setup
🪙 CoinGecko	10,000+ coins · prices · market data · trending	None — always on
📈 YFinance	Stocks · ETFs · options · analyst recs · financials	None — always on
📊 DexScreener	DEX pairs · trending tokens · new listings · search	None — always on
📉 Technical Analysis	SMA · EMA · RSI · MACD · Bollinger Bands · signals	None — always on
⚡ Hyperliquid	Perps · positions · orders · TradFi (Gold, Oil, Stocks)	add hl
🌟 Aster DEX	Futures · positions · klines · leverage · orderbook	add aster
🎲 Polymarket	Prediction markets · positions · buy/sell · odds	add polymarket
🏛️ FRED	GDP · CPI · rates · 800K+ economic series	add fred
📰 Y2 Intelligence	News sentiment · intelligence reports · recaps	add y2
🔮 Elfa AI	Trending tokens · social mentions · sentiment	add elfa
🐦 X / Twitter	Tweet search · accounts · trends	add x

3 sources work instantly. The rest activate the moment you add a key — no restart required.

---

Multi-Agent Swarm

Three specialized agents coordinate through the Upsonic framework:

Agent	Role	Scope
📊 Analyst	Market Research	Prices, technicals, macro data, sentiment
⚠️ RiskManager	Portfolio Risk	Position sizing, leverage checks, trade approval
💰 Trader	Execution	Hyperliquid, Aster DEX, Polymarket orders

pip install 'hyper-sentinel[swarm]'

  ⚡ You → swarm

  🛡️  Sentinel Swarm — ONLINE

    📊 Analyst       ● ONLINE    sentinel.analyst
    ⚠️  RiskManager   ● ONLINE    sentinel.risk
    💰 Trader        ● ONLINE    sentinel.trader

   3 agents · Mode: COORDINATE · 49 tools

---

Python SDK

from sentinel import SentinelClient

client = SentinelClient()  # keys from ~/.sentinel/config

# Crypto
btc = client.get_crypto_price("bitcoin")
top = client.get_crypto_top_n(10)

# Equities — deep quant
analysis = client.run_stock_analysis("TSLA")

# Perpetual futures — Crypto (Hyperliquid)
positions = client.get_hl_positions()
client.place_hl_order(coin="ETH", side="buy", size=0.5)

# TradFi — Gold, Oil, Stocks, Indices (Hyperliquid xyz dex)
gold = client.get_hl_tradfi_price("GOLD")
client.place_hl_order(coin="TSLA", side="buy", size=1.0)

# Technical Analysis — any asset, any venue
ta = client.get_ta_indicators("BTC", interval="1h")
signal = client.get_ta_signal("GOLD", interval="4h")

# Prediction markets (Polymarket)
markets = client.get_polymarket_markets()

# Macro (FRED)
gdp = client.get_fred_series("GDP")

---

LLM Providers

Provider	Prefix	Link
Anthropic (Claude)	sk-ant-	console.anthropic.com
OpenAI (GPT)	sk-	platform.openai.com
Google (Gemini)	AIza	aistudio.google.com
xAI (Grok)	xai-	console.x.ai

---

Commands

# Terminal
sentinel                     # Launch agent (interactive chat)
sentinel ask "price of ETH"  # One-shot query
sentinel setup               # Onboarding wizard
sentinel status              # Infrastructure dashboard
sentinel tools               # List all tools

# Inside chat
add hl          Hyperliquid perps (crypto + TradFi)
add aster       Aster DEX futures
add polymarket  Prediction markets
swarm           Activate multi-agent mode
clear           Fresh dashboard + reset context
tools           List all 49 tools
help            Show all commands

---

Architecture

           sentinel / sentinel ask / SentinelClient
                         │
            ┌────────────┼────────────┐
            │            │            │
        Fast Path    12 Local      Upsonic
        (regex)      Scrapers      Swarm
            │            │            │
         < 1 sec     CoinGecko    3 Agents
         zero LLM    YFinance     Analyst
                     DexScreener  RiskManager
                     TA Engine    Trader
                     FRED · Y2      │
                     HL · Aster   coordinate
                     PM · TG      mode
                     Discord

---

Changelog

v0.3.14 — TradFi Integration + Technical Analysis

Soli Deo Gloria — Dedicated to the Glory of Jesus Christ, the Son of God.

• NEW: TradFi perp trading — GOLD, SILVER, OIL, TSLA, NVDA, SP500 + 50 more via Hyperliquid xyz dex
• NEW: TRADFI_ALIASES — say "GOLD" and the agent resolves xyz:GOLD automatically
• NEW: get_hl_tradfi_assets / get_hl_tradfi_price — discovery + live pricing
• NEW: Technical Analysis engine — SMA, EMA, RSI(14), MACD, Bollinger Bands
• NEW: get_ta_indicators / get_ta_signal / get_klines — TA tools for any asset
• NEW: DexScreener tools — search_dexscreener, get_dexscreener_trending, get_token_pairs, get_dexscreener_token
• NEW: Dual-dex initialization: perp_dexs=["", "xyz"] loads crypto + TradFi universes
• TOTAL: 49 tools · 12 scrapers · 3 trading venues

v0.3.10 — Boot Sequence + Polymarket Full Integration

• NEW: Animated boot sequence with staged spinner initialization
• NEW: 5 Polymarket tools exposed (positions, buy, sell, price, orderbook)
• NEW: sentinel (no args) launches chat directly

v0.3.8 — Aster Fix + Credential Sync

• FIX: Added tenacity to core dependencies (Aster scraper)
• VERIFIED: 7/7 integrations passing

v0.3.4 — Multi-Agent Swarm

• ADD: Upsonic multi-agent swarm (Analyst, RiskManager, Trader)

v0.3.3 — Quant Analysis Engine

• ADD: run_stock_analysis — deep quantitative analysis

---

Links

• hyper-sentinel.com — Website
• Documentation — Guides & API reference
• PyPI — Package
• GitHub — Source

License

AGPL-3.0 — © 2026 Sentinel Labs

---

_{Soli Deo Gloria — To the Glory of God alone.}