API publique

// endpoints

Les points d'accès publics, sans clé ni authentification. Agent Surface 1.10 est le contrat de lecture pour agents ; les endpoints de risque restent des snapshots spécialisés.

// exemple

curl -s https://l0g.fr/agents.json

curl -s https://l0g.fr/api/v1/risk.json

curl -s https://l0g.fr/api/v1/debt-risk.json

curl -s https://l0g.fr/api/v1/signals/history.ndjson | head

{
  "version": "1",
  "generated": "2026-06-18T08:00:00Z",
  "snapshot": "2026-06-16T08:16:13Z",
  "indices": {
    "us":      { "value": 58, "scale": 100, "level": "Élevé",  "tone": "elevated", "label": "US Macro Dashboard", "source": "https://us.l0g.fr" },
    "eu":      { "value": 47, "scale": 100, "level": "Modéré", "tone": "moderate", "label": "EU Macro Dashboard", "source": "https://euro.l0g.fr" },
    "yen":     { "value": 41, "scale": 100, "level": "Modéré", "tone": "moderate", "label": "Yen Carry Monitor",  "source": "https://yct.l0g.fr" },
    "energie": { "value": 58, "scale": 100, "level": "Tendu",  "tone": "elevated", "label": "Energie Monitor",    "source": "https://energie.l0g.fr" }
  },
  "scaleCaveat": { "title": "Normalisation d’affichage, pas indice unique" },
  "precisionGuard": { "title": "Illusion de précision" },
  "confluence": { "updated": "...", "count": 15, "conviction": 1, "top": { "ticker": "TSM", "score": 90, "quadrant": "divergent" } },
  "license": "CC BY 4.0", "attribution": "l0g.fr"
}

// historique & backtest

L'historique signals/history est point-in-time : chaque observation conserve observedAt, sourcePublishedAt, retrievedAt, computedAt et snapshotHash. Vous backtestez sur ce qui était réellement publié ou collecté à l'instant T, sans look-ahead bias.

import pandas as pd
df = pd.read_csv("https://l0g.fr/api/v1/signals/history.csv", parse_dates=["observedAt", "retrievedAt"])
df = df.set_index("observedAt").sort_index()

Le backtest doit utiliser observedAt pour la date du signal et retrievedAt pour vérifier quand l0g l'a collecté. Les lignes observation sont backtestables ; les événements level-change servent à l'audit et aux alertes, pas au calcul de performance.

// champs

• Agent Surface 1.10 : contrat M2M, avec /agents.json pour la découverte, /openapi.json pour le schéma et /api/v1/integrity.json pour vérifier les snapshots.
• indices.<clé>.value — valeur du signal (0 à scale, généralement 100), normalisée par instrument.
• /api/v1/debt-risk.json — source canonique du signal Dette US : signal.value est l'arrondi de provenance.scoreRaw, lui-même repris de https://debt.l0g.fr/latest.json. Le stress courant exclut les projections CBO et stabilise les familles manquantes par imputation neutre ; quand disponible, provenance.coverage indique la couverture observée avant imputation.
• /api/v1/signals/history.json : surface complète pour replay, avec coverage, policy, current, observations et levelChanges.
• signals/history.ndjson : même contrat en flux, avec recordType=meta, recordType=observation, puis recordType=level-change.
• scaleCaveat et precisionGuard — limites de lecture : normalisation d’affichage, couverture, fraîcheur, incertitude et reproductibilité.
• level — libellé lisible (Détendu, Modéré, Élevé/Tendu, Crise).
• tone — code machine : calm, moderate, elevated, crisis.
• snapshot — horodatage (ISO 8601 UTC) des données ; generated — date de génération du fichier.
• confluence — synthèse 13FLOW : nombre de titres, quadrant conviction, meilleur score.

Pas d'« indice global » : on n'expose que les sous-signaux réellement mesurés par chaque outil. Agréger les signaux en un seul chiffre serait un nombre dérivé non mesuré — on ne le fait pas.

// notes

• CORS : Access-Control-Allow-Origin: * — consommable depuis n'importe quel domaine.
• Cadence : régénéré à chaque snapshot des outils. Ce n'est pas du temps réel strict ; fiez-vous au champ snapshot.
• Versionnement : la forme de /v1/ reste stable ; toute rupture passera par /v2/.
• Licence : CC BY 4.0. Réutilisation libre avec attribution à l0g.fr.