noosphere-sdk

Sovereign risk intelligence for Python — powered by the Noosphere Prime SIGMA Engine.

pip install noosphere-sdk

Quickstart

from noosphere import NoosphereClient

client = NoosphereClient()  # free public API, no key required

# Single country score
score = client.sigma("turkey")
print(score)
# 🇹🇷 Turkey | SIGMA 71.2/100 [CRITICAL] ⚠ EWS

# Deep regime analysis
analysis = client.regime("argentina")
print(f"Collapse probability: {analysis.collapse_probability:.1%}")
print(f"Minsky phase: {analysis.minsky_phase}")
print(f"Hurst exponent: {analysis.hurst_exponent:.4f}")

# Compare multiple entities
results = client.compare(["turkey", "argentina", "italy", "france"])
print(results.summary())
# Risk Ranking (highest → lowest):
#   1. Turkey — 71.2 [CRITICAL] ⚠
#   2. Argentina — 68.4 [STRESS]
#   3. Italy — 52.1 [WARNING]
#   4. France — 47.3 [STABLE]

# List all available entities
entities = client.list_entities()
print([e.slug for e in entities])

Async support

import asyncio
from noosphere import AsyncNoosphereClient

async def main():
    async with AsyncNoosphereClient() as client:
        turkey, argentina = await asyncio.gather(
            client.sigma("turkey"),
            client.sigma("argentina"),
        )
        print(turkey, argentina)

asyncio.run(main())

Authenticated access (higher rate limits)

client = NoosphereClient(api_key="your-api-key")

Get an API key at noosphereprime.space.

Available entities

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

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

Sectors include: 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).