← API Documentation
Noosphere Prime · Developer API

GraphQL Federation Subgraph

SIGMA sovereign risk scores exposed via Apollo Federation v2 subgraph spec. Works with Apollo Router, Apollo Gateway, Apollo Studio, and any standard GraphQL client. No external library required — pure HTTP.

Endpoint
POST https://noosphereprime.space/api/graphql
Auth
None (public)
Rate Limit
60 req/min
Federation
v2.0

Quick Start

curl -X POST https://noosphereprime.space/api/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"{ sigma(slug: \"turkey\") { name score regime earlyWarningSignal } }"}'

Schema Definition Language (SDL)

Federation v2 subgraph SDL. Register this service with Apollo Router using https://noosphereprime.space/api/graphql.

extend schema @link(
  url: "https://specs.apollo.dev/federation/v2.0"
  import: ["@key"]
)

type Query {
  sigma(slug: String!): SigmaScore
  allScores: [SigmaScore!]!
}

type SigmaScore @key(fields: "slug") {
  slug: String!
  name: String!
  flag: String
  region: String
  score: Float!
  regime: String!
  earlyWarningSignal: Boolean!
  hurstExponent: Float!
  r0Financial: Float!
  minskyPhase: String!
  kairosDays: Float!
  proofUrl: String!
  updatedAt: String!
}

SigmaScore Fields

FieldTypeDescription
slugString!URL-safe identifier, e.g. 'turkey', 'italy'
nameString!Country display name
flagStringEmoji flag (may be null for sectors)
regionStringCEE | EU | US | EM | APAC | Global
scoreFloat!SIGMA score 0–100 (asymptotic, never saturates)
regimeString!stable | accumulation | critical | collapse
earlyWarningSignalBoolean!True when CSD or Hawkes intensity trigger EWS
hurstExponentFloat!Hurst exponent H ∈ [0,1]. H>0.5 = persistent trend
r0FinancialFloat!Financial contagion R₀. R₀>1 = systemic spread risk
minskyPhaseString!Hedge | Speculative | Ponzi Finance | Minsky Moment
kairosDaysFloat!Remaining days in Kairos window (temporal arbitrage)
proofUrlString!Permalink to today's proof page for this entity
updatedAtString!ISO-8601 timestamp of this computation

Example Queries

Single Country Score
Fetch the SIGMA score and regime classification for a specific country.
Query
query TurkeyRisk {
  sigma(slug: "turkey") {
    name
    flag
    score
    regime
    earlyWarningSignal
    hurstExponent
    minskyPhase
    proofUrl
  }
}
Response
{
  "data": {
    "sigma": {
      "name": "Turkey",
      "flag": "🇹🇷",
      "score": 71.84,
      "regime": "critical",
      "earlyWarningSignal": true,
      "hurstExponent": 0.6312,
      "minskyPhase": "Ponzi Finance",
      "proofUrl": "https://noosphereprime.space/proof/turkey/2026-06-03"
    }
  }
}
All Countries Ranked
Fetch all 22 sovereign SIGMA scores, sorted by risk (highest first).
Query
query AllRisks {
  allScores {
    slug
    name
    flag
    score
    regime
    earlyWarningSignal
  }
}
Response
{
  "data": {
    "allScores": [
      { "slug": "japan",   "name": "Japan",   "flag": "🇯🇵", "score": 85.12, "regime": "critical",     "earlyWarningSignal": true  },
      { "slug": "turkey",  "name": "Turkey",  "flag": "🇹🇷", "score": 71.84, "regime": "critical",     "earlyWarningSignal": true  },
      { "slug": "romania", "name": "Romania", "flag": "🇷🇴", "score": 68.40, "regime": "accumulation", "earlyWarningSignal": false },
      ...
    ]
  }
}
Apollo Federation SDL
Retrieve the service SDL for Apollo Gateway / Router registration.
Query
query FederationSDL {
  _service {
    sdl
  }
}
Response
{
  "data": {
    "_service": {
      "sdl": "extend schema @link(url: \"https://specs.apollo.dev/federation/v2.0\", import: [\"@key\"]) ..."
    }
  }
}
Contagion Network Metrics
Query R0 financial contagion reproduction number and Minsky phase.
Query
query ContagionMetrics {
  allScores {
    slug
    name
    r0Financial
    minskyPhase
    kairosDays
  }
}
Response
{
  "data": {
    "allScores": [
      { "slug": "japan", "name": "Japan", "r0Financial": 1.42, "minskyPhase": "Ponzi Finance",   "kairosDays": 3.2 },
      { "slug": "italy", "name": "Italy", "r0Financial": 1.28, "minskyPhase": "Speculative",      "kairosDays": 5.8 },
      ...
    ]
  }
}

Apollo Router / Gateway Integration

Register this subgraph in your Apollo supergraph configuration:

# supergraph.yaml
federation_version: =2.0.0
subgraphs:
  noosphere:
    routing_url: https://noosphereprime.space/api/graphql
    schema:
      subgraph_url: https://noosphereprime.space/api/graphql

Python Example

import requests

ENDPOINT = "https://noosphereprime.space/api/graphql"

query = """
  query TopRisks {
    allScores {
      slug name flag score regime earlyWarningSignal hurstExponent
    }
  }
"""

resp = requests.post(ENDPOINT, json={"query": query})
data = resp.json()["data"]["allScores"]

for country in data[:5]:
    ews = "  EWS" if country["earlyWarningSignal"] else ""
    print(f"{country['flag']} {country['name']}: {country['score']:.1f} [{country['regime'].upper()}]{ews}")
This GraphQL endpoint is rate-limited to 60 requests/minute per IP. For higher limits, use the authenticated REST API.GET /api/graphql — SDL preview
ⓘ Informational decision-support platform · We do NOT accept funds, manage money, or offer investment returns · Public datasets are CC BY 4.0 only where expressly marked · Platform software and private workspaces are excluded