{"name": "Market Oracle Council - Intelligence API", "operator": "SCAFA INVESTMENTS LLC (info@scafa-investments.com)", "base_url": "https://api.marketsignalapi.com", "auth": {"how": "send your key in the 'X-API-Key' header - never in the URL (query params end up in proxy logs)", "key_format": "moc_...", "errors": {"401": "missing/unknown/revoked key", "403": "endpoint not in your scope", "429": "rate limit exceeded - honor the Retry-After header (seconds)"}, "rate_limit": "per-key requests/minute (default 60)", "get_a_key": "private beta - join the waitlist at https://marketsignalapi.com/pricing or contact info@scafa-investments.com; public launch follows our first canonical-maturity milestone"}, "pricing": {"model": "three cumulative tiers (higher includes lower)", "tiers": [{"tier": "free", "label": "Free", "price": "free", "rate_per_min": 10}, {"tier": "signal", "label": "Signal", "price": "USD 19 / month", "rate_per_min": 60}, {"tier": "intelligence", "label": "Intelligence", "price": "USD 99 / month", "rate_per_min": 240}], "legal": "https://marketsignalapi.com/impressum", "status": "private beta - not yet for sale", "waitlist": "https://marketsignalapi.com/pricing"}, "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/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/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, plus a parallel directional section (excluded-counters, signed ret_pct)."}, {"path": "/api/govawards", "params": {}, "auth": true, "what": "Dated US federal contract awards (source: USAspending.gov) resolved to public tickers: who receives government money, when, how much, which agency. Intelligence/monitoring, NOT a trading signal or price edge."}, {"path": "/api/facts", "params": {"type": "filter by event_type (whale_transfer|regulation|ma_deal|macro_policy|earnings|partnership|upgrade|hack_exploit|listing|sanction|etf_flow)", "subject": "filter by resolved ticker/coin symbol, e.g. NVDA or BTC", "limit": "max facts to return (default 100)"}, "auth": true, "what": "Typed, entity-resolved, deduplicated facts distilled from the raw text stream (financial news + tracked-actor posts). Each fact carries an event_type, resolved subject ticker(s), a USD magnitude where present, a direction hint, and a source URL. Generic headlines are dropped at the source. This is the ETL an agent would otherwise build itself - structured, queryable, ready to consume. Rule-derived types; direction_hint is a hint, NOT a graded call."}, {"path": "/api/resolve", "params": {"name": "raw company/coin name, handle or cashtag to canonicalize, e.g. 'Nvidia', '@nvidia' or '$NVDA'. Omit to list canonical coverage."}, "auth": true, "what": "One canonical identity per company/coin: resolves a raw name, @handle or $cashtag to a single ticker (NVDA/Nvidia/@nvidia/$NVDA -> NVDA), so an agent can deduplicate entities across the feed. Precision over recall - returns null rather than a wrong merge."}, {"path": "/api/narrative", "params": {}, "auth": true, "what": "Research-narrative momentum from arXiv: preprint rate per strategic theme, recent (30d) vs baseline (180d), with a rising-flag. Early indicator of accelerating research themes before consensus. Theme radar, NOT a ticker signal or price edge."}, {"path": "/api/dossier", "params": {}, "auth": true, "what": "The product pack: honest forward track record (hit-rate, Brier, control-group calibration) PLUS dated, source-traceable evidence grouped per ticker (who received federal money/when) PLUS an explicit 'what this is / is NOT' framing (intelligence & transparency, NOT a claimed price edge; global FDR disclosed). One call, honest by design."}, {"path": "/api/brainfork", "params": {}, "auth": true, "what": "Read-only view of the isolated brain_fork experiment (Phase 1 dataset): a point-in-time feature/target table (per graded forward-call, which signal types preceded it vs. hit/miss). Display only - NOT wired into any live decision; disclosed as an experiment, not a signal."}, {"path": "/api/scope", "params": {}, "auth": true, "what": "The full breadth in ONE call: how many datapoints, live sources, tracked market actors, intelligence rails, knowledge-graph theses and dated forward-calls the system carries, with per-category breakdown and freshness. Machine-readable scale overview for agents."}, {"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."}