Noosphere API v1 — Sovereign Intelligence

⚡ Development key: x-noosphere-key: dev-test-key — Sovereign tier access, unlimited calls.

QUICK START — 5 MINUTES

Get your API key from noosphere.io/dashboard or use dev-test-key for testing

All requests require header: x-noosphere-key: YOUR_KEY

Test with pulse: curl https://your-domain/api/v1/pulse -H "x-noosphere-key: dev-test-key"

Run full analysis: POST to /api/v1/analyze with {"query": "Fed rate policy 2024", "includeExecutive": true}

All responses follow: {"success": true, "data": {...}, "meta": {"timestamp","version","sigmaVersion","processingMs","tier"}}

ENDPOINTS — ANALYST TIER

GET /api/v1/pulse ANALYST Live global market data — SPX, VIX, EUR/USD, BTC, Gold, Oil, DAX, Nikkei

Live global market data — SPX, VIX, EUR/USD, BTC, Gold, Oil, DAX, Nikkei

RESPONSE DATA:

{"markets":{"spx":{"price":5800,"change":12.3,"changePct":0.21},"vix":{"value":14.2,"regime":"low"},"btc":{"price":98000}},"sentiment":{"fearGreed":68,"classification":"greed"},"systemicStress":28.4,"sigmaAlert":{"active":false,"level":"normal","message":"ΣIGMA 28.4 — system nominal"}}

POST /api/v1/analyze ANALYST Core SIGMA analysis — 8-layer mathematical engine + live data

Core SIGMA analysis — 8-layer mathematical engine + live data

REQUEST BODY:

{"query":"European banking sector Q4 2024","asset":"EUFN","sector":"banking","includeExecutive":true}

RESPONSE DATA:

{"sigmaScore":42.7,"regime":"accumulation","regimeProbabilities":{"stable":0.35,"accumulation":0.42,"critical":0.18,"collapse":0.05},"metabolic":{"beta":1.124,"biologicalAge":84},"prediction":{"csdScore":38.2,"hurstExponent":0.574,"earlyWarningSignal":false},"arbitrageWindowDays":23}

POST /api/v1/regime ANALYST Regime prediction with transition probabilities — 7/30/90 day horizons

Regime prediction with transition probabilities — 7/30/90 day horizons

REQUEST BODY:

{"query":"US equity market post-election","horizon":90}

RESPONSE DATA:

{"currentRegime":"accumulation","transitionProbabilities":{"next7days":{"stable":0.6,"critical":0.12},"next30days":{"stable":0.4,"critical":0.28}},"triggerConditions":[{"condition":"VIX > 28","probability":0.23,"impact":"transition to critical"}],"earlyWarning":false,"estimatedDaysToTransition":34}

POST /api/v1/metabolic ANALYST Biological age + metabolic efficiency analysis

Biological age + metabolic efficiency analysis

REQUEST BODY:

{"entityName":"Deutsche Bank","outputs":[28000,26500,27800,25900,28200],"inputs":[450000,460000,455000,448000,452000],"ageYears":154,"sector":"banking"}

RESPONSE DATA:

{"metabolicBeta":1.089,"biologicalAge":172,"immuneResponseIndex":0.634,"metabolicStatus":"hypermetabolic","sustainabilityScore":64,"estimatedResetMonths":18}

POST /api/v1/causal ANALYST NLP causal chain extraction + hidden stress detection

NLP causal chain extraction + hidden stress detection

REQUEST BODY:

{"texts":["Management remains confident in our capital position despite challenging conditions","We have taken appropriate measures to address liquidity concerns"]}

RESPONSE DATA:

{"causalChains":[{"cause":"challenging conditions","effect":"capital position stress","confidence":0.82}],"hedgingScore":0.143,"hiddenStress":{"detected":true,"severity":"medium"},"silenceSigma":3.2}

POST /api/v1/nexus ANALYST Global weak signal detection — all regions, all sectors

Global weak signal detection — all regions, all sectors

REQUEST BODY:

{"query":"emerging market stress 2025","regions":["APAC","LatAm","Africa"],"sectors":["banking","sovereign debt"]}

RESPONSE DATA:

{"activeNodes":[{"location":"Vietnam","signal":"Foreign reserves declining 12% YoY","type":"financial","intensity":67,"lagDays":45}],"R0Network":1.24,"earlyWarning":true,"topInsight":"Vietnam FX reserve drawdown precedes regional currency stress by 6-8 weeks"}

