noosphere-sdk

Sovereign risk intelligence for JavaScript & TypeScript — powered by the Noosphere Prime SIGMA Engine.

Works in Node.js, Deno, Bun, and any modern browser or edge runtime (no dependencies, uses native fetch).

npm install noosphere-sdk
# or
pnpm add noosphere-sdk
# or
bun add noosphere-sdk

Quickstart

import { NoosphereClient } from 'noosphere-sdk';

const client = new NoosphereClient();  // free public API, no key required

// Single country score
const score = await client.sigma('turkey');
console.log(score.sigma.score);   // 71.2
console.log(score.sigma.regime);  // "stress"
console.log(score.riskLevel);     // "HIGH"

// Deep regime analysis
const analysis = await client.regime('argentina');
console.log(analysis.regime_probabilities.collapse);  // 0.183
console.log(analysis.physics.minsky_moment);          // "PONZI"
console.log(analysis.prediction.hurst_exponent);      // 0.712

// Compare multiple entities, ranked by risk
const comparison = await client.compare(['turkey', 'argentina', 'italy', 'france']);
console.log(comparison.ranked_by_risk);
// [
//   { slug: 'turkey',    sigma_score: 71.2, regime: 'stress',  risk_level: 'HIGH' },
//   { slug: 'argentina', sigma_score: 68.4, regime: 'stress',  risk_level: 'HIGH' },
//   { slug: 'italy',     sigma_score: 52.1, regime: 'warning', risk_level: 'ELEVATED' },
//   { slug: 'france',    sigma_score: 47.3, regime: 'stable',  risk_level: 'MODERATE' },
// ]

// Top 5 highest-risk countries right now
const top5 = await client.topRisks(5);
top5.forEach(s => console.log(`${s.flag} ${s.name}: ${s.sigma.score}`));

// Batch fetch multiple scores in parallel
const scores = await client.batch(['turkey', 'ukraine', 'argentina']);

Authenticated access

const client = new NoosphereClient({ apiKey: 'nsp_live_your_key' });

Get an API key at noosphereprime.space.

React / Next.js example

// app/risk-dashboard/page.tsx
import { NoosphereClient } from 'noosphere-sdk';

const client = new NoosphereClient();

export default async function RiskDashboard() {
  const [turkey, italy, argentina] = await client.batch(['turkey', 'italy', 'argentina']);

  return (
    <div>
      {[turkey, italy, argentina].map(s => (
        <div key={s.slug}>
          {s.flag} {s.name} — SIGMA {s.sigma.score.toFixed(1)} [{s.sigma.regime.toUpperCase()}]
          {s.sigma.earlyWarningSignal && ' ⚠ EWS ACTIVE'}
        </div>
      ))}
      <p>Data by <a href="https://noosphereprime.space">Noosphere Prime</a></p>
    </div>
  );
}

Available entities

Call client.listEntities() or visit the public API.

Countries: turkey, argentina, ukraine, italy, france, germany, united-states, european-union, romania, hungary, poland, and more.

Sectors: banking, sovereign-debt, real-estate, energy, technology, emerging-markets.

Attribution

Required: include a link to noosphereprime.space when displaying scores publicly (CC-BY-4.0).