{"openapi":"3.1.0","info":{"title":"Noosphere Prime API","version":"1.0.0","description":"Sovereign risk intelligence powered by the SIGMA Engine v5.0. Real-time risk scores, regime analysis, early warning signals, and Markov transition probabilities for 22 countries and 6 sectors. Free public endpoints require no authentication. Pro endpoints require an API key.","contact":{"name":"Noosphere Prime","url":"https://noosphereprime.space","email":"api@noosphereprime.space"},"license":{"name":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"x-logo":{"url":"https://noosphereprime.space/icon.png"}},"externalDocs":{"description":"Full documentation","url":"https://noosphereprime.space/docs"},"servers":[{"url":"https://noosphereprime.space","description":"Production"}],"security":[],"tags":[{"name":"Public","description":"Free endpoints — no API key required"},{"name":"SIGMA","description":"Core risk scoring endpoints"},{"name":"Intelligence","description":"Advanced analysis: regime, contagion, portfolio"},{"name":"MCP","description":"Model Context Protocol — AI agent integration"}],"paths":{"/api/public/sigma":{"get":{"tags":["Public"],"summary":"List all entities","description":"Returns all available countries and sectors with their slugs and API endpoints.","operationId":"listEntities","responses":{"200":{"description":"List of all monitored entities","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntitiesListResponse"},"example":{"name":"Noosphere Prime Public SIGMA API","version":"1.0","totalEntities":28,"countries":[{"slug":"turkey","name":"Turkey","flag":"🇹🇷","region":"EM","endpoint":"https://noosphereprime.space/api/public/sigma/turkey"}],"sectors":[{"slug":"banking","name":"Banking","endpoint":"https://noosphereprime.space/api/public/sigma/banking"}]}}}}}}},"/api/public/sigma/{slug}":{"get":{"tags":["Public","SIGMA"],"summary":"Get Noosphere Score","description":"Get real-time SIGMA sovereign risk score for a country or sector. Returns score (0-100), regime, early warning signal, Kairos window, and risk level. No authentication required. Rate limit: 60 req/min.","operationId":"getSigmaScore","parameters":[{"name":"slug","in":"path","required":true,"description":"Entity slug (e.g. \"turkey\", \"germany\", \"banking\")","schema":{"type":"string","example":"turkey","enum":["romania","italy","european-union","united-states","germany","france","greece","spain","hungary","poland","czechia","bulgaria","austria","serbia","ukraine","turkey","china","japan","netherlands","portugal","switzerland","india","banking","sovereign-debt","real-estate","technology","energy","emerging-markets"]}}],"responses":{"200":{"description":"Noosphere Score and risk analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SigmaResponse"},"example":{"slug":"turkey","type":"country","name":"Turkey","flag":"🇹🇷","region":"EM","sigma":{"score":85.63,"regime":"collapse","earlyWarningSignal":true},"kairos":{"remainingDays":35,"urgency":"LOW"},"riskLevel":"CRITICAL","updatedAt":"2026-06-01"}}}},"404":{"description":"Entity not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/mcp":{"get":{"tags":["MCP"],"summary":"MCP server info","description":"Returns MCP server info and quickstart config for Claude Desktop and Claude Code.","operationId":"getMcpInfo","responses":{"200":{"description":"MCP server info and tools list"}}},"post":{"tags":["MCP"],"summary":"MCP JSON-RPC endpoint","description":"Model Context Protocol (2024-11-05) endpoint. Connect Claude and other AI agents to Noosphere. Supports: initialize, tools/list, tools/call. Tools: get_sigma_score, list_entities, compare_entities, get_regime_analysis.","operationId":"mcpRpc","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"},"examples":{"getSigma":{"summary":"Get Noosphere Score","value":{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_sigma_score","arguments":{"slug":"turkey"}},"id":1}},"listTools":{"summary":"List available tools","value":{"jsonrpc":"2.0","method":"tools/list","params":{},"id":1}}}}}},"responses":{"200":{"description":"JSON-RPC response"}}}},"/api/v1/analyze":{"post":{"tags":["Intelligence"],"summary":"Full AI analysis","description":"Full SIGMA analysis with Claude AI narrative, risk factors, and regime assessment.","operationId":"analyze","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","example":"Turkey sovereign debt risk 2026"}},"required":["query"]}}}},"responses":{"200":{"description":"Analysis result with Noosphere Score and AI narrative"},"401":{"description":"Unauthorized"}}}},"/api/v1/regime":{"post":{"tags":["Intelligence"],"summary":"Regime classification","description":"Classify market/entity regime using Markov chain analysis.","operationId":"regime","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Regime classification result"},"401":{"description":"Unauthorized"}}}},"/api/v1/granger":{"post":{"tags":["Intelligence"],"summary":"Granger causality matrix","description":"Tests whether entity X Granger-causes entity Y. Returns N×N causality matrix. Requires Director tier.","operationId":"grangerCausality","security":[{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"slugs":{"type":"array","items":{"type":"string"},"example":["turkey","italy","france"],"minItems":2,"maxItems":20},"lag":{"type":"integer","minimum":1,"maximum":5,"default":2}}}}}},"responses":{"200":{"description":"Granger causality matrix"},"401":{"description":"Unauthorized"},"403":{"description":"Director tier required"}}}},"/api/v1/tda":{"post":{"tags":["Intelligence"],"summary":"Topological Data Analysis","description":"Persistent homology analysis of time series. Detects regime transitions before price/volatility signals.","operationId":"tda","security":[{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["series"],"properties":{"series":{"type":"array","items":{"type":"number"},"minItems":10,"maxItems":500},"embeddingDim":{"type":"integer","minimum":2,"maximum":6,"default":3},"tau":{"type":"integer","minimum":1,"maximum":10,"default":1},"rolling":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"TDA result with persistence diagram and TEWS signal"},"401":{"description":"Unauthorized"}}}},"/api/v1/contagion":{"post":{"tags":["Intelligence"],"summary":"Contagion analysis","description":"Network contagion spread simulation. Brandes betweenness centrality, percolation threshold, R0 financial.","operationId":"contagion","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Contagion network result"},"401":{"description":"Unauthorized"}}}},"/noosphere.js":{"get":{"tags":["Public"],"summary":"Page annotator script","description":"Self-contained JavaScript that annotates any webpage with live Noosphere Risk Scores. Add to any site: <script src=\"https://noosphereprime.space/noosphere.js\"></script>. Modes: annotate (default, hover tooltips on country names), widget (floating badge), both.","operationId":"getAnnotatorScript","parameters":[{"name":"data-mode","in":"query","schema":{"type":"string","enum":["annotate","widget","both"]}},{"name":"data-countries","in":"query","description":"Comma-separated slugs for widget mode","schema":{"type":"string","example":"turkey,germany,france"}}],"responses":{"200":{"description":"JavaScript annotator","content":{"application/javascript":{"schema":{"type":"string"}}}}}}},"/api/badge/{slug}":{"get":{"tags":["Public"],"summary":"SVG badge","description":"GitHub-compatible SVG badge. Use in README: ![Turkey Risk](https://noosphereprime.space/api/badge/turkey)","operationId":"getBadge","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","example":"turkey"}}],"responses":{"200":{"description":"SVG badge","content":{"image/svg+xml":{"schema":{"type":"string"}}}}}}},"/api/widget/sigma.js":{"get":{"tags":["Public"],"summary":"Embeddable widget SVG","description":"Responsive SVG widget for embedding on any website.","operationId":"getWidget","parameters":[{"name":"slug","in":"query","schema":{"type":"string","example":"turkey"}},{"name":"theme","in":"query","schema":{"type":"string","enum":["dark","light"],"default":"dark"}},{"name":"compact","in":"query","schema":{"type":"string","enum":["0","1"],"default":"0"}}],"responses":{"200":{"description":"SVG widget","content":{"image/svg+xml":{"schema":{"type":"string"}}}}}}},"/api/rss":{"get":{"tags":["Public"],"summary":"Atom/RSS feed","description":"Atom feed of SIGMA alerts and intelligence reports.","operationId":"getRssFeed","responses":{"200":{"description":"Atom XML feed","content":{"application/atom+xml":{"schema":{"type":"string"}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-noosphere-key","description":"API key from noosphereprime.space/api-keys. Format: nsp_live_..."},"BearerAuth":{"type":"http","scheme":"bearer","description":"Bearer token: Authorization: Bearer nsp_live_..."}},"schemas":{"SigmaResponse":{"type":"object","properties":{"slug":{"type":"string"},"type":{"type":"string","enum":["country","sector"]},"name":{"type":"string"},"flag":{"type":"string"},"region":{"type":"string"},"sigma":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":100,"description":"Noosphere Risk Score"},"regime":{"type":"string","enum":["robust","stable","warning","stress","crisis","collapse"]},"earlyWarningSignal":{"type":"boolean"}}},"kairos":{"type":"object","properties":{"remainingDays":{"type":"number"},"urgency":{"type":"string","enum":["LOW","MEDIUM","HIGH","CRITICAL"]}}},"riskLevel":{"type":"string","enum":["LOW","MODERATE","ELEVATED","HIGH","CRITICAL"]},"updatedAt":{"type":"string","format":"date"}}},"EntitiesListResponse":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"engine":{"type":"string"},"totalEntities":{"type":"integer"},"countries":{"type":"array","items":{"type":"object"}},"sectors":{"type":"array","items":{"type":"object"}}}},"JsonRpcRequest":{"type":"object","required":["jsonrpc","method","id"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"method":{"type":"string","enum":["initialize","tools/list","tools/call"]},"params":{"type":"object"},"id":{"oneOf":[{"type":"integer"},{"type":"string"}]}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}