Developer reference
API documentation
A REST API with JSON request and response bodies. Every endpoint requires 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.
Endpoints
POST/analyzeCore Analysisanalyst
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/regimeMacro Regime Detectionanalyst
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/pulseLive Market 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-advancedAdvanced Sentimentanalyst
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/causalCausal Chain Engineanalyst
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/contagionContagion Networkanalyst
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-riskPortfolio 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-regimeMacro Regime Deep Diveanalyst
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/valuationValuation Intelligenceanalyst
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/screenSignal Screeneranalyst
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-scoreFraud Triangle Scannerdirector
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-alertsEDGAR 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-stressShadow Banking 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-deepESG Deep Analysisdirector
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-intelligenceEarnings 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-intelligenceM&A 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-testScenario 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/counterfactualCounterfactual Analysisdirector
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-dataAlternative Data Synthesissovereign
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/metabolicEconomic Metabolic Ratesovereign
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/nexusGlobal Nexus Enginesovereign
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/healthHealth Checkanalyst
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/kairosKairos Window Calculatoranalyst
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/silenceSilence Scanneranalyst
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-pathContagion Path Sequencerdirector
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-publicPublic Intelligence Feedanalyst
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-clockGlobal 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-consensusPhantom Consensus Scoreanalyst
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/omegaOmega Function Ω(P)director
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/cascadeCascade Failure Simulationdirector
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/grangerGranger Causality Matrixdirector
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/tdaTopological Data Analysis (Persistent Homology)director
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 a higher tier.