AEGIS API v1
Programmatic access to AEGIS signals, macro context, your personalized feed and AI scans.
🔑 Authentication
All endpoints (except
/status) require your API key in the X-Api-Key header. Find your key in Dashboard → My account.
curl -H "X-Api-Key: aegis_xxxxxxxx" https://aegis-ami.xyz/api/v1/signals/active
Base URL: https://aegis-ami.xyz/api/v1 · Responses: JSON · Errors: 401 missing key, 403 invalid key, 429 quota.
📈 Signals
GET/signals/activeX-Api-Key
Active signals (non-invalidated), most recent first.
{"count": 4, "signals": [{"ticker": "BTC-USD", "direction": "HAUSSIER",
"confidence_score": 65.0, "entry_price": 61240.0, "stop_price": 59000.0,
"target_3m": 80000.0, "risk_reward": 2.5, "entry_trigger": "...",
"invalidation": "...", "macro_context": {"ras_score": 48, ...}}]}
| Param | Type | Description |
|---|---|---|
min_confidence | float | Minimum confidence (0-100) |
min_rr | float | Risk/Reward minimal |
hours | int | Lookback window (default 72) |
GET/signals/ticker/<ticker>X-Api-Key
Latest signal for one asset (e.g.
/signals/ticker/BTC-USD). 404 if none.GET/signals/watchlistX-Api-Key
Latest signals on your watchlist assets. Param
hours (default 168).✨ Personalized feed
GET/feedX-Api-Key
Your "For you" feed: latest analysis per asset you care about (watchlist ∪ scanned tickers) + your own analyses, freshness-sorted. Param
limit (1-50, default 20).
{"count": 8, "feed": [{"ticker": "CL=F", "source": "aegis",
"direction": "BAISSIER", "confidence_score": 55.0,
"in_watchlist": false, "updated_since_scan": true,
"title": "...", "url": "/asset/CL=F", "date": "2026-06-09"}]}
updated_since_scan: AEGIS re-analyzed an asset after your last scan. source: me | aegis.
⚡ AI Scan
GETPOST/scanX-Api-Key
Launch a full AI analysis on an asset (async). FREE plan: 1 scan/day →
curl -X POST -H "X-Api-Key: ..." \
"https://aegis-ami.xyz/api/v1/scan?ticker=NVDA&mode=swing"
→ {"status": "processing", "task_id": "…", "resolved_ticker": "NVDA"}
Poll the result via
429 QUOTA_EXCEEDED.
| Param | Type | Description |
|---|---|---|
ticker | string | Required. Ticker or name (resolved) |
mode | string | intraday | swing | position | auto |
GET /api/task_status/<task_id>, then fetch the signal via /signals/ticker/NVDA.
🌍 Macro context
GET/macro/contextX-Api-Key
Latest macro risk scoring: overall + geo / energy / monetary / credit, trends and key events.
🔔 Notification preferences
GETPOST/prefsX-Api-Key
Read / update your push notification preferences (partial updates supported).
{"prefs": {"watchlist": true, "signals": true, "macro": true,
"radar": true, "morning_brief": false,
"min_confidence": 0, "quiet_hours": [22, 7], "daily_cap": 0}}
quiet_hours: [start, end[ server hours, no push inside. daily_cap: max push/day (0 = unlimited). min_confidence: skip signal pushes below this score.
🪝 Webhooks
Set a
webhook_url on your account to receive HTTP POSTs:
| Event | Trigger |
|---|---|
analysis.completed | Your scan finished (full signal payload) |
hot_value.triggered | Tactical radar level hit |
🩺 Status
GET/statuspublic
Health check + live endpoint list. No auth.