GET /api/v1/health ANALYST System health, uptime, engine status

System health, uptime, engine status

RESPONSE DATA:

{"status":"operational","uptimeSeconds":86400,"version":"1.0","sigmaVersion":"5.0","layers":["metabolic","fragility","psychology","network","nlp","prediction","learning","technical"]}

POST /api/v1/backtest ANALYST Validate SIGMA on historical crises — GFC 2008, COVID 2020, Crypto 2022, Dotcom 2000

Validate SIGMA on historical crises — GFC 2008, COVID 2020, Crypto 2022, Dotcom 2000

REQUEST BODY:

{"crisis":"GFC_2008"}

RESPONSE DATA:

{"crisisName":"GFC_2008","sigmaAccumulationAlertDate":"2008-01","sigmaCriticalAlertDate":"2008-07","actualCrisisDate":"2008-09-15","leadTimeDaysCritical":76,"validationResult":"early_warning_confirmed","maxSigmaReached":82.4}

POST /api/v1/monitor ANALYST Create SIGMA threshold alert — webhook or email

Create SIGMA threshold alert — webhook or email

REQUEST BODY:

{"query":"global banking sector","sigmaThreshold":55,"checkInterval":"6h","webhookUrl":"https://your-webhook.com/alerts"}

RESPONSE DATA:

{"monitorId":"mon_abc123","status":"active","message":"Monitor created. SIGMA alert fires when score > 55","checkInterval":"6h","webhookConfigured":true}

ENDPOINTS — DIRECTOR TIER

POST /api/v1/counterfactual DIRECTOR What-if causal analysis — first API of its kind globally

What-if causal analysis — first API of its kind globally

EXAMPLE REQUEST:

{"scenario":"What if Fed had not cut rates in Sept 2019?","baselineDate":"2019-07-01","changedVariable":"Fed Funds Rate","changedValue":"maintained at 2.5%"}

POST /api/v1/contagion DIRECTOR R0-based systemic failure propagation simulation

R0-based systemic failure propagation simulation

EXAMPLE REQUEST:

{"failingEntity":"Silicon Valley Bank","sector":"regional banking","networkSize":50,"shockMagnitude":0.7}

POST /api/v1/valuation DIRECTOR DCF + SIGMA metabolic adjustment — Bloomberg-beating valuation

DCF + SIGMA metabolic adjustment — Bloomberg-beating valuation

EXAMPLE REQUEST:

{"entityName":"Volkswagen AG","revenue":[293000,279000,288000,293000,322000],"ebitda":[25000,17000,20000,23000,28000],"capex":[15000,14000,16000,17000,19000],"debtRatio":0.72,"wacc":0.09,"growthRate":0.03,"sector":"automotive"}

POST /api/v1/esg-deep DIRECTOR Causal ESG analysis + greenwashing detection

Causal ESG analysis + greenwashing detection

EXAMPLE REQUEST:

{"entityName":"BP plc","publicStatements":["We are committed to net zero by 2050 with interim targets..."],"sector":"energy"}

POST /api/v1/earnings-intelligence DIRECTOR Earnings call forensic NLP — decode what management hides

Earnings call forensic NLP — decode what management hides

EXAMPLE REQUEST:

{"transcript":"","sector":"banking","expectedEPS":1.42,"actualEPS":1.38}

POST /api/v1/portfolio-risk DIRECTOR VaR + SIGMA contagion matrix — superior to Bloomberg PORT

VaR + SIGMA contagion matrix — superior to Bloomberg PORT

EXAMPLE REQUEST:

{"holdings":[{"asset":"AAPL","weight":0.15,"sector":"tech","region":"US"},{"asset":"JPM","weight":0.10,"sector":"banking","region":"US"}],"portfolioValue":50000000,"timeHorizon":90}

POST /api/v1/screen DIRECTOR Metabolic screening across global equity universe

Metabolic screening across global equity universe

EXAMPLE REQUEST:

{"universe":"SP500","filters":{"maxMetabolicBeta":1.2,"maxSigma":45,"regime":["stable","accumulation"]},"rankBy":"metabolicBeta","limit":20}

POST /api/v1/sentiment-advanced DIRECTOR Causal directional sentiment — entity-level with temporal drift

Causal directional sentiment — entity-level with temporal drift

EXAMPLE REQUEST:

{"texts":["",""],"entities":["Fed","Treasury","Goldman"]}

