Societal Business Think Tank
Integration Guide for Global 500 & Institutions Societal Business Think Tank
Integrationsleitfaden für Global 500 & Institutionen Societal Business Think Tank
Guida all'Integrazione per Global 500 e Istituzioni Societal Business Think Tank
Guide d'Intégration pour le Global 500 et les Institutions Societal Business Think Tank
Guía de Integración para Global 500 e Instituciones Societal Business Think Tank
面向全球500强和机构的集成指南 Societal Business Think Tank
Global 500と機関向け統合ガイド

OverviewÜberblickPanoramicaVue d'EnsembleResumen概述概要

Endpoint ReferenceEndpunkt-ReferenzRiferimento EndpointRéférence des EndpointsReferencia de Endpoints端点参考エンドポイントリファレンス

1. Integrity Manifest (JSON)

GET https://societal.business/api/v1/meta/integrity-manifest.json

Returns the complete manifest with 5 asset managers (live Yahoo Finance data), 8 externalities, system DR, 3 indices (EHI/HRI/IRI), Flynn parameters, hedging signals, and currency pair metrics.Gibt das vollständige Manifest mit 5 Asset Managern (Live Yahoo Finance Daten), 8 Externalitäten, System-DR, 3 Indizes (EHI/HRI/IRI), Flynn-Parametern, Hedging-Signalen und Währungspaar-Metriken zurück.Restituisce il manifest completo con 5 asset manager (dati live Yahoo Finance), 8 esternalità, DR di sistema, 3 indici.Retourne le manifeste complet avec 5 gestionnaires (données live Yahoo Finance), 8 externalités, DR système, 3 indices.Retorna el manifiesto completo con 5 gestores (datos live Yahoo Finance), 8 externalidades, DR del sistema, 3 índices.返回完整清单：5大资管(雅虎财经实时)、8外部性、系统DR、3指数。完全なマニフェストを返す：5資産運用(Yahoo Financeライブ)、8外部性、システムDR、3指数。

2. Integrity Manifest (PHP — with signature headers)

GET https://societal.business/api/v1/meta/integrity-manifest.php

Same JSON body + cryptographic signature headers:Gleicher JSON-Body + kryptographische Signatur-Header:

3. Dialysis Feed

GET https://societal.business/api/feeds/dialysis.php?pair=USD/EUR
GET https://societal.business/api/feeds/dialysis.php?pair=USD/JPY

Returns dialysis metrics, thresholds, hedging recommendation, and integrity status for the given currency pair.Gibt Dialysis-Metriken, Schwellenwerte, Hedging-Empfehlung und Integritätsstatus für das Währungspaar zurück.

4. Externalities + Asset Managers Feed

GET https://societal.business/api/feeds/externalities.php

Returns all 8 externalities (burdens), 5 asset managers (BLK, STT, JPM, GS, MS) with individual DR, system DR, 3 indices (EHI, HRI, IRI), Flynn parameters, and hedging recommendation. Live data from Yahoo Finance.Gibt alle 8 Externalitäten (Lasten), 5 Asset Manager (BLK, STT, JPM, GS, MS) mit individuellem DR, System-DR, 3 Indizes (EHI, HRI, IRI), Flynn-Parameter und Hedging-Empfehlung zurück. Live-Daten von Yahoo Finance.

5. Portfolio Analysis (POST)

POST https://societal.business/api/v1/flynn/analyze.php
Content-Type: application/json

{
  "positions": [
    {"ticker": "AAPL", "shares": 100, "avg_price": 185.50, "sector": "Technology"},
    {"ticker": "XOM",  "shares": 200, "avg_price": 105.20, "sector": "Energy"}
  ],
  "parameters": {"gamma": 1.0, "dr0": 0.05, "beta": 0.15}
}

