Developer Reference

API Documentation

REST API with JSON request/response bodies. All endpoints require the x-noosphere-key header.

Quick Start

curl -X POST https://noosphereprime.space/api/v1/analyze \
  -H "Content-Type: application/json" \
  -H "x-noosphere-key: YOUR_API_KEY" \
  -d '{"query": "Analyze global systemic risk right now"}'

Get your API key from /account

analyst100 req/day
director1,000 req/day
sovereignUnlimited
POST/analyzeanalyst

Main SIGMA engine endpoint. Runs all 8 analytical layers and returns a comprehensive intelligence brief with regime detection, risk vectors, arbitrage windows, and executive summary.

Request Body

{
  "query": "Analyze Tesla's supply chain exposure to rare earth price shocks"
}

Response (excerpt)

{
  "sigmaScore": 74.2,
  "regime": "accumulation",
  "regimeProbabilities": {
    "stable": 0.18,
    "accumulation": 0.61,
    "critical": 0.15,
    "collapse": 0.06
  },
  "arbitrageWindowDays": 12,
  "riskVectors": [
    {
      "name": "Lithium price spike",
      "probability": 0.71,
      "magnitude": "HIGH",
      "timeframe": "30d"
    }
  ],
  "timeline": {
    "d30": "...",
    "d90": "...",
    "d180": "..."
  },
  "actions": [
    "Hedge lithium exposure via futures",
    "Monitor CATL inventory reports"
  ]
}

Full URL: https://noosphereprime.space/api/v1/analyze

POST/regimeanalyst

Returns current global macro regime classification with probability distribution across stable, accumulation, critical, and collapse states.

Request Body

{
  "query": "Current global macro regime"
}

Response (excerpt)

{
  "regime": "accumulation",
  "confidence": 0.73,
  "hurstExponent": 0.61
}

Full URL: https://noosphereprime.space/api/v1/regime

POST/pulseanalyst

Real-time market health check. Returns VIX, cross-asset correlations, volatility surface, and live signal intensity.

Request Body

{
  "query": "Global market pulse"
}

Response (excerpt)

{
  "vixLevel": 18.4,
  "correlationBreakdown": false,
  "signalIntensity": "moderate"
}

Full URL: https://noosphereprime.space/api/v1/pulse

POST/sentiment-advancedanalyst

Multi-source NLP sentiment analysis combining GDELT news, SEC filings, and social signals. Returns hedging frequency and linguistic divergence score.

Request Body

{
  "query": "Semiconductor sector sentiment"
}

Response (excerpt)

{
  "sentimentScore": 0.42,
  "hedgingFrequency": 0.31,
  "linguisticDivergenceScore": 1.8
}

Full URL: https://noosphereprime.space/api/v1/sentiment-advanced

POST/causalanalyst

Identifies causal chains between macro events and asset price movements. Returns directed acyclic graph of cause-effect relationships with confidence scores.

Request Body

{
  "query": "Fed rate hike impact on emerging markets"
}

Response (excerpt)

{
  "causalChains": [
    {
      "cause": "Fed rate +50bps",
      "effect": "EM capital outflow",
      "confidence": 0.82
    }
  ]
}

Full URL: https://noosphereprime.space/api/v1/causal

POST/contagionanalyst

Computes financial contagion risk using network percolation theory. Returns R0 financial reproduction number and systemic exposure map.

Request Body

{
  "query": "Contagion risk from Chinese real estate sector"
}

Response (excerpt)

{
  "R0financial": 1.34,
  "percolationExceeded": true,
  "communities": 4
}

Full URL: https://noosphereprime.space/api/v1/contagion

POST/portfolio-riskanalyst

Multi-dimensional portfolio risk assessment. Returns VaR, CVaR, correlation matrix fragility, and tail risk indicators.

Request Body

{
  "query": "60/40 portfolio under current regime"
}

Response (excerpt)

{
  "var95": -0.087,
  "cvar95": -0.142,
  "correlationFragility": 0.61
}

Full URL: https://noosphereprime.space/api/v1/portfolio-risk

POST/macro-regimeanalyst

Extended macro regime analysis with historical precedent matching, cycle position, and estimated transition timeline.

Request Body

{
  "query": "Where are we in the credit cycle?"
}

Response (excerpt)

{
  "cyclePhase": "late",
  "historicalPrecedent": "2007-Q2",
  "estimatedTransitionMonths": 8
}

Full URL: https://noosphereprime.space/api/v1/macro-regime

POST/valuationanalyst

Multi-model asset valuation combining DCF, comparable multiples, and regime-adjusted fair value. Returns over/undervaluation z-score.

Request Body

{
  "query": "S&P 500 valuation vs fair value"
}

Response (excerpt)

{
  "fairValueGap": -0.18,
  "zScore": -1.4,
  "model": "regime-adjusted-dcf"
}

Full URL: https://noosphereprime.space/api/v1/valuation

POST/screenanalyst

Screens markets for actionable signals matching specified criteria. Returns ranked list of opportunities with SIGMA scores.

Request Body

{
  "query": "Identify asymmetric opportunities in beaten-down sectors"
}

Response (excerpt)

{
  "signals": [
    {
      "asset": "Energy sector ETF",
      "sigmaScore": 68,
      "action": "accumulate",
      "confidence": 0.74
    }
  ]
}

Full URL: https://noosphereprime.space/api/v1/screen

POST/fraud-scoredirector

Beneish M-Score and Altman Z-Score analysis combined with EDGAR filing anomaly detection. Returns fraud probability and key flags.

Request Body

