{"name": "Market Oracle Council - Intelligence API", "operator": "SCAFA INVESTMENTS LLC (info@scafa-investments.com)", "base_url": "https://api.egons.io", "auth": {"how": "send your key in the 'X-API-Key' header (or '?key=' query param)", "key_format": "moc_...", "rate_limit": "per-key requests/minute; HTTP 401 on unknown key or off-scope endpoint, message on rate-limit", "get_a_key": "contact info@scafa-investments.com"}, "endpoints": [{"path": "/api/docs", "params": {}, "auth": false, "what": "This document. Machine-readable API self-description."}, {"path": "/api/graphnet", "params": {}, "auth": true, "what": "The full knowledge graph: nodes (assets, actors, sectors, canonical events, world-compass scenarios, discovery names, research theses) and typed edges (threads). Node fields include sig_count (signal activity) and has_chart."}, {"path": "/api/graphnode", "params": {"id": "node id from /api/graphnet"}, "auth": true, "what": "Dossier for one node: live price chart points, latest posts/news, forecasts with outcomes, paper-bot trades, world-compass roles, council verdicts, fundamentals, connected threads."}, {"path": "/api/digest", "params": {}, "auth": true, "what": "Curated daily digest: top signals, movers, canonical-event candidates."}, {"path": "/api/knowledge", "params": {}, "auth": true, "what": "Aggregated knowledge layer (the 'brain'): entities with learned relevance."}, {"path": "/api/weltkompass", "params": {}, "auth": true, "what": "World-compass scenarios: macro/geopolitical scenario tree with affected companies, winners, losers, safe havens."}, {"path": "/api/canonik", "params": {}, "auth": true, "what": "Canonical-event ranking: which current events the council grades as structurally important (early-warning layer), with p_canonical scores."}, {"path": "/api/alliances", "params": {}, "auth": true, "what": "Actor-alliance graph: which actors move together, learned from signals."}, {"path": "/api/industrymap", "params": {}, "auth": true, "what": "Industry map: sectors, their assets and current signal pressure."}, {"path": "/api/fundamentals", "params": {"ticker": "US ticker, e.g. NVDA (alias: symbol)", "xbrl": "1 = include SEC-XBRL brief", "peers": "1 = include SIC peer table"}, "auth": true, "what": "Point-in-time fundamentals from SEC XBRL: TTM revenue/income, YoY growth, margins, EPS, plus optional peer comparison."}, {"path": "/api/trades", "params": {"limit": "max orders, default 100, cap 500"}, "auth": true, "what": "Paper-trading order log of the internal research bots (BUY/SELL, price, size, reason). Paper only - no real money, no execution service."}, {"path": "/api/track", "params": {}, "auth": true, "what": "Honest aggregate track record of all forward predictions: hit-rate, Brier score, confidence-bucket calibration and discrimination (high- vs low-confidence), split by horizon (short <7d vs canonical 14d) plus council-verdict record. Forward-only, no backtest; control-group calls are reported separately."}, {"path": "/api/regime", "params": {}, "auth": true, "what": "Current market-regime classification (vol/trend state) used by the risk layer."}, {"path": "/api/risk", "params": {}, "auth": true, "what": "Portfolio risk snapshot of the paper books: correlated VaR/CVaR, stress scenarios, kill-switch state."}], "notes": ["All endpoints are read-only GET and return JSON.", "Start with /api/graphnet, pick a node id, then /api/graphnode?id=... for the full dossier.", "Timestamps are local ISO-8601."], "disclaimer": "All data is informational market intelligence provided by SCAFA INVESTMENTS LLC. It is NOT investment advice, NOT a recommendation to buy or sell any security, and carries no warranty of accuracy or completeness. You act at your own risk."}