Hyper-Sentinel SDK

Installation

Requires Python 3.10+. Works on Mac, Windows, and Linux.

# pip (Mac / Windows PowerShell / Linux)
pip install hyper-sentinel

# Launch the interactive AI terminal
sentinel

Quick Start

# Install and launch — paste your AI key when prompted
$ pip install hyper-sentinel
$ sentinel

# The agent auto-detects your provider and you're in
Sentinel v0.9.5 · 69 tools · Free · 0/10 prompts/wk · Online

# Ask anything in natural language:
> What's BTC at?
BTC $84,219 (+1.8%) | Vol $31.2B | MCap $1.67T

> Show my Hyperliquid positions
| Coin | Size  | Entry    | PnL      | Leverage |
|------|-------|----------|----------|----------|
| BTC  | 0.7   | $70,711  | +$752    | 33x      |

> What's the Sharpe ratio on ETH?
Sharpe: 1.42 | Sortino: 1.87 | Max Drawdown: -18%

> Get GDP, unemployment, and fed rate
[calls get_fred_series x3 — real FRED data]

> Options data on AAPL for Jan 2028
[calls get_options_expirations → get_options_chain → LEAPS with Greeks]

Authentication — Web4

No email. No password. Your AI provider key is your identity.

# Just launch — paste your AI key when prompted
$ sentinel

# The SDK auto-detects your provider:
Paste your AI API key: sk-ant-xxx
✓ Detected: 🟣 Anthropic (Claude)
✓ Account created
✓ BTC = $84,219
✅ Setup Complete

Supported providers (8):

How Auth Works

When you paste your AI key, the SDK auto-creates a Sentinel account:

• Your AI key is hashed (SHA-256) → deterministic user ID
• Gateway generates a sk-sentinel-xxx platform key
• Saved to ~/.sentinel/config (0600 permissions)
• Your AI key is never stored on the server
• All future API calls use your Sentinel key transparently

Pricing

All 69 tools are available to everyone — no feature gates, no subscriptions, no tiers. Sign in with your AI key for free; you get 10 prompts per rolling 7-day window. Add a payment method to go unlimited, pay-as-you-go: a flat 20% platform fee on the equivalent LLM provider cost, plus a small on-chain builder fee on trades.

BYOK (Bring Your Own Key): your own LLM provider key is billed by your provider directly. Sentinel's revenue is the flat 20% platform fee for its 69 tools + agent, billed via Stripe metered billing (monthly, in arrears). No tiers, no subscriptions.

The Free Tier & 402 Gate

The gateway counts prompts (user turns — tool-loop continuations don't count) per rolling 7-day window. Once you exceed 10 prompts without a payment method, the next prompt returns HTTP 402:

# HTTP 402 — quota exceeded
{
  "error": "quota_exceeded",
  "message": "Free tier limit reached. Add a payment method to continue.",
  "prompts_used": 10,
  "prompt_limit": 10,
  "window_days": 7,
  "resets_at": "2026-06-24T14:03:00Z",
  "checkout_url": "https://checkout.stripe.com/..."
}

Open checkout_url to add a Stripe payment method. Once your method is active, the gate is lifted and usage is unlimited, pay-as-you-go. If a payment later fails the gateway returns 402 with error: "payment_failed" — update your card via the Customer Portal (GET /api/v1/billing/portal).

# Check your account, weekly prompt count & usage
$ sentinel status

# Free · 3/10 prompts/wk · resets in 5d

Billing & Usage

Billing lifecycle: sign in → 10 free prompts / 7 days → add payment → unlimited. Manage your card any time via the Stripe Customer Portal.

AI Chat (Multi-LLM)

Bring your own AI key and query any of 8 supported LLM providers through a single interface. The AI agent automatically calls the right tools based on your query.

# In the terminal, just ask:
> Analyze ETH/BTC ratio
> What are the top trending tokens?
> Long 0.01 BTC on Hyperliquid
> Run TA indicators on SOL
> What's the yield curve look like?

# The agent decides which tools to call, executes them,
# and synthesizes the results with your chosen LLM.

Crypto Market Data

Equities (yfinance)

Macro Economics (FRED)

Technical Analysis

Risk & ML Signals

Options & Greeks

News & Y2 Intelligence

Social Intelligence (Elfa AI)

X / Twitter Search

DexScreener

Hyperliquid (Perpetuals)

Crypto perps + TradFi (GOLD, SILVER, TSLA, SP500, and more). Type add hl inside the terminal to connect.

Aster DEX (Perpetuals)

Perp futures with leverage. Type add aster inside the terminal to connect.

Portfolio & Usage

System & Health