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

analyst50 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 Noosphere 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

POST/kairosanalyst

Temporal arbitrage window calculator. Computes the optimal entry/exit window for any signal using the confidence decay function C(t)=e^(-λ·t^γ). Returns urgency, remaining days, and optimal position sizing multiplier.

Request Body

{
  "signalType": "SIGMA_SPIKE",
  "elapsedDays": 3,
  "sigmaScore": 72,
  "signalMagnitude": 0.85
}

Response (excerpt)

{
  "kairosScore": 78,
  "remainingDays": 8.3,
  "urgency": "HIGH",
  "optimalSizeMultiplier": 1.6,
  "pricedInProbability": 0.34
}

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

POST/silenceanalyst

Detects absence-as-signal patterns across monitored institutions. Delayed ECB statements, late Fed minutes, overdue BNR reports — silence often precedes significant events.

Request Body

{
  "minSilenceScore": 50
}

Response (excerpt)

{
  "activeSignals": [
    {
      "entityName": "ECB Governing Council",
      "delayDays": 3.2,
      "silenceScore": 71,
      "negativeProbability": 0.68
    }
  ],
  "totalSignals": 4
}

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

POST/contagion-pathdirector

Maps the propagation sequence of a financial shock through the network. Identifies hub nodes (priced immediately) vs peripheral nodes (priced 4-8 weeks later) — the topology arbitrage opportunity.

Request Body

{
  "originEntity": "Evergrande",
  "sector": "real estate",
  "region": "APAC",
  "shockMagnitude": 0.7
}

Response (excerpt)

{
  "propagationSequence": [
    {
      "entity": "Chinese banks",
      "lag": "0-2 days",
      "arbitrageOpportunity": false
    },
    {
      "entity": "European property funds",
      "lag": "4-6 weeks",
      "arbitrageOpportunity": true
    }
  ],
  "topArbitrageTarget": "European property funds"
}

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

GET/intel-feed-publicanalyst

Public endpoint returning the last 10 daily intelligence briefs generated by the Phantom Chain. No authentication required. Includes classification, threat level, public findings, and Noosphere Scores.

Response (excerpt)

{
  "success": true,
  "data": [
    {
      "headline": "...",
      "classification": "RESTRICTED",
      "threatLevel": "ELEVATED",
      "sigma": {
        "score": 67.3,
        "regime": "accumulation"
      }
    }
  ],
  "count": 10
}

Full URL: https://noosphereprime.space/api/v1/intel-feed-public

GET/crisis-clockanalyst

Returns the current global systemic risk clock reading. Minutes to midnight (0=crisis, 60=stable) computed from a weighted basket of 10 global entities using SIGMA v5.0 with regime multipliers.

Response (excerpt)

{
  "minutesToMidnight": 28,
  "secondsDisplay": "11:32",
  "globalSigma": 51.4,
  "band": "WATCH",
  "regime": "accumulation",
  "historicalComparison": "Approaching levels last seen during Rate Hike Cycle 2022"
}

Full URL: https://noosphereprime.space/api/v1/crisis-clock

POST/phantom-consensusanalyst

Measures the divergence between official institutional narrative and mathematical risk signals. PCS > 0.55 has historically preceded forced disclosure events. Formula: PCS = 0.40×NLP_divergence + 0.35×Hurst_anomaly + 0.25×Hawkes_clustering.

Request Body

{
  "query": "ECB balance sheet normalization narrative"
}

Response (excerpt)

{
  "pcs": 0.61,
  "pcsPct": 61,
  "band": "PHANTOM",
  "signal": "PCS 61: PHANTOM signal active. Significant gap between official positions and mathematical risk.",
  "components": {
    "nlpDivergence": 0.72,
    "hurstAnomaly": 0.44,
    "hawkesClustering": 0.51
  }
}

Full URL: https://noosphereprime.space/api/v1/phantom-consensus

POST/omegadirector

Systemic risk contribution transform for multi-asset portfolios. Formula: Ω(P) = [Σᵢ wᵢ·(σᵢ/100)] · (1 + λ_c) · K_τ · R_m. Returns portfolio's systemic amplification score with marginal risk contributions per position.

Request Body

{
  "positions": [
    {
      "name": "US Treasuries",
      "weight": 40,
      "sector": "sovereign-debt",
      "region": "US"
    },
    {
      "name": "EM Equities",
      "weight": 30,
      "sector": "equity",
      "region": "EM"
    },
    {
      "name": "European Banks",
      "ticker": "SX7E",
      "weight": 30,
      "sector": "banking",
      "region": "EU"
    }
  ]
}

Response (excerpt)

{
  "omega": 0.47,
  "omegaPct": 47,
  "band": "ELEVATED",
  "components": {
    "weightedSigma": 0.41,
    "contagionAmplifier": 0.08,
    "kairosKernel": 1.25
  },
  "portfolioBeta": 0.84
}

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

POST/cascadedirector

Monte Carlo cascade failure simulation across asset classes. Uses SIGMA components as seed parameters for deterministic LCG. Returns percentile distribution of cascade depth, sequential failure chain, and hedge recommendations.

Request Body

{
  "query": "European banking sector contagion from sovereign default",
  "assets": [
    "equities",
    "credit",
    "rates",
    "fx"
  ],
  "simulations": 5000,
  "timeHorizon": 60
}

Response (excerpt)

{
  "cascadeDepthPercentiles": {
    "p10": 22.4,
    "p50": 48.7,
    "p90": 81.2
  },
  "probSystemicFailure": 0.43,
  "expectedDurationDays": 34,
  "percolationStatus": "BREACHED"
}

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

POST/grangerdirector

Tests whether past values of entity X improve prediction of entity Y beyond Y's own history. VAR(p) model fitted via OLS, F-statistic tested against F(p, T-2p-1) distribution. Returns N×N causality matrix, causal leaders, followers, and dominant pairs at p<0.05.

Request Body

{
  "slugs": [
    "united-states",
    "european-union",
    "china",
    "germany",
    "italy"
  ],
  "lag": 2
}

Response (excerpt)

{
  "leaders": [
    "united-states"
  ],
  "followers": [
    "romania"
  ],
  "dominantPairs": [
    {
      "from": "united-states",
      "to": "european-union",
      "fStat": 12.4,
      "pValue": 0.0021,
      "direction": "strong"
    }
  ]
}

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

POST/tdadirector

Computes persistent homology of the financial phase-space trajectory via Vietoris-Rips filtration. H₀ (connected components) via Union-Find, H₁ (independent loops) via Z₂ boundary matrix reduction. Returns TRS (Topological Risk Score), TEWS (Topological Early Warning Signal), persistence diagram, and landscape L¹ norms. Rolling mode available. Based on Gidea & Katz (2018).

Request Body

{
  "series": [
    72.3,
    71.8,
    73.1,
    74.2,
    75,
    73.8,
    76.1,
    77.4,
    75.9,
    78.2,
    79.1,
    77.6
  ],
  "embeddingDim": 3,
  "tau": 1
}

Response (excerpt)

{
  "trs": 67.3,
  "topologicalRegime": "turbulent",
  "tews": true,
  "tewsConfidence": 0.82,
  "signal": "Phase transition imminent: topology fragmented",
  "features": {
    "h0LandscapeNorm": 0.2341,
    "h1LandscapeNorm": 0.1892,
    "topologicalEntropy": 0.743
  }
}

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

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.

ⓘ Educational research tool · We do NOT accept funds, manage money, or offer investment returns · Not affiliated with Noosphere Ventures · Open-source · CC-BY-4.0