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.
ParamTypeDescription
min_confidencefloatMinimum confidence (0-100)
min_rrfloatRisk/Reward minimal
hoursintLookback window (default 72)
{"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, ...}}]}
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 → 429 QUOTA_EXCEEDED.
ParamTypeDescription
tickerstringRequired. Ticker or name (resolved)
modestringintraday | swing | position | auto
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 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:
EventTrigger
analysis.completedYour scan finished (full signal payload)
hot_value.triggeredTactical radar level hit
🩺 Status
GET/statuspublic
Health check + live endpoint list. No auth.