{
  "query": "Analyze Evergrande financial statements for anomalies"
}

Response (excerpt)

{
  "mScore": -1.78,
  "fraudProbability": 0.67,
  "flags": [
    "unusual receivables growth",
    "asset quality deterioration"
  ]
}

Full URL: https://noosphereprime.space/api/v1/fraud-score

POST/filing-alertsdirector

Real-time SEC EDGAR monitoring for significant filings. Detects insider transactions, 8-K material events, and 13D/13G ownership changes.

Request Body

{
  "query": "Recent unusual SEC filings in biotech sector"
}

Response (excerpt)

{
  "alerts": [
    {
      "type": "Form 4 cluster",
      "company": "XYZ Bio",
      "insiderBuys": 4,
      "totalValue": 2400000
    }
  ]
}

Full URL: https://noosphereprime.space/api/v1/filing-alerts

POST/shadow-stressdirector

Monitors non-bank financial intermediary stress indicators. Returns repo market strain, money market fund flows, and leverage unwinding risk.

Request Body

{
  "query": "Shadow banking stress indicators"
}

Response (excerpt)

{
  "repoStrainIndex": 0.42,
  "leverageUnwindRisk": "moderate",
  "mmfOutflows7d": -12000000000
}

Full URL: https://noosphereprime.space/api/v1/shadow-stress

POST/esg-deepdirector

Multi-source ESG scoring beyond standard ratings. Incorporates satellite data, supply chain mapping, and regulatory exposure.

Request Body

{
  "query": "ESG risk in fast fashion supply chains"
}

Response (excerpt)

{
  "esgScore": 28,
  "regulatoryExposure": "high",
  "supplyChainFlags": 3
}

Full URL: https://noosphereprime.space/api/v1/esg-deep

POST/earnings-intelligencedirector

Pre-earnings analysis combining options market implied moves, analyst revision momentum, and NLP sentiment on guidance language.

Request Body

{
  "query": "Nvidia Q4 earnings setup"
}

Response (excerpt)

{
  "impliedMove": 0.082,
  "revisionMomentum": 1.4,
  "guidanceSentiment": "cautiously optimistic"
}

Full URL: https://noosphereprime.space/api/v1/earnings-intelligence

POST/ma-intelligencedirector

Detects M&A probability signals using network topology, insider activity patterns, and corporate strategic positioning.

Request Body

{
  "query": "M&A targets in European telecom sector"
}

Response (excerpt)

{
  "targets": [
    {
      "company": "TeleCo AB",
      "maProbability": 0.63,
      "premiumEstimate": 0.28
    }
  ]
}

Full URL: https://noosphereprime.space/api/v1/ma-intelligence

POST/stress-testdirector

Monte Carlo scenario analysis for portfolio under custom shock scenarios. Returns full distribution of outcomes.

Request Body

{
  "query": "Portfolio stress test: +200bps rates + 20% USD appreciation"
}

Response (excerpt)

{
  "p10Loss": -0.23,
  "p50Loss": -0.11,
  "p90Loss": -0.04,
  "worstCase": -0.41
}

Full URL: https://noosphereprime.space/api/v1/stress-test

POST/counterfactualdirector

What-if scenario engine. Estimates the counterfactual impact of historical events or future hypothetical scenarios on asset prices.

Request Body

{
  "query": "What if SVB collapse had been allowed to spread to 5 more banks?"
}

Response (excerpt)

{
  "estimatedCreditContraction": -0.08,
  "bankingStressIndex": 0.76
}

Full URL: https://noosphereprime.space/api/v1/counterfactual

POST/alternative-datasovereign

Sovereign-tier only. Synthesizes alternative data sources: satellite imagery, credit card spend, mobility data, web traffic, and job posting trends.

Request Body

{
  "query": "Consumer spending recovery in Southern Europe"
}

Response (excerpt)

{
  "mobilityIndex": 1.12,
  "creditCardSpendMoM": 0.034,
  "jobPostingGrowth": 0.18
}

Full URL: https://noosphereprime.space/api/v1/alternative-data

POST/metabolicsovereign

Proprietary biological economy model. Measures economic 'metabolism' — the rate at which the economy processes capital, debt, and labor.

Request Body

{
  "query": "US economic metabolic rate"
}

Response (excerpt)

{
  "metabolicRate": 0.74,
  "biologicalAge": 82,
  "immuneResponseIndex": 0.61,
  "estimatedResetMonths": 14
}

Full URL: https://noosphereprime.space/api/v1/metabolic

POST/nexussovereign

Sovereign-tier only. Maps global systemic interdependencies across 180+ countries, 50+ industries, and 300+ financial institutions.

Request Body

{
  "query": "Map systemic risk nexus for global banking sector"
}

Response (excerpt)

{
  "nexusNodes": 847,
  "criticalPathways": 23,
  "singlePointsOfFailure": 4
}

Full URL: https://noosphereprime.space/api/v1/nexus

GET/healthanalyst

Returns API status, SIGMA engine version, and current data freshness for all integrated data sources.

Response (excerpt)

{
  "status": "operational",
  "sigmaVersion": "5.0",
  "dataFreshness": {
    "fred": "2min",
    "gdelt": "15min"
  }
}

Full URL: https://noosphereprime.space/api/v1/health

Rate Limits & Headers

x-noosphere-key — Required on all requests

x-ratelimit-limit — Your daily request limit

x-ratelimit-remaining — Requests remaining today

429 — Rate limit exceeded. Resets at 00:00 UTC daily.

401 — Invalid or inactive API key.

403 — Endpoint requires higher tier.