Sends portfolio positions for server-side Flynn analysis. Returns ToxScore per position, BUY/HOLD/REDUCE/SELL signals, externality costs, Flynn-adjusted values, and portfolio uplift. Optional parameters override defaults (gamma, dr0, beta, ehi0, hri0, iri0, qb_share). Compatible with Aladdin CSV/JSON export via flynn-api.js.Sendet Portfolio-Positionen zur serverseitigen Flynn-Analyse. Gibt ToxScore pro Position, BUY/HOLD/REDUCE/SELL-Signale, Externalitätskosten, Flynn-adjustierte Werte und Portfolio-Uplift zurück. Optionale parameters überschreiben Standardwerte (gamma, dr0, beta, ehi0, hri0, iri0, qb_share). Kompatibel mit Aladdin CSV/JSON-Export über flynn-api.js.Invia posizioni di portafoglio per analisi Flynn server-side. Restituisce ToxScore, segnali, costi esternalità e uplift. Compatibile con export Aladdin CSV/JSON.Envoie les positions du portefeuille pour une analyse Flynn côté serveur. Retourne ToxScore, signaux, coûts d'externalités et uplift. Compatible export Aladdin CSV/JSON.Envía posiciones del portafolio para análisis Flynn en servidor. Retorna ToxScore, señales, costes de externalidades y uplift. Compatible con exportación Aladdin CSV/JSON.发送投资组合头寸进行服务器端Flynn分析。返回每个头寸的ToxScore、买入/持有/减仓/卖出信号、外部性成本和投资组合提升。兼容Aladdin CSV/JSON导出。ポートフォリオポジションをサーバーサイドFlynn分析に送信。各ポジションのToxScore、BUY/HOLD/REDUCE/SELLシグナル、外部性コスト、ポートフォリオアップリフトを返す。Aladdin CSV/JSONエクスポートと互換。

6. Flynn Widget (Embeddable)

GET https://societal.business/api/v1/flynn-widget.js

A self-contained JavaScript widget for embedding Flynn live data into any website. Include the script and add a <div id="flynn-widget" data-tickers="BLK,STT,JPM,GS,MS"></div> element. The widget auto-renders DR, indices, and hedging signals.Ein eigenständiges JavaScript-Widget zum Einbetten von Flynn-Live-Daten in jede Website. Script einbinden und <div id="flynn-widget" data-tickers="BLK,STT,JPM,GS,MS"></div> hinzufügen. Das Widget rendert automatisch DR, Indizes und Hedging-Signale.Widget JavaScript autonomo per incorporare dati Flynn live in qualsiasi sito. Includi lo script e aggiungi un elemento <div id="flynn-widget">.Widget JavaScript autonome pour intégrer les données Flynn en direct. Inclure le script et ajouter un <div id="flynn-widget">.Widget JavaScript autónomo para incrustar datos Flynn en vivo. Incluir el script y agregar un <div id="flynn-widget">.独立JavaScript小组件，可嵌入任何网站的Flynn实时数据。引入脚本并添加<div id="flynn-widget">元素。Flynnライブデータを任意のWebサイトに埋め込むための自己完結型JavaScriptウィジェット。スクリプトを含め、<div id="flynn-widget">要素を追加。

Code ExamplesCode-BeispieleEsempi di CodiceExemples de CodeEjemplos de Código代码示例コード例

// JavaScript — Browser or Node.js
const BASE = 'https://societal.business/api';

// 1. Get full manifest
const manifest = await fetch(BASE + '/v1/meta/integrity-manifest.json')
 .then(r => r.json());
console.log('Version:', manifest.version);
console.log('IRI:', manifest.integrity_status.iri_label);

// 2. Get USD/EUR dialysis
const eur = await fetch(BASE + '/feeds/dialysis.php?pair=USD/EUR')
 .then(r => r.json());
if (eur.dialysis_metrics.dr_current < 0.50) {
  console.warn('⚠ DR below threshold!', eur.hedging_recommendation);
}

// 3. Verify signature (PHP endpoint)
const res = await fetch(BASE + '/v1/meta/integrity-manifest.php');
const sig = res.headers.get('x-prompt-signature');
const body = await res.text();
const hash = await crypto.subtle.digest('SHA-256',
  new TextEncoder().encode(body));
const hex = [...new Uint8Array(hash)]
  .map(b => b.toString(16).padStart(2,'0')).join('');
console.log(hex === sig ? '✓ VERIFIED' : '✗ MISMATCH');

Decision LogicEntscheidungslogik

// Decision tree
function decide(dr) {
  if (dr >= 0.90) return 'SOVEREIGN — No action. Full integrity.';
  if (dr >= 0.70) return 'RESILIENT — Maintain current allocation.';
  if (dr >= 0.50) return 'NEUTRAL — Monitor. Consider light hedge.';
  if (dr >= 0.30) return 'VULNERABLE — Activate hedging. Follow API recommendation.';
  return 'CRITICAL — Emergency. Maximum hedge. Alert risk committee.';
}

ResourcesRessourcen