POST /api/v1/ma-intelligence DIRECTOR M&A due diligence with hidden risk detection

M&A due diligence with hidden risk detection

EXAMPLE REQUEST:

{"targetName":"Credit Suisse","acquirerName":"UBS","targetRevenue":[22000,19000,18000],"targetEbitda":[4000,2000,1500],"targetAge":167,"dealValue":3240,"sector":"banking"}

POST /api/v1/macro-regime DIRECTOR Global macro cycle positioning — expansion/peak/contraction/trough

Global macro cycle positioning — expansion/peak/contraction/trough

EXAMPLE REQUEST:

{"region":"US","indicators":{"gdpGrowth":2.4,"inflation":2.8,"yieldCurve":-0.1,"creditSpread":1.8}}

POST /api/v1/stress-test DIRECTOR Real-time stress testing — ECB/Fed-grade, on demand

Real-time stress testing — ECB/Fed-grade, on demand

EXAMPLE REQUEST:

{"entity":"Deutsche Bank","scenarios":[{"name":"Rate hike 300bps","variables":{"rateHike":3.0}},{"name":"Recession -4% GDP","variables":{"gdpShock":-4.0}}],"sector":"banking"}

ENDPOINTS — SOVEREIGN TIER

POST /api/v1/alternative-data SOVEREIGN Process satellite, shipping, job postings, patent, dark pool signals

Process satellite, shipping, job postings, patent, dark pool signals

POST /api/v1/narrative-track SOVEREIGN Track narrative DNA evolution over time — unique globally

Track narrative DNA evolution over time — unique globally

NOOSPHERE vs COMPETITORS

Feature	Noosphere API v1	Bloomberg API	Refinitiv	Palantir
8-layer systemic Noosphere Score	✓ Unique	✗	✗	✗
Biological age / metabolic beta	✓ Unique	✗	✗	✗
Contagion R0 simulation	✓	✗	✗	Limited
Counterfactual causal analysis	✓ First globally	✗	✗	✗
Real-time stress testing API	✓ On-demand	Annual	Annual	✗
SIGMA-adjusted DCF valuation	✓	DCF only	DCF only	✗
Causal ESG + greenwashing	✓	Score only	Score only	✗
Earnings call hidden signal	✓ Forensic NLP	Basic	Basic	✗
Narrative DNA tracking	✓ Unique	✗	✗	✗
Global weak signal (nexus)	✓ All regions	✗	✗	Limited
M&A hidden risk detection	✓ SIGMA-grade	Basic	Basic	✗
Live market data (free tier)	✓	$$$$	$$$	$$$$
REST API (simple)	✓	Complex	Complex	Enterprise

RATE LIMITS & PRICING

ANALYST

100 calls / day

Endpoints 1–9 (core intelligence)
Pulse, Analyze, Regime, Metabolic
Causal NLP, Nexus, Backtest
Monitor alerts (webhook)
SIGMA Engine v5.0

DIRECTOR

1,000 calls / day

Everything in Analyst
Valuation, ESG-Deep, M&A
Earnings Intelligence
Portfolio Risk + Contagion
Macro Regime, Stress Test
Counterfactual analysis
Screen (global universe)

SOVEREIGN

Unlimited

All 22 endpoints
Alternative Data processing
Narrative DNA tracking
Priority processing
SLA guarantee
Dedicated support
Custom model training

RESPONSE FORMAT

{
  "success": true,
  "data": { // endpoint-specific payload },
  "meta": {
    "timestamp": "2025-05-24T12:00:00.000Z",
    "version": "1.0",
    "sigmaVersion": "5.0",
    "processingMs": 142,
    "tier": "sovereign",
    "dataFreshness": "2025-05-24T11:55:00.000Z"
  }
}

ERROR FORMAT

{
  "success": false,
  "error": "Invalid API key",
  "code": "AUTH_INVALID"  // AUTH_INVALID | TIER_INSUFFICIENT | VALIDATION_ERROR | PARSE_ERROR
}

RESPONSE HEADERS

X-Noosphere-Version: 1.0
X-Sigma-Version: 5.0
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1748131200
X-API-Tier: director

NOOSPHERE API v1.0 — SIGMA Engine v5.0 — 8-layer deterministic mathematical core — Powered by Claude Sonnet 4.6
Global systemic intelligence for institutional investors, sovereign funds, and strategic operators
© 2025 Noosphere Intelligence Systems